fonction WindowPattern_WaitForInputIdle (uiautomationcoreapi.h)

Article
03/03/2024

Note Cette fonction est déconseillée. Les applications clientes doivent utiliser les interfaces COM (Microsoft UI Automation Component Object Model) à la place.

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 WindowPattern_WaitForInputIdle(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  int               milliseconds,
  [out] BOOL              *pResult
);

Paramètres

[in] hobj

Type : HUIAPATTERNOBJECT

Objet de modèle de contrôle.

[in] milliseconds

Type : int

Nombre de millisecondes à attendre avant de récupérer pResult.

[out] pResult

Type : BOOL*

TRUE si la fenêtre est prête à accepter l’entrée utilisateur ; sinon , FALSE.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

Remarques

Cette méthode est généralement utilisée conjointement avec la gestion d’un WindowOpenedEvent (Window_WindowOpened_Event_GUID). L’implémentation dépend de l’infrastructure d’application sous-jacente ; Par conséquent, cette méthode peut retourner 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 pResult 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 uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationcoreapi.h
Bibliothèque	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Partager via