Функция _IEFrameGetCollection

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


_IEFrameGetCollection

Возвращает объект коллекции, содержащий фреймы в FrameSet или iFrames на обычной странице или единственный Frame или iFrame по индексу.

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

Параметры

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

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

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

Примечания

Although MSDN documents the return value for this function as a collection object, it cannot be looped through with a For...Next loop like a standard collection object. You must instead step through the collection by index - see example.

См. также

_IEIsFrameSet, _IEFrameGetObjByName

Пример

#include <IE.au3>

; Пример 1 - Открывает пример с "frameset", получает коллекцию фреймов
;               и цикл отображения их URL

$oIE = _IE_Example("frameset")
$oFrames = _IEFrameGetCollection($oIE)
$iNumFrames = @extended
For $i = 0 To ($iNumFrames - 1)
    $oFrame = _IEFrameGetCollection($oIE, $i)
    MsgBox(4096, "Информация о фрейме", _IEPropertyGet($oFrame, "locationurl"))
Next