Process.WaitForInputIdle Méthode

Définition

Fait en sorte que le composant Process attende que le processus associé passe à un état inactif.

Surcharges

WaitForInputIdle()

Fait en sorte que le composant Process attende indéfiniment que le processus associé passe à un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

WaitForInputIdle(Int32)

Fait en sorte que le composant Process attende pendant le nombre spécifié de millisecondes que le processus associé passe à un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

WaitForInputIdle(TimeSpan)

Provoque le Process composant à attendre le spécifié timeout pour que le processus associé entre dans un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

WaitForInputIdle()

Source:
Process.cs
Source:
Process.cs
Source:
Process.cs

Fait en sorte que le composant Process attende indéfiniment que le processus associé passe à un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

public:
 bool WaitForInputIdle();
public bool WaitForInputIdle ();
member this.WaitForInputIdle : unit -> bool
Public Function WaitForInputIdle () As Boolean

Retours

true si le processus associé est devenu inactif.

Exceptions

Le processus ne dispose pas d’une interface graphique.

- ou -

Une erreur inconnue s'est produite. Le processus n’est pas parvenu à entrer dans un état inactif.

- ou -

Le processus est déjà terminé.

- ou -

Aucun processus n’est associé à cet objet Process.

Remarques

Utilisez WaitForInputIdle() pour forcer le traitement de votre application à attendre que la boucle de message soit retournée à l’état inactif. Lorsqu’un processus avec une interface utilisateur est en cours d’exécution, sa boucle de message s’exécute chaque fois qu’un message Windows est envoyé au processus par le système d’exploitation. Le processus retourne ensuite à la boucle de message. Un processus est dit dans un état inactif lorsqu’il attend des messages à l’intérieur d’une boucle de message. Cet état est utile, par exemple, lorsque votre application doit attendre qu’un processus de démarrage termine la création de sa fenêtre main avant que l’application ne communique avec cette fenêtre.

Si un processus n’a pas de boucle de message, WaitForInputIdle() lève un InvalidOperationException.

La WaitForInputIdle() surcharge indique au Process composant d’attendre indéfiniment que le processus soit inactif dans la boucle de message. Cette instruction peut entraîner l’arrêt de la réponse d’une application. Par exemple, si le processus est écrit pour quitter toujours sa boucle de message immédiatement, comme dans le fragment while(true)de code .

Voir aussi

S’applique à

WaitForInputIdle(Int32)

Source:
Process.cs
Source:
Process.cs
Source:
Process.cs

Fait en sorte que le composant Process attende pendant le nombre spécifié de millisecondes que le processus associé passe à un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

public:
 bool WaitForInputIdle(int milliseconds);
public bool WaitForInputIdle (int milliseconds);
member this.WaitForInputIdle : int -> bool
Public Function WaitForInputIdle (milliseconds As Integer) As Boolean

Paramètres

milliseconds
Int32

Valeur de 1 à Int32.MaxValue qui spécifie la durée d’attente, en millisecondes, pour que le processus associé devienne inactif. Une valeur de 0 spécifie un retour immédiat et une valeur de -1 spécifie une attente infinie.

Retours

true si le processus associé a atteint un état inactif ; sinon, false.

Exceptions

Le processus ne dispose pas d’une interface graphique.

- ou -

Une erreur inconnue s'est produite. Le processus n’est pas parvenu à entrer dans un état inactif.

- ou -

Le processus est déjà terminé.

- ou -

Aucun processus n’est associé à cet objet Process.

Remarques

Utilisez WaitForInputIdle(Int32) pour forcer le traitement de votre application à attendre que la boucle de message soit retournée à l’état inactif. Lorsqu’un processus avec une interface utilisateur est en cours d’exécution, sa boucle de message s’exécute chaque fois qu’un message Windows est envoyé au processus par le système d’exploitation. Le processus retourne ensuite à la boucle de message. Un processus est dit dans un état inactif lorsqu’il attend des messages à l’intérieur d’une boucle de message. Cet état est utile, par exemple, lorsque votre application doit attendre qu’un processus de démarrage termine la création de sa fenêtre main avant que l’application ne communique avec cette fenêtre.

Si un processus n’a pas de boucle de message, WaitForInputIdle(Int32) lève un InvalidOperationException.

La WaitForInputIdle(Int32) surcharge indique au Process composant d’attendre un laps de temps fini avant que le processus devienne inactif dans la boucle du message. Si le processus associé n’est pas inactif à la fin de l’intervalle, car la boucle traite toujours les messages, false est retourné à la procédure appelante.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

Voir aussi

S’applique à

WaitForInputIdle(TimeSpan)

Source:
Process.cs
Source:
Process.cs
Source:
Process.cs

Provoque le Process composant à attendre le spécifié timeout pour que le processus associé entre dans un état inactif. Cette surcharge s'applique uniquement aux processus dotés d'une interface utilisateur et, donc, d'une boucle de message.

public:
 bool WaitForInputIdle(TimeSpan timeout);
public bool WaitForInputIdle (TimeSpan timeout);
member this.WaitForInputIdle : TimeSpan -> bool
Public Function WaitForInputIdle (timeout As TimeSpan) As Boolean

Paramètres

timeout
TimeSpan

Délai, en millisecondes, à attendre que le processus associé devienne inactif.

Retours

true si le processus associé a atteint un état inactif ; sinon, false.

Exceptions

Le processus ne dispose pas d’une interface graphique.

- ou -

Une erreur inconnue s'est produite. Le processus n’est pas parvenu à entrer dans un état inactif.

- ou -

Le processus est déjà terminé.

- ou -

Aucun processus n’est associé à cet objet Process.

Remarques

Utilisez WaitForInputIdle(TimeSpan) pour forcer le traitement de votre application à attendre que la boucle de message soit retournée à l’état inactif.

Lorsqu’un processus avec une interface utilisateur est en cours d’exécution, sa boucle de message s’exécute chaque fois qu’un message Windows est envoyé au processus par le système d’exploitation.

Le processus retourne ensuite à la boucle de message. Un processus est dit dans un état inactif lorsqu’il attend des messages à l’intérieur d’une boucle de message.

Cet état est utile, par exemple, lorsque votre application doit attendre qu’un processus de démarrage termine la création de sa fenêtre main avant que l’application ne communique avec cette fenêtre.

S’applique à