名前またはIDによってオブジェクト変数を返します。
#include <IE.au3>
_IEGetObjByName ( ByRef $o_object, $s_Id [, $i_index = 0] )
パラメータ
| $o_object | InternetExplorer.Applicationのオブジェクト変数、ウィンドウまたはフレームオブジェクト |
| $s_Id | 欲しいオブジェクトの名前またはIDを指定します |
| $i_index | [オプション]ID名が複数ある場合は、0始まりのインデックスによってインスタンスを指定します 0 (デフォルト) または正の整数の場合、インデックスされているインスタンスを返します -1の場合、指定されたオブジェクトのコレクションを返します |
返し値
| 成功: | 指定したオブジェクトを指すオブジェクト変数を返します, @EXTENDED = 指定したオブジェクトの数 |
| 失敗: | 0を返し@ERRORを設定します |
| @Error: | 0 ($_IEStatus_Success) = 正常終了 |
| 3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
| 7 ($_IEStatus_NoMatch) = 一致するものがありません | |
| @Extended: | 無効なパラメータの番号が格納されています |
注意
この関数はドキュメント内の指定されたIDまたは名前のオブジェクトへのオブジェクト参照を返します。 DOMの要素はNameかID、またはその両方の属性を持つことができます。IDは要素に固有であるのに対して、Nameは複数の要素に割り当てることができます。Internet ExplorerではNameとIDの名前空間は共有されています。
関連
_IEGetObjById
例
; *******************************************************
; 例 1 - フォームのサンプルをブラウザで開き、"ExampleForm"という名前の要素への参照を取得。
; このケースでは$oForm = _IEFormGetObjByName($oIE, "ExampleForm")
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("form")
$oForm = _IEGetObjByName ($oIE, "ExampleForm")