AIT_FocusWindow

機能

指定したウィンドウ名とクラス名を持つウィンドウハンドルを取得して,フォーカスを設定します。

形式

integer AIT_FocusWindow  (
 string strWndCaption,     // ウィンドウのキャプション
 string strClassName       // クラス名
 [,float fTimeOut]         // タイムアウト時間
);

引数

strWndCaption(入力用)

ウィンドウのキャプションを指定してください。

strClassName(入力用)

ウィンドウのクラス名を指定してください。

fTimeOut(入力用,省略可)

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は,AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合のウィンドウハンドルが戻り値となり,処理が失敗した場合の戻り値は0となります。関数が0を返した場合は,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。

拡張エラー番号エラーコード
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
112ERROR_DISK_FULL
1400ERROR_INVALID_WINDOW_HANDLE
1460ERROR_TIMEOUT

注意事項

strWndCaptionに空の文字列を指定すると,空白のキャプションが付いたウィンドウを検索します。空白のキャプションが付いたウィンドウが複数ある場合は,最初に発見されたウィンドウにフォーカスを設定します。