Ferramentas de acessibilidade - AccEvent (Accessible Event Watcher)

AccEvent (Accessible Event Watcher) permite que desenvolvedores e testadores validem se os elementos da interface do usuário de um aplicativo geram eventos adequados de Automação da Interface do Usuário da Microsoft e Microsoft Ative Accessibility quando ocorrem alterações na interface do usuário. As alterações na interface do usuário podem ocorrer quando o foco é alterado ou quando um elemento da interface do usuário é invocado, selecionado ou tem uma alteração de estado ou propriedade.

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

Requerimentos

AccEvent pode ser usado para examinar dados de acessibilidade em sistemas que não têm automação da interface do usuário, ele foi originalmente escrito para Microsoft Ative Accessibility. 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" de 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 exe separado. O SDK do Windows inclui todas as ferramentas relacionadas à acessibilidade documentadas nesta seção. Obtenha o SDK do Windows. (Há também um arquivo de download do SDK vinculado a partir dessa página, se você precisar de uma versão anterior.)

Para executar AccEvent , localize AccEvent.exe na pasta \bin\<versão>\<plataforma> e execute-a (normalmente não é necessário executar como administrador).

A janela do Observador de Eventos Acessível

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

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

AccEvent tem apenas uma interface gráfica de utilizador; 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 AccEvent.

Tarefas acessíveis do Observador de Eventos

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

Configurando o modo operacional

Use o menu Modo de para configurar o modo de operação AccEvent e selecione as configurações que controlam o comportamento da ferramenta. Você pode selecionar as seguintes opções.

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

Para configurar os eventos e as propriedades de Automação da Interface do Usuário exibidos na janela AccEvent do, clique no menu Modo de, selecione de Eventos da 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 globais alterados de foco.

• Tipo de evento

  Selecione os eventos em que está interessado.

• Âmbito

  Selecione o elemento da interface do usuário que você deseja AccEvent ouvir para eventos.

• Incluir eventos de

  Selecione filhos imediatos se você o que ver dos elementos filho imediato do elemento da interface do usuário selecionado no painel Escopo do. Se quiser ver eventos de todos os elementos descendentes, selecione Todos os Descendentes.

• de 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 selecionada no menu Modo de, as propriedades selecionadas também serão exibidas em uma dica de ferramenta.

Filtrando eventos de acessibilidade ativa

Para configurar os eventos e propriedades do Microsoft Ative Accessibility exibidos na janela AccEvent do, clique no menu Modo, selecione WinEvents (No Contexto) ou WinEvents (Fora de Contexto)e, em seguida, 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 WinEvent Settings contém os seguintes painéis:

• Objetos

  Selecione os objetos que você deseja AccEvent ouvir para eventos. AccEvent pode ouvir eventos provenientes de janelas, do cursor ou do cursor. Janela está selecionada por padrão.

• Eventos

  Selecione os eventos em que está interessado. Todos os eventos são exibidos por padrão.

• de informações do evento

  Selecione as informações que 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 selecionada no menu Modo de, as propriedades selecionadas também serão exibidas em uma dica de ferramenta. Nome, de Função e de Estado 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 de opção Não filtrar é selecionado por padrão.

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

• Opções

  Selecione uma das seguintes opções:

  Quando esta opção é selecionada	AccEvent faz isso
  Usar Invoke	Usa IDispatch::Invoke para recuperar propriedades de objeto em vez de usar IAccessible métodos.
  Sempre Obter Objeto (mesmo que nenhuma propriedade de objeto seja selecionada)	Recupera o objeto associado ao evento mesmo que nenhum item esteja 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 eventos 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 do evento a partir de janelas invisíveis/ocultas	Exibe os itens selecionados do painel Informações do Evento e os itens selecionados (ou padrão) do 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 eventos para executar as seguintes tarefas:

Guardar eventos de acessibilidade ativa

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

Tópicos relacionados

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