Compartilhar via


Ferramentas de acessibilidade – Inspecionar

Importante

Inspecionar é uma ferramenta herdada. Em vez disso, recomendamos do Accessibility Insights.

Inspeção (Inspect.exe) é uma ferramenta baseada no Windows que pode selecionar qualquer elemento da interface do usuário e exibir seus dados de acessibilidade. Você pode exibir propriedades e padrões de controle da Automação da Interface do Usuário da Microsoft e propriedades de MSAA (Microsoft Active Accessibility). A inspeção também pode testar a estrutura de navegação dos elementos de automação na árvore de Automação da Interface do Usuário e os objetos acessíveis na hierarquia de Acessibilidade Ativa da Microsoft.

Requisitos

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 Run-Time Requirements.

A inspeção é instalada como uma das ferramentas no SDK (Kit de Desenvolvimento de Software do Windows), que inclui todas as ferramentas relacionadas à acessibilidade documentadas nesta seção. Inspeção não é distribuída como um download separado.

Baixar o SDK do Windows.

Nota

Para versões mais antigas do SDK do Windows, consulte o O SDK do Windows e o arquivo morto do emulador.

Inspect.exe está localizado na pasta \bin\<versão>\<plataforma> do caminho de instalação do SDK. Normalmente, você não precisa executá-lo como administrador.

A janela Inspecionar

A janela inspecioná tem várias partes principais:

  • Barra de título. Exibe o identificador de janela Inspecionar (HWND).
  • Barra de menus. Fornece acesso à funcionalidade Inspecionar.
  • Barra de ferramentas. Fornece acesso à funcionalidade Inspecionar.
  • Exibição de árvore. Apresenta a estrutura hierárquica de elementos da interface do usuário como um controle de exibição de árvore que você pode usar para navegar entre os elementos.
  • Exibição de dados. Exibe todas as propriedades de acessibilidade expostas para o elemento de interface do usuário selecionado.

Os comandos disponíveis na barra de menus também estão disponíveis na barra de ferramentas. A imagem a seguir mostra Inspecionar consultando as propriedades da Automação da Interface do Usuário do elemento de menu Editar no Bloco de Notas.

Captura de tela que mostra a interface do usuário da ferramenta Inspecionar.

Usando Inspeção

Quando você inicia a Inspeção, o modo de exibição de árvore mostra o local do elemento de interface do usuário selecionado no momento na hierarquia de elementos, enquanto a exibição de dados mostra as informações de propriedade do elemento de interface do usuário selecionado. Você pode navegar pela interface do usuário para exibir informações de acessibilidade sobre cada elemento na interface do usuário. Por padrão, Inspecione as faixas de foco do teclado ou do mouse. Conforme o foco muda, a exibição de dados é atualizada com as informações de propriedade do elemento com foco.

Para navegar entre os elementos da interface do usuário, você pode usar qualquer um dos seguintes elementos:

  • O mouse.
  • O teclado.
  • O controle de exibição de árvore no modo de exibição de árvore.
  • As opções de navegação no menu de Navegação do.
  • As opções de navegação na barra de ferramentas.

As últimas três opções permitem que você navegue pela hierarquia de árvores da interface do usuário. A estrutura dessa árvore pode ser ligeiramente diferente entre a Automação da Interface do Usuário e os modos de Acessibilidade Ativa da Microsoft.

Verificar informações da propriedade de acessibilidade

A exibição de dados mostra as informações de propriedade do elemento de interface do usuário que está selecionado no momento. Você pode configurar Inspeção para mostrar informações sobre todas as propriedades de acessibilidade ou um subconjunto dessas propriedades. Você também pode especificar outras opções de exibição, como se a janela Inspecionar permanece sobre outras interfaces do usuário ou se Inspecionar realça um retângulo delimitador ao redor do elemento selecionado.

Depois de configurar a Inspeção para funcionar da maneira desejada, comece a navegar entre os elementos da interface do usuário e exibir informações de propriedade. Inspeção salva as configurações quando ela fecha e as usa para inicializar sua próxima sessão inspecioná-las.

Para definir as configurações de propriedade, siga estas etapas:

  1. No menu opções de, selecione configurações deou selecione Mostrar de diálogo Configurações na barra de ferramentas.
  2. Na lista Exibir na Janela Principal, selecione as propriedades que você deseja exibir na exibição Dados da Inspeção.
  3. Na lista Exibir na Dica de Ferramenta de Informações, selecione as propriedades que você deseja exibir em uma dica de ferramenta.
  4. Para exibir propriedades que o elemento de interface do usuário pode não dar suporte, selecione Exibir propriedades sem suporte.
  5. Selecione OK para salvar suas alterações.

Para configurar as opções de exibição, você pode selecionar as seguintes opções de exibição no menu opções ou na barra de ferramentas.

Quando essa opção é selecionada Inspecione executa esta ação
Always on Top Aparece na parte superior de qualquer outra janela na tela.
Modo MSAA Exibe informações da propriedade Microsoft Active Accessibility.
Modo de automação da interface do usuário Exibe informações de propriedade da Automação da Interface do Usuário.
Exibição somente visível do Windows Disponível somente no modo MSAA.
Modo de Exibição Bruto Apresenta o modo de exibição bruto da árvore de Automação da Interface do Usuário ou da árvore MSAA no modo de exibição de árvore.
Modo de Exibição de Controle Apresenta a exibição de controle da árvore de Automação da Interface do Usuário no modo de exibição de árvore. Disponível somente no modo de Automação da Interface do Usuário.
Exibição de conteúdo Apresenta a exibição de conteúdo da árvore de Automação da Interface do Usuário no modo de exibição de árvore. Disponível somente no modo de Automação da Interface do Usuário
Barra de ferramentas de foco ativo Ativa os botões da barra de ferramentas no mouse, em vez de exigir um clique do mouse.
Bipe no erro Bipe quando um erro é detectado durante uma operação de Automação da Interface do Usuário ou MSAA.
Sinalizador de SPI_SCREENREADER Pressupõe que um leitor de tela esteja presente. Essa opção indica que um aplicativo deve fornecer informações textuamente em vez de graficamente. Você não deve assumir que esse sinalizador está definido simplesmente porque um leitor de tela está presente.
Mostrar Retângulo de Realce Realça um retângulo ao redor do elemento com foco.
Mostrar Realce do Cursor Realça o cursor. Disponível somente no modo MSAA.
Mostrar dica de ferramenta de informações Mostra informações de propriedade em uma dica de ferramenta.
Assista ao Foco Segue o foco do teclado. Quando selecionado, um gancho de evento de foco assíncrono é instalado e move o cursor para o canto superior esquerdo do elemento com o foco. Essa ação faz com que a Inspeção atualize suas propriedades em cerca de um segundo.
Assista a Caret Segue o cursor. Disponível somente no modo MSAA.
Cursor de inspeção Segue o cursor.
Dicas de ferramenta de inspeção Segue as dicas de ferramentas.
Mostrar Árvore Exibe o modo de exibição de árvore.

Verificar a navegação de acessibilidade

Depois de selecionar um elemento de interface do usuário usando Inspeção, você poderá validar se o elemento expõe a navegação correta da Automação do Windows para produtos de tecnologia adaptativa.

Para verificar a navegação de acessibilidade, siga estas etapas:

  1. Abra Inspeção e o aplicativo que você deseja testar.

  2. Selecione o elemento de interface do usuário do qual você deseja iniciar a navegação.

  3. Na exibição de dados, verifique se o elemento expõe as propriedades corretas relacionadas à navegação.

  4. Use o modo de exibição de árvore, o menu de Navegação ou os botões de navegação na barra de ferramentas para navegar na interface do usuário e verificar se cada elemento expõe as propriedades corretas relacionadas à navegação.

    Nota

    As opções de menu navegação do e os botões da barra de ferramentas de navegação mudam dependendo de onde o elemento selecionado está na árvore.

Interagir com elementos da interface do usuário

A Automação do Windows expõe métodos que permitem que produtos de tecnologia adaptativa interajam com um elemento de interface do usuário como se o mouse ou o teclado estivesse sendo usado, como pressionar um botão. O menu Inspecionar Ação permite que os testadores invoquem métodos de Automação do Windows em um elemento, como usar Invoke.Invoke para chamar o método IUIAutomationInvokePattern::Invoke.

Para interagir com elementos da interface do usuário, siga estas etapas:

  1. Abra Inspeção e o aplicativo que você deseja testar.
  2. Selecione o elemento de interface do usuário com o qual você deseja interagir.
  3. No menu da Ação ou na barra de ferramentas, selecione a ação que corresponde ao método de Automação do Windows que você deseja invocar.

O menu de Ação contém os itens de Atualização e Foco, juntamente com outros itens que variam dependendo de você selecionar o modo de Automação da Interface do Usuário ou o modo MSAA. No modo de Automação da Interface do Usuário, os outros itens refletem os padrões de controle compatíveis com o elemento de interface do usuário selecionado no momento. No modo MSAA, os outros itens sempre consistem nas seguintes ações:

Ação Descrição
Atualizar Atualiza a interface do usuário. Disponível no modo msaa e automação de interface do usuário.
Ação padrão Executa a ação padrão para o elemento.
Foco Define o foco no elemento. Disponível no modo msaa e automação de interface do usuário.
Selecionar Seleciona o elemento.
Estender Seleção Estende a seleção de elementos para incluir todos os elementos entre o primeiro elemento selecionado e o elemento atual.
Adicionar à Seleção Seleciona o elemento atual, como um item de lista.
Remover da Seleção Remove o elemento atual da seleção.
SetAccValue Define o valor de Acessibilidade Ativa da Microsoft do elemento como a cadeia de caracteres especificada.
Filho Focado Navega até o filho do elemento que atualmente tem foco.
HitTest no Cursor Navega até o filho do elemento especificado pelo cursor do mouse.
HitTest... Abre a caixa de diálogo HitTest.

Atalhos de teclado

Muitos dos itens de menu podem ser invocados com um atalho de teclado mesmo quando Inspeção não é o aplicativo ativo. As teclas de atalho podem entrar em conflito com alguns aplicativos.

As seguintes teclas de atalho de teclado ativam as várias opções no menu:

Para fazer essa opção Use este atalho de teclado
Invoque a ação padrão do objeto no cursor (Executar a ação padrão). Disponível somente no modo MSAA. Ctrl+Shift+F2
Selecione o objeto sob o cursor (Selecionar). Disponível somente no modo MSAA. Ctrl+Shift+F3
Defina o foco do teclado para o objeto sob o cursor (Focus). Ctrl+Shift+F4
Mova para o objeto irmão anterior do que está sob o cursor. Esse comando navega até objetos somente dentro de um contêiner (Anteriores). Ctrl+Shift+F5
Mover para o pai do objeto (pai). Ctrl+Shift+F6
Mover para o primeiro filho do objeto atual (First Child). Ctrl+Shift+F7
Mova para o próximo objeto irmão do que está sob o cursor. Esse comando navega até objetos somente dentro de um contêiner (Next Sibling). Ctrl+Shift+F8
Mover para o último filho do objeto atual (Last Child). Ctrl+Shift+F9
Mover para o objeto sob o cursor do mouse (HitTest no Cursor). Disponível somente no modo MSAA. Ctrl+Shift+1
Copie o conteúdo da exibição Dados para a área de transferência (Copiar Todos os). Ctrl+Shift+4
Atualize o conteúdo do modo de exibição de dados (Atualizar). Ctrl+Shift+5
Assista ao objeto que tem foco (Watch Focus). Ctrl+Shift+6
Mova-se para o objeto irmão à esquerda do que o cursor está sobre (à esquerda). Disponível somente no modo MSAA. Ctrl+Shift+7
Mova para o objeto irmão acima do objeto que o cursor acabou (Up). Disponível somente no modo MSAA. Ctrl+Shift+8
Mova-se para o objeto irmão abaixo do que o cursor está sobre (Para baixo). Disponível somente no modo MSAA. Ctrl+Shift+9
Mova-se para o objeto irmão à direita do cursor (direito). Disponível somente no modo MSAA. Ctrl+Shift+0

Consulte também