IWindowProvider::WaitForInputIdle メソッド (uiautomationcore.h)
呼び出し元のコードは、指定された時間、または関連付けられたプロセスがアイドル状態に入るまでブロックされます。どちらが最初に完了するかは関係ありません。
構文
HRESULT WaitForInputIdle(
[in] int milliseconds,
[out, retval] BOOL *pRetVal
);
パラメーター
[in] milliseconds
型: int
関連付けられたプロセスがアイドル状態になるまで待機する時間。単位はミリ秒です。 最大値は Int32.MaxValue です。
[out, retval] pRetVal
種類: BOOL*
ウィンドウがアイドル状態になった場合は TRUE を 受け取ります。 タイムアウト が発生した場合は FALSE。 このパラメーターは初期化せずに渡されます。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
このメソッドは、通常、UIA_Window_WindowOpenedEventIdの処理と組み合わせて使用 されます。 実装は、基になるアプリケーション フレームワークに依存します。したがって、このメソッドは、ウィンドウがユーザー入力の準備ができた後にしばらく時間を返す可能性があります。 呼び出し元のコードは、ウィンドウがアイドル状態になった正確なタイミングを確認するために、このメソッドに依存しないでください。 pRetVal の値を使用して、ウィンドウが入力の準備ができているか、メソッドがタイムアウトしたかを判断します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | uiautomationcore.h (UIAutomation.h を含む) |