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

Article
08/26/2023

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

Share via