Partilhar via


Controle de exibição em árvore (referência de elemento da interface do usuário do MSAA)

Observação

Este tópico descreve controle de exibição de árvore objetos para fins de referência de elemento da interface do usuário do MSAA. Como criar controle de exibição de árvore objetos em várias estruturas de interface do usuário não é descrito aqui. Consulte a documentação de referência da API para a estrutura da interface do usuário que você está usando.

Um controle de exibição em árvore exibe uma lista hierárquica de itens usando linhas para conectar itens relacionados em uma hierarquia. Cada item consiste em um rótulo e um bitmap opcional. O Windows Explorer usa um controle de exibição de árvore para exibir diretórios.

O nome da classe de janela para um controle de exibição de árvore é WC_TREEVIEW, que é definido como "SysTreeView" em Commctrl.h.

Métodos IAccessible

Um controle de exibição em árvore suporta os seguintes métodosIAccessible:

Método Observações
accDoDefaultAction O objeto de exibição de árvore em si não tem um método deaccDoDefaultAction. Dependendo da propriedade State de um item na exibição em árvore, accDoDefaultAction expande ou recolhe o item especificado.
accHitTest
accLocalização
accNavigate
accSelecione

Propriedades IAccessible

Um controle de exibição de árvore suporta as seguintes propriedades deIAccessible:

Propriedade Observações
get_accChild
get_accChildCount A propriedade ChildCount para o objeto de exibição de árvore é o número de itens contidos na exibição de árvore. A propriedade ChildCount para cada item de exibição de árvore é zero.
get_accDefaultAction O objeto de exibição de árvore em si não tem uma propriedade DefaultAction. Um item no modo de exibição de árvore que é expandido tem "Collapse" como sua propriedade DefaultAction e um item que não é expandido tem "Expand" como sua DefaultAction propriedade.
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName A propriedade Name para o objeto de exibição de árvore é obtida do texto da janela do controle (ou legenda). Esse texto não é exibido com o controle de exibição em árvore, portanto, os desenvolvedores de servidor devem fornecer texto significativo na instrução de definição de recursos do controle para ajudar os usuários de utilitários de cliente a identificar o controle. A propriedade Name para um item no modo de exibição de árvore é o texto exibido no item de exibição de árvore.
get_accParent A propriedade Parent do objeto de exibição de árvore é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve o controle e tem o mesmo nome Name propriedade e nome da classe window que o controle. A propriedade Parent de cada item no modo de exibição de árvore é o objeto de exibição de árvore.
get_accRole O objeto de exibição de árvore tem a propriedade RoleROLE_SYSTEM_OUTLINE. Cada item no modo de exibição de árvore tem a propriedade FunçãoROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState A propriedade State para o modo de exibição em árvore é uma combinação de um ou mais dos seguintes valores de : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
Para os itens de exibição de árvore, a propriedade State inclui STATE_SYSTEM_EXPANDED ou STATE_SYSTEM_COLLAPSED.
Os valores possíveis adicionais para a propriedade State incluem:
STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue O objeto de exibição de árvore não tem um valor. A propriedade Value para cada item de exibição de árvore é o nível de recuo do item na hierarquia. Por exemplo, no Windows Explorer, o item "Área de trabalho" tem um valor propriedade de "0"; o item "Meu Computador", que está no próximo nível na hierarquia, tem um valor propriedade de "1"; e cada uma das unidades de disco, que estão no próximo nível na hierarquia, têm uma propriedade Value de "2".

Observações

A propriedade accLocation dos itens de exibição em árvore retorna o local somente do texto no item. As coordenadas retornadas por accLocation para itens de exibição em árvore não incluem o ícone localizado à esquerda do texto.

Interface IAccessible