funzione WindowPattern_WaitForInputIdle (uiautomationcoreapi.h)

Articolo
08/26/2023

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce COM (Component Object Model) di Microsoft Automazione interfaccia utente.

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

Parametri

[in] hobj

Tipo: HUIAPATTERNOBJECT

Oggetto pattern di controllo.

[in] milliseconds

Tipo: int

Numero di millisecondi di attesa prima del recupero di pResult.

[out] pResult

Tipo: BOOL*

TRUE se la finestra è pronta ad accettare l'input dell'utente; in caso contrario FALSE.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

Questo metodo viene in genere usato in combinazione con la gestione di windowOpenedEvent (Window_WindowOpened_Event_GUID). L'implementazione dipende dal framework dell'applicazione sottostante; pertanto questo metodo può restituire qualche 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 pResult per determinare se la finestra è pronta per l'input o se il metodo è timeout.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Condividi tramite