Function Reference

_IELinkClickByText

与えられた文字列と一致するテキストを含むリンクに対してマウスクリックをシミュレートします。

#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