ターゲットウィンドウのどのコントロールにキーボードフォーカスがあるのかを取得します(もしあれば)。
HWND := ControlGetFocus(WinTitle, WinText, ExcludeTitle, ExcludeText)
もしこれらの項目が未設定または省略されたときは、最後に見つかったウィンドウが使用されます。そうでないときは、WinTitleに ウィンドウタイトルまたはターゲットウィンドウを識別するための他の基準、および/またはWinTextにターゲットウィンドウの単一のテキスト要素からの部分文字列(付属のWindow Spyユーティリティを使えばわかります)を指定します。
ExcludeTitleとExcludeTextはウィンドウのタイトルまたはテキストで除外するために使用します。指定の仕方はWinTitleとWinTextに似ていますが、ExcludeTitleはウィンドウのタイトル以外の基準(ウィンドウクラスやHWNDなど)を認識しません。
ウィンドウのタイトルとテキストは大文字と小文字を区別します。DetectHiddenWindows関数とDetectHiddenText関数で変更しない限り、初期設定では非表示ウィンドウは検出されず、非表示テキストは検出されます。ただし、pure HWNDsを使ったときは、DetectHiddenWindowsの設定にかかわらず、非表示ウィンドウは常に検出されます。SetTitleMatchModeで変更しない限り、初期設定ではウィンドウタイトルのどこかにWinTitleまたはExcludeTitleを含んでいればマッチします。
Type: Integer
説明: フォーカスされているコントロールのウィンドウハンドル(HWND)を返します。
対象ウィンドウのどのコントロールにもフォーカスがない場合、戻り値は 0 となる。
ターゲットとなるウィンドウやコントロールの決定に問題がある場合、TargetErrorがスローされます。
フォーカスの決定に問題がある場合、OSErrorがスローされます。
この関数で取得されるコントロールは、キーボードフォーカスを持つもの、つまり、ユーザーが何か入力した場合にキーストロークを受け取ることになるものです。
対象ウィンドウがアクティブでなければフォーカスされたコントロールは得られませんが、アクティブなウィンドウであってもフォーカスされたコントロールがない場合があります。