Método ISynchronizedInputProvider::StartListening (uiautomationcore.h)

Começa a escutar a entrada do tipo especificado.

Sintaxe

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parâmetros

[in] inputType

Tipo: SynchronizedInputType

O tipo de entrada que é solicitado a ser sincronizado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando encontra a entrada correspondente, o provedor verifica se o elemento de Automação da Interface do Usuário de destino corresponde ao elemento atual. Se corresponderem, o provedor gerará o evento UIA_InputReachedTargetEventId ; caso contrário, ele aciona o evento UIA_InputReachedOtherElementEventId ou UIA_InputDiscardedEventId . O provedor de Automação da Interface do Usuário deve descartar a entrada se for para um elemento diferente deste.

Este é um método único; depois de receber a entrada, o provedor para de escutar e continua normalmente.

Esse método retornará E_INVALIDOPERATION se o provedor já estiver escutando a entrada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (include UIAutomation.h)

Confira também

ISynchronizedInputProvider