Metodo IUIAutomationSynchronizedInputPattern::StartListening (uiautomationclient.h)

Fa sì che il provider di Automazione interfaccia utente Microsoft inizi ad ascoltare l'input del mouse o della tastiera.

Sintassi

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parametri

[in] inputType

Tipo: SynchronizedInputType

Combinazione di valori che specificano il tipo di input da ascoltare.

Valore restituito

Tipo: HRESULT

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

Commenti

Quando viene trovato l'input corrispondente, il provider controlla se l'elemento di destinazione corrisponde all'elemento corrente. Se corrispondono, il provider genera l'evento UIA_InputReachedTargetEventId ; in caso contrario genera l'evento UIA_InputReachedOtherElementEventId o UIA_InputDiscardedEventId .

Dopo aver ricevuto l'input del tipo specificato, il provider interrompe il controllo dell'input e continua come di consueto.

Se il provider è già in ascolto dell'input, questo metodo restituisce E_INVALIDOPERATION.

Requisiti

   
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 [solo app desktop]
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 Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomationSynchronizedInputPattern