Process.WaitForInputIdle Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Způsobí, že komponenta Process počká, až přidružený proces přejde do stavu nečinnosti.

Přetížení

WaitForInputIdle()	Způsobí, že komponenta Process bude čekat po neomezenou dobu, než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.
WaitForInputIdle(Int32)	Způsobí, že komponenta Process počká zadaný počet milisekund, než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.
WaitForInputIdle(TimeSpan)	Způsobí, že komponenta Process počká na zadaný timeout , než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.

WaitForInputIdle()

Zdroj:

Process.cs

Způsobí, že komponenta Process bude čekat po neomezenou dobu, než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.

public:
 bool WaitForInputIdle();

public bool WaitForInputIdle ();

member this.WaitForInputIdle : unit -> bool

Public Function WaitForInputIdle () As Boolean

Návraty

Boolean

true pokud přidružený proces dosáhl stavu nečinnosti.

Výjimky

InvalidOperationException

Proces nemá grafické rozhraní.

-nebo-

Došlo k neznámé chybě. Procesu se nepodařilo přejít do stavu nečinnosti.

-nebo-

Proces již byl ukončen.

-nebo-

K tomuto Process objektu není přidružen žádný proces.

Poznámky

Pomocí vynutíte WaitForInputIdle() , aby zpracování vaší aplikace počkalo, dokud se smyčka zpráv nevrátí do stavu nečinnosti. Při provádění procesu s uživatelským rozhraním se jeho smyčka zpráv spustí pokaždé, když operační systém odešle do procesu zprávu systému Windows. Proces se pak vrátí do smyčky zpráv. Proces je v nečinném stavu, když čeká na zprávy uvnitř smyčky zpráv. Tento stav je užitečný například tehdy, když vaše aplikace potřebuje čekat na dokončení počátečního procesu vytvoření hlavního okna, než aplikace s tímto oknem komunikuje.

Pokud proces neobsahuje smyčku zpráv, WaitForInputIdle() vyvolá .InvalidOperationException

Přetížení WaitForInputIdle() dává komponentě Process pokyn, aby po neomezenou dobu čekala, než se proces stane nečinnou ve smyčce zpráv. Tato instrukce může způsobit, že aplikace přestane reagovat. Pokud je například proces zapsán tak, aby vždy okamžitě ukončil svoji smyčku zpráv, jako v fragmentu while(true)kódu .

Viz také

• Start()
• CloseMainWindow()

WaitForInputIdle(Int32)

Zdroj:

Process.cs

Způsobí, že komponenta Process počká zadaný počet milisekund, než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.

public:
 bool WaitForInputIdle(int milliseconds);

public bool WaitForInputIdle (int milliseconds);

member this.WaitForInputIdle : int -> bool

Public Function WaitForInputIdle (milliseconds As Integer) As Boolean

Parametry

milliseconds

Int32

Hodnota 1 int32.MaxValue , která určuje dobu čekání přidruženého procesu v milisekundách, než se přidružený proces stane nečinný. Hodnota 0 určuje okamžitý návrat a hodnota -1 určuje nekonečné čekání.

Návraty

Boolean

truepokud přidružený proces dosáhl stavu nečinnosti; v opačném případě . false

Výjimky

InvalidOperationException

Proces nemá grafické rozhraní.

-nebo-

Došlo k neznámé chybě. Procesu se nepodařilo přejít do stavu nečinnosti.

-nebo-

Proces již byl ukončen.

-nebo-

K tomuto Process objektu není přidružen žádný proces.

Poznámky

Pomocí vynutíte WaitForInputIdle(Int32) , aby zpracování vaší aplikace počkalo, dokud se smyčka zpráv nevrátí do stavu nečinnosti. Při provádění procesu s uživatelským rozhraním se jeho smyčka zpráv spustí pokaždé, když operační systém odešle do procesu zprávu systému Windows. Proces se pak vrátí do smyčky zpráv. Proces je v nečinném stavu, když čeká na zprávy uvnitř smyčky zpráv. Tento stav je užitečný například tehdy, když vaše aplikace potřebuje čekat na dokončení počátečního procesu vytvoření hlavního okna, než aplikace s tímto oknem komunikuje.

Pokud proces neobsahuje smyčku zpráv, WaitForInputIdle(Int32) vyvolá .InvalidOperationException

Přetížení WaitForInputIdle(Int32) dává komponentě Process pokyn, aby počkala omezenou dobu, než se proces stane nečinnou ve smyčce zpráv. Pokud přidružený proces není na konci intervalu nečinný, protože smyčka stále zpracovává zprávy, false je vrácena volající procedura.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Viz také

• Start()
• CloseMainWindow()

WaitForInputIdle(TimeSpan)

Zdroj:

Process.cs

Způsobí, že komponenta Process počká na zadaný timeout , než přidružený proces přejde do stavu nečinnosti. Toto přetížení se vztahuje pouze na procesy s uživatelským rozhraním, a tedy i smyčkou zpráv.

public:
 bool WaitForInputIdle(TimeSpan timeout);

public bool WaitForInputIdle (TimeSpan timeout);

member this.WaitForInputIdle : TimeSpan -> bool

Public Function WaitForInputIdle (timeout As TimeSpan) As Boolean

Parametry

timeout

TimeSpan

Doba v milisekundách, která se má čekat, než se přidružený proces stane nečinný.

Návraty

Boolean

truepokud přidružený proces dosáhl stavu nečinnosti; v opačném případě . false

Výjimky

InvalidOperationException

Proces nemá grafické rozhraní.

-nebo-

Došlo k neznámé chybě. Procesu se nepodařilo přejít do stavu nečinnosti.

-nebo-

Proces již byl ukončen.

-nebo-

K tomuto Process objektu není přidružen žádný proces.

Poznámky

Pomocí vynutíte WaitForInputIdle(TimeSpan) , aby zpracování vaší aplikace počkalo, dokud se smyčka zpráv nevrátí do stavu nečinnosti.

Při provádění procesu s uživatelským rozhraním se jeho smyčka zpráv spustí pokaždé, když operační systém odešle do procesu zprávu systému Windows.

Proces se pak vrátí do smyčky zpráv. Proces je v nečinném stavu, když čeká na zprávy uvnitř smyčky zpráv.

Tento stav je užitečný například tehdy, když vaše aplikace potřebuje čekat na dokončení počátečního procesu vytvoření hlavního okna, než aplikace s tímto oknem komunikuje.