名前によってフォーム要素へのオブジェクト参照を返します。
#include <IE.au3>
_IEFormElementGetObjByName ( ByRef $o_object, $s_name [, $i_index = 0] )
パラメータ
| $o_object | InternetExplorer.Applicationのオブジェクト変数、フォームオブジェクト |
| $s_name | 取得したいフォーム要素の名前を指定します |
| $i_index | [オプション]フォーム要素名が複数ある場合、0始まりのインデックスでインスタンスを指定します 0 (デフォルト) または正の整数の場合、そのインデックスのインスタンスを返します -1 の場合、指定したフォーム要素のコレクションを返します |
返し値
| 成功: | フォーム要素オブジェクトを指すオブジェクト変数を返します。@EXTENDED = フォームの数 |
| 失敗: | 0を返し@ERRORを設定します |
| @Error: | 0 ($_IEStatus_Success) = 正常終了 |
| 3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
| 4 ($_IEStatus_InvalidObjectType) = 無効なオブジェクト型 | |
| 7 ($_IEStatus_NoMatch) = 一致するものがありません | |
| @Extended: | 無効なパラメータの番号が格納されています |
注意
欲しいフォーム要素が名前もIDも持っていない場合、_IEFormElementGetCollectionを使ってインデックスによって参照を取得してください。
関連
_IEFormElementGetCollection, _IEFormElementGetValue, _IEFormElementSetValue, _IEFormSubmit
例
; *******************************************************
; 例 1 - 名前によって特定のフォーム要素への参照を取得。
; このケースでは、Google検索エンジンにクエリをサブミットしている
; *******************************************************
;
#include <IE.au3>
$oIE = _IECreate ("http://www.google.com")
$oForm = _IEFormGetObjByName ($oIE, "f")
$oQuery = _IEFormElementGetObjByName ($oForm, "q")
_IEFormElementSetValue ($oQuery, "AutoIt IE.au3")
_IEFormSubmit ($oForm)