WindowPattern_WaitForInputIdle-Funktion (uiautomationcoreapi.h)

Artikel
03/03/2024

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die Microsoft Benutzeroberflächenautomatisierung COM-Schnittstellen (Component Object Model) verwenden.

Bewirkt, dass der aufrufende Code für die angegebene Zeitspanne oder solange blockiert wird, bis der zugeordnete Prozess in den Leerlauf wechselt, je nachdem, was zuerst zutrifft.

Syntax

HRESULT WindowPattern_WaitForInputIdle(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  int               milliseconds,
  [out] BOOL              *pResult
);

Parameter

[in] hobj

Typ: HUIAPATTERNOBJECT

Das Steuerelementmusterobjekt.

[in] milliseconds

Typ: int

Die Anzahl der Millisekunden, die vor dem Abrufen von pResult gewartet werden sollen.

[out] pResult

Typ: BOOL*

TRUE , wenn das Fenster bereit ist, Benutzereingaben zu akzeptieren; andernfalls FALSE.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert.

Hinweise

Diese Methode wird in der Regel in Verbindung mit der Behandlung eines WindowOpenedEvent (Window_WindowOpened_Event_GUID) verwendet. Die Implementierung hängt vom zugrunde liegenden Anwendungsframework ab. Daher kann diese Methode einige Zeit zurückgeben, nachdem das Fenster für die Benutzereingabe bereit ist. Der aufrufende Code sollte sich nicht auf diese Methode verlassen, um genau zu ermitteln, wann das Fenster im Leerlauf ist. Verwenden Sie den Wert von pResult , um zu bestimmen, ob das Fenster für die Eingabe bereit ist oder ob für die Methode ein Timeout ausgeführt wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Freigeben über