_IEFormGetObjByName
Возвращает объект-ссылку на форму по имени.
#include <IE.au3>
_IEFormGetObjByName(ByRef $o_object, $s_name [, $i_index = 0])
Параметры
| $o_object | Переменная объекта InternetExplorer.Application, объекта Окна или Фрейма (области) |
| $s_name |
Имя формы |
| $i_index |
[необязательный] Если имя формы встречается более одного раза, определяет экземпляр по индексу, отчёт от 0. 0 - (по умолчанию) или положительное число возвращает индексированный экземпляр -1 - возвращает коллекцию указанных форм |
Возвращаемое значение
| Успех: | Возвращает объект указывающий на форму, @extended = количество форм |
| Ошибка: | Возвращает 0 и устанавливает @error |
| @error: | 0 ($_IEStatus_Success) = Нет ошибок |
| 3 ($_IEStatus_InvalidDataType) = Неверный тип данных | |
| 7 ($_IEStatus_NoMatch) = Нет совпадений | |
| @extended: | Содержит номер неверного параметра |
Примечания
Если необходимая форма не имеет имени или ID, то используйте _IEFormGetCollection, чтобы получить ссылку по индексу.См. также
_IEFormGetCollection, _IEFormReset, _IEFormSubmitПример
#include <IE.au3>
; Пример 1 - Получает ссылку на указанную формы по имени.
; в этом примере запрос в поисковой системе Google.
; Обратите внимание, что имена элементов и форм можно найти,
; просмотрев исходный код HTML-страницы
$oIE = _IECreate("http://www.google.com")
$oForm = _IEFormGetObjByName($oIE, "f")
$oQuery = _IEFormElementGetObjByName($oForm, "q")
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)