Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Importante
O Inspect é uma ferramenta legada. Em vez disso, recomendamos Insights de Acessibilidade.
Inspect (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 as propriedades e padrões de controle da Microsoft UI Automation e as propriedades do Microsoft Ative Accessibility (MSAA). O Inspect 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 do Microsoft Ative Accessibility.
Requerimentos
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 Requisitos.
O Inspect é instalado como uma das ferramentas do Windows Software Development Kit (SDK), que inclui todas as ferramentas relacionadas à acessibilidade documentadas nesta seção. Inspect não é distribuído como um download separado.
Observação
Para versões mais antigas do SDK do Windows, consulte o SDK do Windows e o arquivo morto do emulador.
Inspect.exe está localizado na \bin\<versão>\<plataforma> pasta do caminho de instalação do SDK. Normalmente, você não precisa executá-lo como administrador.
A janela Inspecionar
A janela Inspecionar 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.
- Vista em árvore. Apresenta a estrutura hierárquica dos elementos da interface do usuário como um controle de exibição em árvore que você pode usar para navegar entre os elementos.
- Visualização de dados. Exibe todas as propriedades de acessibilidade expostas para o elemento da 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 de Automação da Interface do Usuário do elemento de menu Editar no Bloco de Notas.
Usando o Inspect
Quando você inicia Inspecionar, a exibição em árvore mostra o local do elemento da interface do usuário selecionado atualmente na hierarquia de elementos, enquanto a exibição de dados mostra as informações de propriedade do elemento da interface do usuário selecionado. Você pode navegar na interface do usuário para exibir informações de acessibilidade sobre cada elemento na interface do usuário. Por padrão, Inspecionar rastreia o foco do teclado ou do mouse. À medida que 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 rato.
- O teclado.
- O controle de exibição de árvore na exibição de árvore.
- As opções de navegação no menu Navegação.
- As opções de navegação na barra de ferramentas.
As três últimas opções permitem que você navegue pela hierarquia de árvore da interface do usuário. A estrutura dessa árvore pode diferir ligeiramente entre os modos de Automação da Interface do Usuário e Microsoft Ative Accessibility.
Verificar informações de propriedade de acessibilidade
A exibição de dados mostra as informações de propriedade do elemento da interface do usuário que está selecionado no momento. Você pode configurar Inspecionar para mostrar informações sobre todas as propriedades de acessibilidade ou um subconjunto dessas propriedades. Você também pode especificar outras opções de visualizaçã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 o recurso Inspecionar para funcionar da maneira desejada, comece a navegar entre os elementos da interface do usuário e a exibir as informações da propriedade. Inspecionar salva suas definições de configuração quando fecha e as usa para inicializar sua próxima sessão de Inspecionar.
Para definir as definições de propriedade, siga estes passos:
- No menu Opções, selecione Configuraçõesou selecione Mostrar caixa de diálogo Configurações na barra de ferramentas.
- Na lista Exibir na Janela Principal, selecione as propriedades que deseja exibir na visualização Dados de Inspecionar.
- Na lista Exibir na dica de ferramenta de informações, selecione as propriedades que deseja exibir em uma dica de ferramenta.
- Para exibir as propriedades que o elemento da interface do usuário pode não suportar, selecione Exibir propriedades sem suporte .
- Selecione OK para salvar as alterações.
Para configurar as opções de visualização, pode selecionar as seguintes opções de visualização no menu Opções de ou na barra de ferramentas.
| Quando esta opção é selecionada | Inspecionar executa esta ação |
|---|---|
| Sempre no topo | Aparece na parte superior de qualquer outra janela na tela. |
| Modo MSAA | Exibe informações de propriedade do Microsoft Ative Accessibility. |
| Modo de automação da interface do usuário | Exibe informações de propriedade de Automação da Interface do Usuário. |
| Vista visível apenas do Windows | Disponível apenas no modo MSAA. |
| Vista bruta | Apresenta a de exibição bruta da árvore de Automação da Interface do Usuário ou da árvore MSAA na exibição em árvore. |
| Vista de Controlo | Apresenta a de exibição de controle de da árvore de Automação da Interface do Usuário na exibição em árvore. Disponível apenas no modo de automação da interface do usuário. |
| Visualização de conteúdo | Apresenta o de exibição de conteúdo da árvore de Automação da Interface do Usuário no modo de exibição de árvore. Disponível apenas no modo de automação da interface do usuário |
| Barra de ferramentas Ative Hover | Ativa os botões da barra de ferramentas ao passar o mouse, em vez de exigir um clique do mouse. |
| Bipe no erro | Bipe quando um erro é detetado durante uma operação de automação da interface do usuário ou MSAA. |
| SPI_SCREENREADER Bandeira | Assume que um leitor de tela está presente. Esta opção indica que uma aplicação deve fornecer informações textualmente 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 | Destaca um retângulo em torno do elemento com foco. |
| Mostrar Destaque Caret | Destaca o acento circunflexo. Disponível apenas no modo MSAA. |
| Mostrar dica de ferramenta de informações | Mostra as informações da propriedade em uma dica de ferramenta. |
| Assista ao Focus | 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 Inspect atualize suas propriedades em cerca de um segundo. |
| Assista Caret | Segue o acento circunflexo. Disponível apenas no modo MSAA. |
| Cursor do relógio | Segue o cursor. |
| Ver Dicas de Ferramentas | Segue as dicas de ferramentas. |
| Mostrar árvore | Exibe a visualização em árvore. |
Verificar a navegação de acessibilidade
Depois de selecionar um elemento da interface do usuário usando Inspecionar, você pode validar se o elemento expõe a navegação correta da Automação do Windows para produtos de tecnologia assistiva.
Para verificar a navegação de acessibilidade, siga estas etapas:
Abra Inspecionar e o aplicativo que você deseja testar.
Selecione o elemento da interface do usuário a partir do qual você deseja iniciar a navegação.
Na visualização de dados, verifique se o elemento expõe as propriedades corretas relacionadas à navegação.
Use o modo de exibição em árvore, o menu 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.
Observação
As opções do menu Navegação 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 assistiva interajam com um elemento da interface do usuário como se o mouse ou teclado estivessem sendo usados, como pressionar um botão. O menu Inspect Action permite que os testadores invoquem métodos de automação do Windows em um elemento , como usar Invoke.Invoke para chamar o IUIAutomationInvokePattern::Invoke método.
Para interagir com elementos da interface do usuário, siga estas etapas:
- Abra Inspecionar e o aplicativo que você deseja testar.
- Selecione o elemento da interface do usuário com o qual você deseja interagir.
- No menu Action 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 Refresh e Focus, além de outros itens que variam dependendo se 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 suportados pelo elemento da 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 UI Automation. |
| Ação padrão | Executa a ação padrão para o elemento . |
| Em foco | Define o foco no elemento. Disponível no modo MSAA e UI Automation. |
| Selecione | 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 Microsoft Ative Accessibility do elemento para a cadeia de caracteres especificada. |
| Criança Focada | Navega para 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 Inspect 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 esta opção | Use este atalho de teclado |
|---|---|
| Invoque a ação padrão do objeto sob o cursor (Do Default Action). Disponível apenas no modo MSAA. | Ctrl+Shift+F2 |
| Selecione o objeto sob o cursor (Selecione). Disponível apenas no modo MSAA. | Ctrl+Shift+F3 |
| Defina o foco do teclado para o objeto sob o cursor (Foco). | Ctrl+Shift+F4 |
| Mover para o objeto irmão anterior do objeto sob o cursor. Este comando navega para objetos somente dentro de um contêiner (Previous Sibling). | Ctrl+Shift+F5 |
| Mover para o pai do objeto (pai ). | Ctrl+Shift+F6 |
| Mover para o primeiro filho do objeto atual (Primeiro filho). | Ctrl+Shift+F7 |
| Mover para o próximo objeto irmão a partir do objeto sob o cursor. Este comando navega para 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 |
| Mova para o objeto sob o cursor do mouse (HitTest no Cursor). Disponível apenas no modo MSAA. | Ctrl+Shift+1 |
| Copie o conteúdo da visualização Dados para a área de transferência (Copiar todos os). | Ctrl+Shift+4 |
| Atualize o conteúdo da visualização Dados (Atualizar). | Ctrl+Shift+5 |
| Observe o objeto que tem foco (Watch Focus). | Ctrl+Shift+6 |
| Mover para o objeto irmão à esquerda daquele sobre o qual o cursor está (Esquerda). Disponível apenas no modo MSAA. | Ctrl+Shift+7 |
| Mover para o objeto irmão acima do objeto sobre o qual o cursor está (Up). Disponível apenas no modo MSAA. | Ctrl+Shift+8 |
| Mova para o objeto irmão abaixo daquele sobre o qual o cursor está (Down). Disponível apenas no modo MSAA. | Ctrl+Shift+9 |
| Mover para o objeto irmão à direita daquele sobre o qual o cursor está (Direito). Disponível apenas no modo MSAA. | Ctrl+Shift+0 |