Metodo IWindowProvider::WaitForInputIdle (uiautomationcore.h)

Articolo
03/03/2024

Comporta il blocco del codice chiamante per il lasso di tempo specificato o finché il processo associato non entra in stato di inattività, in base alla prima condizione che viene soddisfatta.

Sintassi

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

Parametri

[in] milliseconds

Tipo: int

Quantità di tempo, espressa in millisecondi, per cui aspettare che il processo associato diventi inattivo. Il valore massimo è Int32.MaxValue.

[out, retval] pRetVal

Tipo: BOOL*

Riceve TRUE se la finestra ha immesso lo stato di inattività; FALSE se si è verificato il timeout. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo viene in genere usato insieme alla gestione di un UIA_Window_WindowOpenedEventId. L'implementazione dipende dal framework dell'applicazione sottostante; pertanto questo metodo potrebbe restituire un po ' di tempo dopo che la finestra è pronta per l'input dell'utente. Il codice chiamante non deve basarsi su questo metodo per verificare esattamente quando la finestra è diventata inattiva. Usare il valore di pRetVal per determinare se la finestra è pronta per l'input o se il metodo è timeout.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcore.h (include UIAutomation.h)

Vedi anche

IWindowProvider

Cenni preliminari sui provider di automazione interfaccia utente

Condividi tramite