Функция _IEFormElementGetObjByName

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


_IEFormElementGetObjByName

Возвращает объект-ссылку на элемент формы по имени.

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

Параметры

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

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

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

Примечания

Если необходимый элемент формы не имеет имени или ID, то используйте _IEFormElementGetCollection, чтобы получить ссылку по индексу.

См. также

_IEFormElementGetCollection, _IEFormElementGetValue, _IEFormElementSetValue, _IEFormSubmit

Пример

#include <IE.au3>

; Пример 1 - Получает ссылку на указанный элемент формы по имени
;               в этом примере запрос в поисковой системе Google

$oIE = _IECreate("http://www.google.com")
$oForm = _IEFormGetObjByName($oIE, "f")
$oQuery = _IEFormElementGetObjByName($oForm, "q")
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)