Partilhar via

Visão geral sobre eventos de automação de interface do usuário

  • Artigo

Notificação de evento é um recurso para tecnologias auxiliares, como leitores de tela e lentes de chave.Esses Clientes de automação interface do usuário Controlar os eventos que são gerados por Provedores de automação interface do usuário quando algo acontece na e use as informações para notificar os usuários finais.

A eficiência é aprimorada permitindo que aplicativos provedores criem eventos seletivamente, dependendo se quaisquer clientes estão inscritos para esses eventos, ou se nenhum está escrito, se não há clientes ouvindo evento algum.

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

Tipos de eventos

Eventos se enquadram em categorias a seguir.

Evento

Descrição

Mudança de Propriedade

Gerado quando uma propriedade em um Elemento ou controle alterações padrão.Por exemplo, se um cliente precisa monitorar um aplicativo do Caixa de seleção de controle, ele pode registrar para ouvir um evento de alteração de propriedades na [P:System.Windows.Automation.TogglePadrão.TogglePadrãoInformation.ToggleState] Propriedade.Quando o controle caixa de seleção é marcado ou desmarcado, o provedor gera o evento e o cliente pode atuar conforme necessário.

Elemento de ação

Gerado quando uma alteração na Os resultados de usuário final ou através de programação atividade; Por exemplo, quando um botão é clicado ou chamado por meio InvokePattern.

Mudança de Estrutura

Gerado quando a estrutura das Árvore alterações.As alterações de estrutura ao novo Os itens se tornam Visível, oculto, ou removidos na área de trabalho.

Alteração da área de trabalho global

Gerado quando ocorrem ações de interesse global para o cliente, como quando o foco alterna de um elemento para outro, ou quando fecha uma janela.

Alguns eventos não necessariamente significam que o estado da interface do usuário foi alterado.Por exemplo, se o usuário guias a um campo de entrada de texto e, em seguida, clica em um botão para Atualizar o campo, um TextChangedEvent é gerado, mesmo se o usuário realmente não alterar o texto.Ao processar um evento, talvez seja necessário para um aplicativo cliente verificar se nada foi alterado na verdade, antes de realizar a ação.

Os seguintes eventos podem ser gerados mesmo quando o estado da interface do usuário não é alterado.

  • AutomationPropertyChangedEvent (dependendo de propriedade que tenha Alterado)

  • ElementSelectedEvent

  • InvalidatedEvent

  • TextChangedEvent

Identificadores de eventos de automação de interface do usuário

Os eventos são identificados por AutomationEvent Os objetos.O ID() Propriedade contém um valor que identifica o tipo de evento.

Os valores possíveis para ID() São fornecidas na tabela a seguir, juntamente com o tipo usado para eventos argumentos.Observe que os identificadores utilizados por clientes e provedores são campos de classes diferentes denominados de forma idêntica.

Identificador de cliente

Identificador do provedor

Tipo de Argumentos de Evento

AutomationElement.AsyncContentLoadedEvent

AutomationElementIdentifiers.AsyncContentLoadedEvent

AsyncContentLoadedEventArgs

SelectionItemPattern.ElementAddedToSelectionEvent

SelectionItemPattern.ElementRemovedFromSelectionEvent

SelectionItemPattern.ElementSelectedEvent

SelectionPattern.InvalidatedEvent

InvokePattern.InvokedEvent

AutomationElement.LayoutInvalidatedEvent

AutomationElement.MenuClosedEvent

AutomationElement.MenuOpenedEvent

TextPattern.TextChangedEvent

TextPattern.TextSelectionChangedEvent

AutomationElement.ToolTipClosedEvent

AutomationElement.ToolTipOpenedEvent

WindowPattern.WindowOpenedEvent

SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent

SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent

SelectionItemPatternIdentifiers.ElementSelectedEvent

SelectionPatternIdentifiers.InvalidatedEvent

InvokePatternIdentifiers.InvokedEvent

AutomationElementIdentifiers.LayoutInvalidatedEvent

AutomationElementIdentifiers.MenuClosedEvent

AutomationElementIdentifiers.MenuOpenedEvent

TextPatternIdentifiers.TextChangedEvent

TextPatternIdentifiers.TextSelectionChangedEvent

AutomationElementIdentifiers.ToolTipClosedEvent

AutomationElementIdentifiers.ToolTipOpenedEvent

WindowPatternIdentifiers.WindowOpenedEvent

AutomationEventArgs

AutomationElement.AutomationFocusChangedEvent

AutomationElementIdentifiers.AutomationFocusChangedEvent

AutomationFocusChangedEventArgs

AutomationElement.AutomationPropertyChangedEvent

AutomationElementIdentifiers.AutomationPropertyChangedEvent

AutomationPropertyChangedEventArgs

AutomationElement.StructureChangedEvent

AutomationElementIdentifiers.StructureChangedEvent

StructureChangedEventArgs

WindowPattern.WindowClosedEvent

WindowPatternIdentifiers.WindowClosedEvent

WindowClosedEventArgs

Argumentos de eventos de automação de interface do usuário

As seguintes classes encapsulam argumentos de evento.

Classe

Descrição

AsyncContentLoadedEventArgs

Contém informações sobre o carregamento assíncrono do conteúdo, incluindo a porcentagem de carregamento concluído.

AutomationEventArgs

Contém informações sobre um evento simples que não exige nenhum dado extra.

AutomationFocusChangedEventArgs

Contém informações sobre uma alteração no foco de entrada de um elemento para outro.Eventos desse tipo são gerados pelo sistema, não por provedores.

AutomationPropertyChangedEventArgs

Contém informações sobre uma alteração em um valor da propriedade de um elemento ou padrão de controle.

StructureChangedEventArgs

Contém informações sobre uma alteração na árvore.

WindowClosedEventArgs

Contém informações sobre o fechamento de uma janela.

Todas as classes de evento argumento contém um EventID() Membro.Esse identificador é encapsulado em um AutomationEvent.

O AutomationEvent objetos usados para identificar os eventos são obtidos por provedores de campos AutomationElementIdentifiers e controlar como classes Identificador padrão DockPatternIdentifiers.Os campos equivalentes são obtidos por aplicativos do cliente a partir de campos em AutomationElement e controlar como classes padrão DockPattern.

Para obter uma lista de identificadores de evento, consulte Automação de Eventos de Interface de Usuário para Clientes..

Consulte também

Tarefas

Registre-se em Eventos de Automação de Interface do Usuário

Conceitos

Automação de Eventos de Interface de Usuário para Clientes.

Implementação de Provedor de Automação de IU no Servidor