Функция _IEFormGetCollection

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


_IEFormGetCollection

Возвращает переменную объекта коллекции, представляющую формы в документе или единственную форму по индексу.

#include <IE.au3>
_IEFormGetCollection(ByRef $o_object [, $i_index = -1])

Параметры

$o_object Переменная объекта InternetExplorer.Application, Window, Frame или iFrame object
$i_index [необязательный] Возвращать коллекцию или индексированный экземпляр
0 или положительное число возвращает индексированный экземпляр
-1 = (по умолчанию) возвращает коллекцию

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

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

См. также

_IEFormGetObjByName, _IEFormReset, _IEFormSubmit

Пример

#include <IE.au3>

; ====================================
; Пример 1 - Получает ссылку на указанную форму по индексу, отсчёт от 0.
;               в данном примере первая форма на странице

$oIE = _IECreate("http://www.google.com")
$oForm = _IEFormGetCollection($oIE, 0)
$oQuery = _IEFormElementGetCollection($oForm, 1)
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)

; ====================================
; Пример 2 - Получает ссылку на коллекцию форм на странице,
;               и далее цикл для отображения информации для каждой из них

$oIE = _IECreate("http://www.autoitscript.com")
$oForms = _IEFormGetCollection($oIE)
MsgBox(4096, "Информация форм", "Здесь " & @extended & " форм на странице")
For $oForm In $oForms
    MsgBox(4096, "Информация формы", $oForm.name)
Next

; ====================================
; Пример 3 - Получает ссылку на коллекцию форм на странице,
;               и далее цикл для отображения информации для каждой из них
;               демонстрирующего использование индекса формы

$oIE = _IECreate("http://www.autoitscript.com")
$oForms = _IEFormGetCollection($oIE)
$iNumForms = @extended
MsgBox(4096, "Информация форм", "Здесь " & $iNumForms & " форм на странице")
For $i = 0 To $iNumForms - 1
    $oForm = _IEFormGetCollection($oIE, $i)
    MsgBox(4096, "Информация формы", $oForm.name)
Next