StatusBarGetText

標準のステータスバーコントロールからテキストを取得します。

Text := StatusBarGetText(Part#, WinTitle, WinText, ExcludeTitle, ExcludeText)

パラメータ

Part#

型：整数

省略されたときは、初期値は1になります。それ以外の場合は、検索するバーの品番を指定する。

WinTitle, WinText, ExcludeTitle, ExcludeText

型：文字列、整数またはオブジェクト

もしこれらの項目が未設定または省略されたときは、最後に見つかったウィンドウが使用されます。そうでないときは、WinTitleに ウィンドウタイトルまたはターゲットウィンドウを識別するための他の基準、および/またはWinTextにターゲットウィンドウの単一のテキスト要素からの部分文字列（付属のWindow Spyユーティリティを使えばわかります）を指定します。

ExcludeTitleとExcludeTextはウィンドウのタイトルまたはテキストで除外するために使用します。指定の仕方はWinTitleとWinTextに似ていますが、ExcludeTitleはウィンドウのタイトル以外の基準（ウィンドウクラスやHWNDなど）を認識しません。

ウィンドウのタイトルとテキストは大文字と小文字を区別します。DetectHiddenWindows関数 と DetectHiddenText関数で変更しない限り、初期設定では非表示ウィンドウは検出されず、非表示テキストは検出されます。SetTitleMatchMode関数で変更しない限り、初期設定ではウィンドウのタイトルはその中のどこかにWinTitleまたはExcludeTitleを含んでいれば一致します。

戻り値

型：文字列

この関数は、ステータスバーコントロールの単一部分のテキストを返す。

エラー処理

ターゲットウィンドウが見つからない、または標準のステータスバーが含まれていないときは、TargetErrorがスローされます。

SB_GETPARTSメッセージの送信に問題があったとき、2000 ミリ秒以内に応答がないとき、が受信されなかったとき、またはステータスバーのオーナーのプロセスにメモリを割り当てることができなかったときは、OSErrorがスローされます。

備考

この関数は、ウィンドウ上の最初の標準ステータスバー（共通コントロール：msctls_statusbar32）を読み込もうとする。プログラムによっては、独自のステータスバーやMSコモンコントロールの特別なバージョンを使用しているものもあり、その場合はテキストを取得することができない。

通常、ループ内で StatusBarGetText を使用するよりも、StatusBarGetTextを繰り返し呼び出すことによるオーバーヘッドを回避する最適化を含むStatusBarWaitを使用する方が効率的です。

関連

StatusBarWait、WinGetTitle、WinGetText、ControlGetText

例

RetrievedText := StatusBarGetText(1, "Search Results")
if InStr(RetrievedText, "found")
    MsgBox "Search results have been found."