Функция _IELinkGetCollection

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


_IELinkGetCollection

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

#include <IE.au3>
_IELinkGetCollection(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:Содержит номер неверного параметра

Примечания

Не все элементы, выдающие себя за ссылки являются таковыми на самом деле.Это обычная практика для присоединения события onClick JavaScript к другим элементам DOM, чтобы имитировать поведение ссылок. Чтобы активировать такие элементы, используйте "клик" с помощью _IEAction().

Пример

#include <IE.au3>
; Пример 1 - Открывает пример страницы "basic", получает коллекцию ссылок,
;               отображает каждую ссылку коллекции в цикле

$oIE = _IE_Example("basic")
$oLinks = _IELinkGetCollection($oIE)
$iNumLinks = @extended
MsgBox(0, "Информация о ссылках", 'Найдено ' & $iNumLinks & " ссылки")
For $oLink In $oLinks
    MsgBox(0, "Информация о каждой ссылке", $oLink.href)
Next