Compartilhar via


Método IUIAutomationSynchronizedInputPattern::StartListening (uiautomationclient.h)

Faz com que o provedor de Automação da Interface do Usuário da Microsoft comece a escutar a entrada do mouse ou do teclado.

Sintaxe

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parâmetros

[in] inputType

Tipo: SynchronizedInputType

Uma combinação de valores que especificam o tipo de entrada a ser escutada.

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 a entrada correspondente é encontrada, o provedor verifica se o elemento 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 .

Depois de receber a entrada do tipo especificado, o provedor para de verificar a entrada e continua normalmente.

Se o provedor já estiver escutando a entrada, esse método retornará E_INVALIDOPERATION.

Requisitos

   
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 [somente aplicativos da área de trabalho]
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 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomationSynchronizedInputPattern