Process.WaitForInputIdle Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é |
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 -> boolPublic Function WaitForInputIdle () As BooleanRetours
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 -> boolPublic Function WaitForInputIdle (milliseconds As Integer) As BooleanParamè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 -> boolPublic Function WaitForInputIdle (timeout As TimeSpan) As BooleanParamè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.
