Partager via


Méthode IWindowProvider ::WaitForInputIdle (uiautomationcore.h)

Provoque le blocage du code appelant pendant la durée spécifiée ou jusqu’à ce que le processus associé bascule dans un état d’inactivité (en fonction de l’échéance la plus proche).

Syntaxe

HRESULT WaitForInputIdle(
  [in]          int  milliseconds,
  [out, retval] BOOL *pRetVal
);

Paramètres

[in] milliseconds

Type : int

Délai, en millisecondes, à attendre que le processus associé devienne inactif. La valeur maximale est Int32.MaxValue.

[out, retval] pRetVal

Type : BOOL*

Reçoit TRUE si la fenêtre est entrée dans l’état inactif ; FALSE si le délai d’attente s’est produit. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode est généralement utilisée conjointement avec la gestion d’un UIA_Window_WindowOpenedEventId. L’implémentation dépend de l’infrastructure d’application sous-jacente ; Par conséquent, cette méthode peut revenir un certain temps après que la fenêtre est prête pour l’entrée utilisateur. Le code appelant ne doit pas s’appuyer sur cette méthode pour déterminer exactement quand la fenêtre est devenue inactive. Utilisez la valeur de pRetVal pour déterminer si la fenêtre est prête pour l’entrée ou si la méthode a expiré.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

IWindowProvider

Vue d'ensemble des fournisseurs UI Automation