WinGetStyle / WinGetExStyle

指定されたウィンドウのスタイルまたは拡張スタイル(それぞれ)を返します。

Style := WinGetStyle(WinTitle, WinText, ExcludeTitle, ExcludeText)
ExStyle := WinGetExStyle(WinTitle, WinText, ExcludeTitle, ExcludeText)

パラメータ

WinTitle、WinText、ExcludeTitle、ExcludeText

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

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

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

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

戻り値

型:整数

これらの関数は、指定されたウィンドウのスタイルまたは拡張スタイル(それぞれ)を返します。マッチするウィンドウがないときは、空文字列が返されます。

エラー処理

ウィンドウが見つからないときは、TargetErrorがスローされます。

備考

スタイルの一部については、スタイル表をご覧ください。

マウスカーソルの下にあるウィンドウのIDは、MouseGetPos関数で取得できます。

WinSetStyle / WinSetExStyle, ControlGetStyle / ControlGetExStyle, styles table, Win functions, Control functions

ウィンドウが WS_DISABLED スタイルを持つかどうかを判定します。

Style := WinGetStyle("My Window Title")
if (Style & 0x8000000)  ; 0x8000000 is WS_DISABLED.
    MsgBox "The window is disabled."

ウィンドウのスタイルが WS_EX_TOPMOST (常にトップ) かどうかを判定します。

ExStyle := WinGetExStyle("My Window Title")
if (ExStyle & 0x8)  ; 0x8 is WS_EX_TOPMOST.
    MsgBox "The window is always-on-top."