Функция _IEGetObjByName

 ↑  ←  Описание функции


_IEGetObjByName

Возвращает переменную объекта по имени или id.

#include <IE.au3>
_IEGetObjByName(ByRef $o_object, $s_Id [, $i_index = 0])

Параметры

$o_object Переменная объекта InternetExplorer.Application, объекта Окна или Фрейма (области)
$s_Id Имя или id объекта
$i_index [необязательный] Если имя или id встречается более одного раза, определяет экземпляр по индексу, отчёт от 0.
0 - (по умолчанию) или положительное число возвращает индексированный экземпляр
-1 - возвращает коллекцию указанных объектов

Возвращаемое значение

Успех:Возвращает переменную объекта, указывающую на определённый объект, @extended = количество объектов
Ошибка:Возвращает 0 и устанавливает @error
@error:0 ($_IEStatus_Success) = Нет ошибок
3 ($_IEStatus_InvalidDataType) = Неверный тип данных
7 ($_IEStatus_NoMatch) = Нет совпадений
@extended:Содержит номер неверного параметра

Примечания

This function will return an object reference to any object in the document with a specified name or id. DOM elements can have Name or ID attributes or both. A specific ID can be assigned to only a single element while a specific Name can be assigned to multiple elements. In Internet Explorer, the Name and ID namespaces are shared.

См. также

_IEGetObjById

Пример

#include <IE.au3>

; Пример 1 - Открывает браузер с примером "form", получает ссылку на элемент
;               с именем "ExampleForm".  Результат этого примера аналогичен
;               использованию $oForm = _IEFormGetObjByName($oIE, "ExampleForm")

$oIE = _IE_Example("form")
$oForm = _IEGetObjByName($oIE, "ExampleForm")