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


_IEFormGetObjByName

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

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

Параметры

$o_object Переменная объекта InternetExplorer.Application, объекта Окна или Фрейма (области)
$s_name Имя Form
$i_index [необязательный] If Form name occurs more than once, specifies instance by 0-based index
0 - (по умолчанию) or positive integer returns an indexed instance
-1 - returns a collection of the specified Forms

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

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

Примечания

If the desired form does not have a name or ID, _IEFormGetCollection to get a reference by index

См. также

_IEFormGetCollection, _IEFormReset, _IEFormSubmit

Пример

; *******************************************************
; Пример 1 - Get a reference to a specific form by name.  In this case, submit a query
;               to the Google search engine.  Note that the names of the form and form
;               elements can be found by viewing the page HTML source
; *******************************************************

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