Metodo ISynchronizedInputProvider::StartListening (uiautomationcore.h)

  • Articolo

Avvia l'ascolto per l'input del tipo specificato.

Sintassi

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parametri

[in] inputType

Tipo: SyncdInputType

Tipo di input richiesto per la sincronizzazione.

Valore restituito

Tipo: HRESULT

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

Commenti

Quando trova l'input corrispondente, il provider controlla se l'elemento di destinazione Automazione interfaccia utente corrisponde all'elemento corrente. Se corrispondono, il provider genera l'evento UIA_InputReachedTargetEventId ; in caso contrario, genera l'evento UIA_InputReachedOtherElementEventId o UIA_InputDiscardedEventId . Il provider di Automazione interfaccia utente deve eliminare l'input se è per un elemento diverso da questo.

Si tratta di un metodo one-shot; dopo aver ricevuto l'input, il provider arresta l'ascolto e continua normalmente.

Questo metodo restituisce E_INVALIDOPERATION se il provider è già in ascolto dell'input.

Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Aggiornamento della piattaforma per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (includere UIAutomation.h)

Vedi anche

ISynchronizedInputProvider