指定されたタグ名のついたオブジェクト内の全ての要素のコレクションオブジェクト、またはインデックスと対応した要素を返します。
#include <IE.au3>
_IETagNameGetCollection ( ByRef $o_object, $s_TagName [, $i_index = -1] )
パラメータ
| $o_object | InternetExplorer.Applicationのオブジェクト変数、ウィンドウ、フレーム、アイフレーム、またはDOMの任意のオブジェクト |
| $s_TagName | 返されるコレクションのタグ名 (e.g. IMG、TR etc.) |
| $i_index | [オプション]コレクションを返すか、インデックスの要素を返すかを指定します 0 または正の整数の場合、そのインデックスのインスタンスを返します -1 = (デフォルト) コレクションを返します |
返し値
| 成功: | 指定されたタグのコレクションを格納したオブジェクト変数を返します。@EXTENDED = 指定されたタグの数 |
| 失敗: | 0を返し@ERRORを設定します |
| @Error: | 0 ($_IEStatus_Success) = 正常終了 |
| 3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
| 4 ($_IEStatus_InvalidObjectType) = 無効なオブジェクト型 | |
| 5 ($_IEStatus_InvalidValue) = 無効な値 | |
| 7 ($_IEStatus_NoMatch) = 一致するものがありません | |
| @Extended: | 無効なパラメータの番号が格納されています |
注意
DOMは階層になっています。従って、渡されたオブジェクトがドキュメントオブジェクトの場合、ドキュメント内の指定された要素が返されます。渡されたオブジェクトがドキュメントオブジェクト内のオブジェクト(e.g. TABLEオブジェクト)の場合、そのオブジェクト内の指定された要素のみ返されます。
関連
_IETagNameAllGetCollection
例
; *******************************************************
; 例 1 - フォームのサンプルをブラウザで開き、全てのINPUTタグのコレクションを取得。
; フォーム名とそれぞれのタイプを表示
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("form")
$oInputs = _IETagNameGetCollection ($oIE, "input")
For $oInput In $oInputs
MsgBox(0, "Form Input Type", "Form: " & $oInput.form.name & " Type: " & $oInput.type)
Next