与えられた文字列と一致するテキストを含むリンクに対してマウスクリックをシミュレートします。
#include <IE.au3>
_IELinkClickByText ( ByRef $o_object, $s_linkText [, $i_index = 0[, $f_wait = 1]] )
パラメータ
$o_object | InternetExplorer.Applicationのオブジェクト変数、ウィンドウまたはフレームオブジェクト |
$s_linkText | ウェブページ上のクリックしたいリンクに表示されているテキスト |
$i_index | [オプション]一致するリンクのテキストが複数見つかった場合、どれを使用するか指定する0始まりのインデックス |
$f_wait | [オプション]ページのロード中に待機するかどうかを指定します 0 = 直ちに処理を返します。ページのロードを待ちません 1 = (デフォルト) ページのロードが完了してから処理を返します |
返し値
成功: | -1を返します |
失敗: | 0を返し@ERRORを設定します |
@Error: | 0 ($_IEStatus_Success) = 正常終了 |
1 ($_IEStatus_GeneralError) = 一般的なエラー | |
3 ($_IEStatus_InvalidDataType) = 無効なデータ型 | |
4 ($_IEStatus_InvalidObjectType) = 無効なオブジェクト型 | |
6 ($_IEStatus_LoadWaitTimeout) = ロード待機タイムアウト | |
7 ($_IEStatus_NoMatch) = 一致するものがありません | |
8 ($_IEStatus_AccessIsDenied) = アクセス拒否 | |
9 ($_IEStatus_ClientDisconnected) = クライアント切断 | |
@Extended: | 無効なパラメータの番号が格納されています |
注意
リンクとして現れる要素が全て本当にリンクであるわけではありません。リンク処理をシミュレートするためにonClick JavaScriptイベントと他のDOMイベントを結びつけるのは一般的な方法です。このような要素をアクティブにするためには_IEAction で"click"を使用してください。
関連
_IELinkClickByIndex, _IELoadWait
例
; *******************************************************
; 例 1 - 基礎的なサンプルをブラウザで開き、"user forum"というテキストの
; ついたリンクをクリック
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("basic")
_IELinkClickByText ($oIE, "user forum")
; *******************************************************
; 例 2 - AutoItホームページをブラウザで開き、ページ上のリンクでループ。
; "wallpaper"というテキストを含むリンクをクリック
; *******************************************************
;
#include <IE.au3>
$oIE = _IECreate("http://www.autoitscript.com")
$sMyString = "wallpaper"
$oLinks = _IELinkGetCollection($oIE)
For $oLink in $oLinks
$sLinkText = _IEPropertyGet($oLink, "innerText")
If StringInStr($sLinkText, $sMyString) Then
_IEAction($oLink, "click")
ExitLoop
EndIf
Next