_IETagNameGetCollection
Возвращает объект коллекции всех элементов в объекте с указанным TagName или единственный элемент по индексу.
#include <IE.au3>
_IETagNameGetCollection(ByRef $o_object, $s_TagName [, $i_index = -1])
Параметры
| $o_object | Переменная объекта InternetExplorer.Application, Window, Frame, iFrame или любой объект в DOM |
| $s_TagName |
Имя тега для возвращения его коллекции (например IMG, TR и т.д.) |
| $i_index |
[необязательный] Указывает, вернуть ли коллекцию или индексированный экземпляр 0 или положительное число возвращает индексированный экземпляр -1 = (по умолчанию) возвращает коллекцию |
Возвращаемое значение
| Успех: | Возвращает переменную объекта, содержащую указанную коллекцию тегов, @extended = количество указанных тегов |
| Ошибка: | Возвращает 0 и устанавливает @error |
| @error: | 0 ($_IEStatus_Success) = Нет ошибок |
| 3 ($_IEStatus_InvalidDataType) = Неверный тип данных | |
| 4 ($_IEStatus_InvalidObjectType) = Неверный тип объекта | |
| 5 ($_IEStatus_InvalidValue) = Неверное значение | |
| 7 ($_IEStatus_NoMatch) = Нет совпадений | |
| @extended: | Содержит номер неверного параметра |
Примечания
DOM является иерархическим, поэтому если переданный объект является объектом документа, то возвращаются указанные элементы в документе. Если же переданный объект является объектом внутри документа (например , объект таблицы), то возвращаются только указанные элементы внутри этого объекта.См. также
_IETagNameAllGetCollectionПример
#include <IE.au3>
; Пример 1 - Открывает пример страницы "form", получает коллекцию
; всех тегов INPUT и для каждого выводит formname и type
$oIE = _IE_Example("form")
$oInputs = _IETagNameGetCollection($oIE, "input")
For $oInput In $oInputs
MsgBox(0, "Form Input Type", "Form: " & $oInput.form.name & @LF & "Type: " & $oInput.type)
Next