Padrão de controle SynchronizedInput

Descreve diretrizes e convenções para implementar ISynchronizedInputProvider, incluindo informações sobre propriedades e métodos. O padrão de controle SynchronizedInput permite que os aplicativos cliente da Automação da Interface do Usuário da Microsoft direcionem a entrada do mouse ou do teclado para um elemento de interface do usuário específico.

Esse padrão de controle normalmente é usado em scripts de teste automatizados para enviar entrada de mouse ou teclado para um elemento específico da interface do usuário e, em seguida, verificar se o elemento recebeu a entrada.

Este tópico contém as seções a seguir.

• diretrizes e convenções de implementação
• membros necessários para ISynchronizedInputProvider
• tópicos relacionados

Diretrizes e convenções de implementação

Ao implementar o padrão de controle synchronizedInput, observe as seguintes diretrizes e convenções:

• Quando o método ISynchronizedInputProvider::StartListening é chamado, o provedor de Automação de Interface do Usuário deve começar a verificar a entrada do tipo especificado e executar uma das seguintes ações:
  • Quando a entrada correspondente é encontrada para o elemento, o provedor deve gerar o evento UIA_InputReachedTargetEventId.
  • Quando a entrada correspondente é encontrada, mas atingiu um elemento diferente, o provedor deve gerar o evento UIA_InputReachedOtherElementEventId.
  • Quando a entrada incompatível for encontrada, o provedor deverá descartar a entrada e gerar o evento UIA_InputDiscardedEventId.
• O provedor de Automação da Interface do Usuário deve descartar a entrada se for para um elemento diferente do elemento atual.
• Quando o elemento recebe a entrada ou quando o método ISynchronizedInputProvider::Cancel é chamado, o provedor para de verificar a entrada e continua normalmente.
• Se ISynchronizedInputProvider::StartListening for chamado quando o provedor já estiver escutando a entrada, o provedor deverá retornar UIA_E_INVALIDOPERATION.

Membros necessários para ISynchronizedInputProvider

As propriedades, métodos e eventos a seguir são necessários para implementar a interfaceISynchronizedInputProvider.

Tópicos relacionados

Visão geral dos padrões de controle de automação da interface do usuário