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.
Provoque l’attente Process du composant pour que le processus associé entre dans un état inactif.
Surcharges
| Nom | Description |
|---|---|
| WaitForInputIdle() |
Provoque l’attente indéfinie du composant Process pour que le processus associé entre dans un état inactif. Cette surcharge s’applique uniquement aux processus avec une interface utilisateur et, par conséquent, à une boucle de message. |
| WaitForInputIdle(Int32) |
Provoque le Process composant d’attendre le nombre spécifié de millisecondes pour que le processus associé entre un état inactif. Cette surcharge s’applique uniquement aux processus avec une interface utilisateur et, par conséquent, à une boucle de message. |
WaitForInputIdle()
Provoque l’attente indéfinie du composant Process pour que le processus associé entre dans un état inactif. Cette surcharge s’applique uniquement aux processus avec une interface utilisateur et, par conséquent, à une boucle de message.
public:
bool WaitForInputIdle();public bool WaitForInputIdle();member this.WaitForInputIdle : unit -> boolPublic Function WaitForInputIdle () As BooleanRetours
true si le processus associé a atteint un état inactif.
Exceptions
Le processus n’a pas d’interface graphique.
-ou-
Une erreur inconnue s'est produite. Le processus n’a pas pu entrer un état inactif.
-ou-
Le processus a déjà quitté.
-ou-
Aucun processus n’est associé à cet Process objet.
Remarques
Permet WaitForInputIdle() de 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 s’exécute, 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 principale 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 Process au composant d’attendre indéfiniment que le processus devienne 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 toujours quitter sa boucle de message immédiatement, comme dans le fragment while(true)de code .
Voir aussi
S’applique à
WaitForInputIdle(Int32)
Provoque le Process composant d’attendre le nombre spécifié de millisecondes pour que le processus associé entre un état inactif. Cette surcharge s’applique uniquement aux processus avec une interface utilisateur et, par conséquent, à 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, en millisecondes, pour attendre 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 n’a pas d’interface graphique.
-ou-
Une erreur inconnue s'est produite. Le processus n’a pas pu entrer un état inactif.
-ou-
Le processus a déjà quitté.
-ou-
Aucun processus n’est associé à cet Process objet.
Remarques
Permet WaitForInputIdle(Int32) de 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 s’exécute, 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 principale 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 Process au composant d’attendre un délai fini pour que le processus devienne inactif dans la boucle de message. Si le processus associé n’est pas devenu inactif à la fin de l’intervalle, car la boucle traite toujours les messages, false est retournée à la procédure appelante.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.