Ferramentas de acessibilidade – AccEvent (Observador de Eventos Acessíveis)

AccEvent (Observador de Eventos Acessíveis) permite que desenvolvedores e testadores validem se os elementos de interface do usuário de um aplicativo geram eventos adequados de Automação da Interface do Usuário da Microsoft e acessibilidade ativa da Microsoft quando ocorrem alterações na interface do usuário. Alterações na interface do usuário podem ocorrer quando o foco é alterado ou quando um elemento de interface do usuário é invocado, selecionado ou tem um estado ou uma alteração de propriedade.

AccEvent é instalado com o SDK (Kit de Desenvolvimento de Software) do Windows. Ele está localizado na pasta \bin\<versão>\<plataforma> do caminho de instalação do SDK (Accevent.exe).

Requisitos

accEvent pode ser usado para examinar dados de acessibilidade em sistemas que não têm automação de interface do usuário, ele foi originalmente escrito para a Acessibilidade Ativa da Microsoft. Para examinar a Automação da Interface do Usuário, a Automação da Interface do Usuário deve estar presente no sistema. Para obter mais informações, consulte a seção "Requisitos" do de Automação da Interface do Usuário.

AccEvent é instalado como parte do conjunto geral de ferramentas no SDK do Windows, ele não é distribuído como um download de exe separado. O SDK do Windows inclui todas as ferramentas relacionadas à acessibilidade documentadas nesta seção. Obtenha o SDK do Windows. (Também há um arquivo morto de download do SDK vinculado a partir dessa página, se você precisar de uma versão anterior.)

Para executar do AccEvent, localize AccEvent.exe na>de versão do \bin\<\<pasta> de plataforma e execute-a (normalmente você não precisa executar como administrador).

A janela Observador de Eventos Acessível

Quando você inicia AccEvent, a janela principal é exibida. A janela AccEvent principal exibe os eventos de Automação da Interface do Usuário ou acessibilidade ativa da Microsoft gerados por aplicativos em execução. A janela principal tem as seguintes partes principais:

• Barra de título. Exibe o modo operacional e o estado atuais.
• Barra de menus. Fornece acesso à funcionalidade AccEvent.
• Exibição de dados. Exibe informações sobre cada evento, incluindo a ID do evento e as propriedades selecionadas do elemento de interface do usuário que gerou o evento.

AccEvent tem apenas uma interface gráfica do usuário; não há argumentos de linha de comando para essa ferramenta, mas você pode usar outras ferramentas para processar o log de saída como texto.

A imagem a seguir mostra a janela principal do AccEvent.

Tarefas do Observador de Eventos Acessíveis

Esta seção inclui informações sobre tarefas do AccEvent comumente usadas.

Configurando o modo de operação

Use o menu Modo para configurar o modo operacional AccEvent e selecione as configurações que controlam o comportamento da ferramenta. Você pode selecionar as opções a seguir.

Filtrando eventos de automação da interface do usuário

Para configurar os eventos e as propriedades da Automação da Interface do Usuário exibidos na janela AccEvent, clique no menu do Modo, selecione de Eventos do UIA e selecione Configurações. A caixa de diálogo configurações de evento UIA é exibida. Você também pode usar essa caixa de diálogo para filtrar eventos.

A caixa de diálogo configurações de evento UIA contém os seguintes painéis:

• eventos globais

  Marque a caixa de seleção FocusChangedEvent para exibir informações sobre eventos com alterações de foco globais.

• tipo de evento

  Selecione os eventos nos quais você está interessado.

• de Escopo do

  Selecione o elemento de interface do usuário que você deseja accEvent para escutar eventos.

• Incluir eventos de

  Selecione Filhos imediatos se você quiser ver eventos dos elementos filho imediatos do elemento da interface do usuário selecionados no painel escopo do. Se você quiser ver eventos de todos os elementos descendentes, selecione Todos os Descendentes.

• propriedades do relatório

  Selecione as propriedades que você deseja exibir após cada evento na janela principal. Se Mostrar Dica de Ferramenta de Informações estiver selecionado no menu modo, as propriedades selecionadas também serão exibidas em uma dica de ferramenta.

Filtrando eventos de acessibilidade ativos

Para configurar os eventos e as propriedades de Acessibilidade Ativa da Microsoft exibidos na janela AccEvent, clique no menu do Modo, selecione WinEvents (No Contexto) ou WinEvents (Fora de Contexto)e selecione Configurações. A caixa de diálogo Configurações do WinEvent é exibida. Você também pode usar essa caixa de diálogo para filtrar eventos.

A caixa de diálogo Configurações do WinEvent contém os seguintes painéis:

• objetos

  Selecione os objetos que você deseja AccEvent para escutar eventos. AccEvent pode escutar eventos provenientes de janelas, do cursor ou do cursor. de Janela é selecionado por padrão.

• eventos

  Selecione os eventos nos quais você está interessado. Todos os eventos são exibidos por padrão.

• de informações de evento

  Selecione as informações que você deseja exibir após o nome de cada evento na janela principal.

• Propriedades do objeto

  Selecione as propriedades que você deseja exibir após cada evento na janela principal. Se Mostrar Dica de Ferramenta de Informações estiver selecionado no menu modo, as propriedades selecionadas também serão exibidas em uma dica de ferramenta. Name, Rolee State são selecionados por padrão.

• filtragem

  Selecione um dos botões de opção na seção de filtragem para filtrar os eventos gerados pelas janelas especificadas no campo hWNDs. O botão Não filtrar opção é selecionado por padrão.

  • Selecione o botão Excluir opção para exibir apenas os eventos gerados de objetos diferentes das janelas especificadas.
  • Selecione a Incluir somente botão de opção e especifique um ou mais identificadores de janela para exibir apenas os eventos gerados dessas janelas.
  • Marque a caixa de seleção e Descendentes para incluir eventos gerados pelos descendentes das janelas especificadas.

• opções de

  Selecione qualquer uma das seguintes opções:

  Quando essa opção é selecionada	AccEvent faz isso
  Usar Invocação	Usa IDispatch::Invoke para recuperar propriedades de objeto em vez de usar métodos de IAccessible.
  Objeto Always Get (mesmo que nenhuma propriedade de objeto tenha sido selecionada)	Recupera o objeto associado ao evento mesmo que nenhum item seja selecionado no painel Propriedades do Objeto.
  Exibir propriedade padrão (além das propriedades selecionadas)	Exibe a propriedade padrão, se houver, para o objeto associado ao evento, juntamente com os itens selecionados no painel Propriedades do Objeto.
  Exibir informações de evento de janelas invisíveis/ocultas	Exibe os itens selecionados no painel Informações do Evento para todos os objetos, incluindo aqueles em janelas invisíveis ou ocultas.
  Exibir informações completas de eventos de janelas invisíveis/ocultas	Exibe os itens selecionados no painel Informações do Evento e os itens selecionados (ou padrão) no painel Propriedades do Objeto, para todos os objetos, incluindo aqueles em janelas invisíveis ou ocultas.
  DebugBreak no próximo evento	Faz com que uma exceção de ponto de interrupção ocorra no processo que origina o próximo WinEvent. Isso sinaliza o depurador para lidar com a exceção.

Usando o menu de eventos

Use o menu de Eventos do para executar as seguintes tarefas:

Salvando eventos de acessibilidade ativos

Para começar a salvar eventos em um arquivo de texto, abra o menu Arquivo e selecione Iniciar o Registro em Log no Arquivo. AccEvent começa a gravar eventos no arquivo especificado até selecionar Parar de Registro em Log no menu arquivo. O arquivo de texto pode ser útil para solucionar problemas e revisar os eventos posteriormente.

Tópicos relacionados

• do Observador de Eventos Acessível
• Teste de para de acessibilidade
• do Verificador de Acessibilidade da interface do usuário
• Visão geral de eventos de automação da interface do usuário
• de Verificação de Automação de Interface do Usuário
• WinEvents