StatusBarWait
提供: AutoHotkey Wiki
実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 |
キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル |
レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト
StatusBarWait[編集]
ステータスバーの内容が指定したテキストにマッチするようになるまで待機。
StatusBarWait [, BarText, Seconds, Part#, WinTitle, WinText, Interval, ExcludeTitle, ExcludeText]
Parameters[編集]
引数名 | 説明 |
---|---|
BarText | テキストを指定。大文字小文字は区別される。SetTitleMatchModeで指定したマッチ方式(前方一致や中間一致など)で判別される。 |
Seconds | 何秒間まで待つか。省略時は無限に待つ。 0 を指定すると、0.5秒待つ。
|
Part# | 何番目の区切りを対象とするか。デフォルトは 1 。
|
WinTitle | ウィンドウタイトルなど。 ウィンドウ指定の方法参照。 |
WinText | ウィンドウに含まれるテキスト |
Interval | 何ミリ秒間隔でタイトルをチェックするか。デフォルトは 50 。
|
ExcludeTitle | 除外タイトル |
ExcludeText | 除外テキスト |
ErrorLevel[編集]
AHKL [v1.1.04+] このコマンドはステータスバーにアクセスできなかった場合に例外をスローすることができる。詳細は実行時エラーを参照。
0 | ステータスバーの内容が指定したテキストに一致するようになった |
1 | ステータスバーの内容が指定したテキストに一致するようになる前にSecondsで指定した時間が経過した |
2 | ステータスバーにアクセスできなかった |
Remarks[編集]
Delphi製アプリケーションなどの特殊な仕様のステータスバーのテキストは取得できない。
待機中はホットキーやタイマーなどで起動されたスレッドが割り込める。
Related[編集]
StatusBarGetText, WinGetTitle, WinGetText, ControlGetText
Example(s)[編集]
IfWinExist, Search Results; Sets the Last Found window to simplify the below.
{ WinActivate Send, {tab 2}!o*.txt{enter} Sleep, 400; Give the status bar time to change to "Searching".
StatusBarWait, found, 30 If ErrorLevel = 0 MsgBox, The search successfully completed. Else MsgBox, The command timed out or there was a problem. }