IWindowProvider::WaitForInputIdle-Methode (uiautomationcore.h)

Artikel
03/03/2024

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 WaitForInputIdle(
  [in]          int  milliseconds,
  [out, retval] BOOL *pRetVal
);

Parameter

[in] milliseconds

Typ: int

Die Zeitspanne in Millisekunden, während der gewartet werden soll, dass der zugeordnete Prozess in den Leerlauf wechselt. Das Maximum ist Int32.MaxValue.

[out, retval] pRetVal

Typ: BOOL*

Erhält TRUE , wenn das Fenster den Leerlaufzustand erreicht hat. FALSE , wenn das Timeout aufgetreten ist. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird in der Regel in Verbindung mit der Behandlung eines UIA_Window_WindowOpenedEventId verwendet. Die Implementierung ist vom zugrunde liegenden Anwendungsframework abhängig. Daher kann diese Methode einige Zeit nach dem Start des Fensters für die Benutzereingabe zurückgegeben werden. Der aufrufende Code sollte nicht auf dieser Methode basieren, um genau zu ermitteln, wann das Fenster im Leerlauf ist. Verwenden Sie den Wert von pRetVal , um zu bestimmen, ob das Fenster für die Eingabe bereit ist oder ob das Timeout für die Methode aus ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

IWindowProvider

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter

Freigeben über