Controle de exibição de árvore (referência de elemento da interface do usuário do MSAA)
Observação
Este tópico descreve objetos de Controle de Exibição de Árvore para fins de Referência de Elemento de Interface do Usuário do MSAA. Como criar objetos de Controle de Exibição de Árvore 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 de interface do usuário que você está usando.
Um controle de exibição de á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 de árvore dá suporte aos seguintes métodos IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | O próprio objeto de exibição de árvore não tem um método accDoDefaultAction . Dependendo da propriedade State de um item no modo de exibição de árvore, accDoDefaultAction expande ou recolhe o item especificado. |
| Acchittest | |
| Acclocation | |
| Accnavigate | |
| Accselect |
Propriedades IAccessible
Um controle de exibição de árvore dá suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChild | |
| get_accChildCount | A propriedade ChildCount para o objeto de exibição de árvore é o número de itens contidos no modo de exibição de árvore. A propriedade ChildCount para cada item de exibição de árvore é zero. |
| get_accDefaultAction | O próprio objeto de exibição de árvore não tem uma propriedade DefaultAction . Um item na exibição de árvore que é expandido tem "Collapse" como sua propriedade DefaultAction e um item que não é expandido tem "Expand" como sua propriedade DefaultAction . |
| 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 de árvore, portanto, os desenvolvedores de servidores devem fornecer texto significativo na instrução de definição de recursos do controle para ajudar os usuários de utilitários cliente a identificar o controle. A propriedade Name de 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 a mesma propriedade Name e o nome da classe de janela 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 RoleROLE_SYSTEM_OUTLINEITEM. |
| Get_accselection | |
| Get_accstate | A propriedade State para a exibição de árvore é uma combinação de um ou mais dos seguintes valores: 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 "Desktop" tem uma propriedade Value de "0"; o item "Meu Computador", que está no próximo nível na hierarquia, tem uma propriedade Value de "1"; e cada uma das unidades de disco, que estão no próximo nível na hierarquia, tem uma propriedade Value de "2". |
Observações
A propriedade accLocation dos itens de exibição de árvore retorna o local somente do texto no item. As coordenadas retornadas por accLocation para itens de exibição de árvore não incluem o ícone localizado à esquerda do texto.