Process.WaitForInputIdle メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
関連付けられたプロセスがアイドル状態になるまで、 Process コンポーネントが待機します。
オーバーロード
| 名前 | 説明 |
|---|---|
| WaitForInputIdle() |
関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントが無期限に待機するようにします。 このオーバーロードは、ユーザー インターフェイスを持つプロセスにのみ適用されます。したがって、メッセージ ループです。 |
| WaitForInputIdle(Int32) |
関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントが指定したミリ秒数待機します。 このオーバーロードは、ユーザー インターフェイスを持つプロセスにのみ適用されます。したがって、メッセージ ループです。 |
WaitForInputIdle()
関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントが無期限に待機するようにします。 このオーバーロードは、ユーザー インターフェイスを持つプロセスにのみ適用されます。したがって、メッセージ ループです。
public:
bool WaitForInputIdle();
public bool WaitForInputIdle();
member this.WaitForInputIdle : unit -> bool
Public Function WaitForInputIdle () As Boolean
返品
true 関連付けられているプロセスがアイドル状態に達した場合。
例外
プロセスにはグラフィカル インターフェイスがありません。
-または-
原因不明のエラーが発生しました。 プロセスがアイドル状態に失敗しました。
-または-
プロセスは既に終了しています。
-または-
この Process オブジェクトにはプロセスは関連付けされません。
注釈
WaitForInputIdle()を使用して、メッセージ ループがアイドル状態に戻るまでアプリケーションの処理を強制的に待機させます。 ユーザー インターフェイスを持つプロセスが実行されている場合、Windows メッセージがオペレーティング システムによってプロセスに送信されるたびに、そのメッセージ ループが実行されます。 その後、プロセスはメッセージ ループに戻ります。 プロセスは、メッセージ ループ内のメッセージを待機しているときにアイドル状態にあると言われます。 この状態は、たとえば、アプリケーションがそのウィンドウと通信する前に、開始プロセスがメイン ウィンドウの作成を完了するまで待機する必要がある場合に便利です。
プロセスにメッセージ ループがない場合、 WaitForInputIdle() は InvalidOperationExceptionをスローします。
WaitForInputIdle() オーバーロードは、メッセージ ループでプロセスがアイドル状態になるまで無期限に待機するように、Process コンポーネントに指示します。 この命令により、アプリケーションが応答を停止する可能性があります。 たとえば、コード フラグメント while(true)のように、常にそのメッセージ ループを直ちに終了するようにプロセスが書き込まれる場合です。
こちらもご覧ください
適用対象
WaitForInputIdle(Int32)
関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントが指定したミリ秒数待機します。 このオーバーロードは、ユーザー インターフェイスを持つプロセスにのみ適用されます。したがって、メッセージ ループです。
public:
bool WaitForInputIdle(int milliseconds);
public bool WaitForInputIdle(int milliseconds);
member this.WaitForInputIdle : int -> bool
Public Function WaitForInputIdle (milliseconds As Integer) As Boolean
パラメーター
- milliseconds
- Int32
1 から Int32.MaxValue までの値。関連付けられているプロセスがアイドル状態になるまで待機する時間をミリ秒単位で指定します。 値 0 は即時戻り値を指定し、-1 の値は無限待機を指定します。
返品
true 関連付けられているプロセスがアイドル状態に達した場合。それ以外の場合は false。
例外
プロセスにはグラフィカル インターフェイスがありません。
-または-
原因不明のエラーが発生しました。 プロセスがアイドル状態に失敗しました。
-または-
プロセスは既に終了しています。
-または-
この Process オブジェクトにはプロセスは関連付けされません。
注釈
WaitForInputIdle(Int32)を使用して、メッセージ ループがアイドル状態に戻るまでアプリケーションの処理を強制的に待機させます。 ユーザー インターフェイスを持つプロセスが実行されている場合、Windows メッセージがオペレーティング システムによってプロセスに送信されるたびに、そのメッセージ ループが実行されます。 その後、プロセスはメッセージ ループに戻ります。 プロセスは、メッセージ ループ内のメッセージを待機しているときにアイドル状態にあると言われます。 この状態は、たとえば、アプリケーションがそのウィンドウと通信する前に、開始プロセスがメイン ウィンドウの作成を完了するまで待機する必要がある場合に便利です。
プロセスにメッセージ ループがない場合、 WaitForInputIdle(Int32) は InvalidOperationExceptionをスローします。
WaitForInputIdle(Int32) オーバーロードは、プロセスがメッセージ ループでアイドル状態になるまで、有限の時間待機するようにProcess コンポーネントに指示します。 ループがまだメッセージを処理しているために、関連付けられているプロセスが間隔の終わりまでにアイドル状態にならない場合は、 false が呼び出し元のプロシージャに返されます。
イベントの処理の詳細については、「処理とイベントの発生」を参照してください。