AIT_FocusWindow

〈このページの構成〉

機能

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

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

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

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

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

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

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