<input type=image>に対するマウスクリックをシミュレートします。altテキスト、name、srcの部分文字列で指定します。
#include <IE.au3>
_IEFormImageClick ( ByRef $o_object, $s_linkText [, $s_mode = "src" [, $i_index = 0 [, $f_wait = 1]]] )
パラメータ
| $o_object | 任意のDOM要素(関連するドキュメントオブジェクトに変換されます)のオブジェクト変数 |
| $s_linkText | 要素指定のための値。$s_modeに従って使用されます |
| $s_mode | [オプション]検索モードを指定します src = (デフォルト) 画像のURLで検索します name = 画像のnameで検索します alt = 画像のaltテキストで検索します |
| $i_index | [オプション]一致する画像が複数見つかった場合、どれを使用するか指定する0始まりのインデックス |
| $f_wait | [オプション]ページのロード中に待機するかどうかを指定します 0 = 直ちに処理を返します。ページのロードを待ちません 1 = (デフォルト) ページのロードが完了してから処理を返します |
返し値
| 成功: | -1を返します |
| 失敗: | 0を返し@ERRORを設定します |
| @Error: | 0 ($_IEStatus_Success) = 正常終了 |
| 1 ($_IEStatus_GeneralError) = 一般的なエラー | |
| 3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
| 4 ($_IEStatus_InvalidObjectType) = 無効なオブジェクト型 | |
| 5 ($_IEStatus_InvalidValue) = 無効な値 | |
| 6 ($_IEStatus_LoadWaitTimeout) = ロード待機タイムアウト | |
| 7 ($_IEStatus_NoMatch) = 一致するものがありません | |
| 8 ($_IEStatus_AccessIsDenied) = アクセス拒否 | |
| 9 ($_IEStatus_ClientDisconnected) = クライアント切断 | |
| @Extended: | 無効なパラメータの番号が格納されています |
注意
フォーム要素の<input type=image>は他とは異なる取り扱いになります。Internet Explorerはこれをフォーム要素コレクションのメンバーとして認識しません。そういった場合にこの関数はsrc、name、alt文字列を使用してドキュメント内のオブジェクトへの参照を得るための手段を提供します。この関数はオブジェクトを渡しているかどうかに関わらず、全ドキュメントコンテキスト内のフォーム要素を探査します。
関連
_IEImgClick, _IEImgGetCollection, _IELoadWait
例
; *******************************************************
; 例 1 - フォームのサンプルをブラウザで開き、altテキストが一致する
; <input type=image> フォーム要素をクリック
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("form")
_IEFormImageClick ($oIE, "AutoIt Homepage", "alt")
; *******************************************************
; 例 2 - フォームのサンプルをブラウザで開き、画像URL(一部)が一致する<input type=image>
; フォーム要素をクリック
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("form")
_IEFormImageClick ($oIE, "autoit_6_240x100.jpg", "src")
; *******************************************************
; 例 3 - フォームのサンプルをブラウザで開き、nameが一致する
; <input type=image> フォーム要素をクリック
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("form")
_IEFormImageClick ($oIE, "imageExample", "name")