<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="interface_viewer_plugin" xml:lang="pt_BR">
  <info>
    <link type="guide" xref="index#examining_a11y"/>
    <title type="sort">2. Plug-in Visão de interface</title>
    <link type="next" xref="validator_plugin"/>
    <desc>Examinando sua implementação de acessibilidade</desc>
    <credit type="author">
      <name>Eitan Isaacson</name>
      <email>eitan@ascender.com</email>
    </credit>
    <credit type="author">
      <name>Peter Parente</name>
      <email>pparent@us.ibm.com</email>
    </credit>
    <credit type="author">
      <name>Aline Bessa</name>
      <email>alibezz@gmail.com</email>
    </credit>
    <license>
      <p>Atribuição Compartilhada Igual 3.0 - Creative Commons</p>
    </license>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Enrico Nicoletto</mal:name>
      <mal:email>liverig@gmail.com</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Fabrício Godoy</mal:name>
      <mal:email>skarllot@gmail.com</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Leonardo Ferreira Fontenelle</mal:name>
      <mal:email>leonardof@gnome.org</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2025.</mal:years>
    </mal:credit>
  </info>
  <title>Plug-in Visão de interface</title>

  <p>O plug-in Visão de interface mostra as informações e os controles fornecidos pelas interfaces AT-SPI presentes em cada item acessível da <link xref="desktop_tree_view">Visão em Árvore de Aplicativos</link>. Após selecionar um item, você pode usar este plug-in para revisar rapidamente suas interfaces suportadas, para recuperar as informações de cada interface e para manipular o item por meio de todos os métodos da interface.</p>

  <figure>
    <title>Examinando um menu com o plug-in Visão de interface</title>
    <desc>Dado um item selecionado na Visão em Árvore de Aplicativos, todas as suas interfaces AT-SPI serão mostradas como sensíveis no plug-in Visão de interface. As que não são suportadas aparecerão acinzentadas, como as interfaces Application e Collection na figura acima.</desc>
    <media type="image" mime="image/png" width="800" height="450" src="figures/interface_viewer_plugin.png">
      <p>Dado um item selecionado na Visão em Árvore de Aplicativos, todas as suas interfaces AT-SPI serão mostradas como sensíveis no plug-in Visão de interface. As que não são suportadas aparecerão acinzentadas, como as interfaces Application e Collection na figura acima.</p>
    </media>
  </figure>

  <section id="running_interface_viewer">
    <title>Executando o plug-in Visão de interface</title>
    <p>O primeiro passo para executar o plug-in Visão de interface é selecionar um item na <link xref="desktop_tree_view">Visão em Árvore de Aplicativos</link>. Depois disso, todas as interfaces AT-SPI cobertas pelo plug-in serão listadas no painel do plug-in. As interfaces implementadas pelo item selecionado serão sensíveis, então você pode clicar em cada uma delas para recuperar suas informações fornecidas ou para interagir com métodos disponíveis. As seguintes interfaces podem ser exploradas no <app>Accerciser</app>, supondo que o item selecionado as implemente:</p>
    <list>
      <item>
        <p>Acessível - Esta interface mostra a contagem de filhos do item selecionado (número de widgets filhos), descrição, estados, relações e atributos.</p>
      </item>
      <item>
        <p>Ação - Esta interface mostra todas as ações que podem ser executadas pelo item selecionado. Para cada interface, você verá seu nome, como "press" ou "click", seguido por uma descrição e uma combinação de teclas, se houver alguma. Se você selecionar uma ação, um botão "Executar ação" ficará sensível. Pressione este botão para ver o item executando a ação selecionada.</p>
      </item>
      <item>
        <p>Aplicativo - Esta interface pode ser implementada por itens com a função "application". Vale ressaltar que itens com a função "application" não necessariamente implementam esta interface. Se o item selecionado a implementa, a interface mostrará seu ID e, se houver, seu toolkit e versão.</p>
      </item>
      <item>
        <p>Componente - Esta interface mostra a posição absoluta do item selecionado (em relação ao sistema de coordenadas da área de trabalho), a posição relativa (em relação ao sistema de coordenadas da janela), o tamanho, o tipo de camada, a ordem MDI-Z (um número inteiro curto que indica a ordem de empilhamento do componente na camada MDI) e o alfa (se a combinação alfa for usada).</p>
      </item>
      <item>
        <p>Documento - Esta interface mostra os atributos do documento do item selecionado e a descrição do local, se houver.</p>
      </item>
      <item>
        <p>Hipertexto - Esta interface mostra uma lista com todos os hiperlinks de hipertexto do item selecionado. Para cada hiperlink, a interface fornece seu nome, URI, início (o índice no hipertexto no qual o hiperlink começa) e fim (o índice no hipertexto no qual este hiperlink termina).</p>
      </item>
      <item>
        <p>Imagem - Esta interface mostra a descrição do item selecionado (ou "sem descrição" se não for especificado), tamanho, posição (em relação ao sistema de coordenadas da área de trabalho) e localidade, se houver.</p>
      </item>
      <item>
        <p>Seleção - Esta interface mostra todos os itens filhos selecionáveis ​​do item selecionado. Se o item selecionado for uma barra de menu com as opções "Arquivo", "Editar", "Ver" e "Ajuda", e todas elas forem selecionáveis, então elas serão listadas nesta interface. Se você clicar em uma opção listada - "Arquivo", por exemplo - e quiser limpá-la, basta pressionar o botão "Limpar" abaixo da lista.</p>
      </item>
      <item>
        <p>Conteúdo em fluxo - Esta interface mostra os tipos de conteúdo do item selecionado e seus URIs correspondentes.</p>
      </item>
      <item>
        <p>Tabela - Esta interface mostra a legenda e o resumo do item selecionado, linhas (número de linhas), colunas (número de colunas), linhas selecionadas (número de linhas selecionadas) e colunas selecionadas (número de colunas selecionadas). Para uma célula selecionada, a interface mostra o cabeçalho e as extensões de suas linhas e colunas.</p>
      </item>
      <item>
        <p>Célula da tabela - Esta interface mostra o índice de linha e coluna do item selecionado, intervalo de linha e coluna, uma lista de células de cabeçalho de linha e coluna e a tabela da célula. Selecionando uma célula de cabeçalho na lista de cabeçalhos de linha ou coluna e pressionando o botão "Mostrar", é possível selecionar esse objeto de célula de cabeçalho no Accerciser. Pressionar o botão da tabela faz com que o objeto tabela seja selecionado.</p>
      </item>
      <item>
        <p>Texto - Esta interface mostra o conteúdo de texto do item selecionado, que pode ser editável, e seus atributos. Os atributos básicos são offset (o número de caracteres que o texto tem) e justificação. Para ver possíveis atributos CSS, clique na caixa de seleção "Incluir padrões".</p>
      </item>
      <item>
        <p>Valor - Esta interface mostra o valor atual do item selecionado, o valor mínimo permitido, o valor máximo permitido e o incremento mínimo pelo qual o valor pode ser alterado (ou zero se este valor não puder ser determinado). O valor atual pode ser alterado manualmente por meio de um botão de rotação.</p>
      </item> 
    </list>
  </section>
</page>
