controle List-View (referência de elemento de interface do usuário do MSAA)
Observação
Este tópico descreve objetos de controle de exibição de lista para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos de Controle de Exibição de Lista 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 lista exibe uma coleção de itens, cada um consistindo em um ícone e um rótulo, e fornece várias maneiras de exibir e organizar os itens. Por exemplo, informações adicionais sobre cada item são exibidas em colunas à direita do ícone e do rótulo. O Windows Explorer usa um controle de exibição de lista para exibir arquivos.
O nome da classe de janela para um controle de exibição de lista é WC_LISTVIEW, que é definido como "SysListView" em Commctrl.h.
Métodos IAccessible
Um controle de exibição de lista dá suporte aos seguintes métodos IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | O objeto de exibição de lista em si não tem uma propriedade DefaultAction ; no entanto, o método accDoDefaultAction clica duas vezes em itens de exibição de lista. |
| Acchittest | |
| Acclocation | |
| Accnavigate | |
| Accselect |
Propriedades IAccessible
Um controle de exibição de lista dá suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChild | |
| get_accChildCount | A propriedade ChildCount é o número de itens na lista. |
| get_accDefaultAction | O objeto de exibição de lista em si não tem uma propriedade DefaultAction ; no entanto, a propriedade DefaultAction para cada item de exibição de lista é "Clique duplo". |
| get_accDescription | O objeto list-view em si não dá suporte à propriedade Description ; no entanto, a propriedade Description para cada item de exibição de lista é o texto contido nas segundas e subsequentes colunas do item. Uma vírgula é inserida entre o texto de cada coluna. |
| Get_accfocus | |
| get_accHelp | |
| get_accHelpTopic | |
| Get_acckeyboardshortcut | Os objetos de exibição de lista não têm atalhos de teclado. No entanto, se o texto da janela do controle list-view contiver um caractere e comercial (&), a Acessibilidade Ativa da Microsoft retornará uma cadeia de caracteres não Null como a propriedade KeyboardShortcut . |
| Get_accname | O Nome do objeto de exibição de lista é obtido do texto da janela do controle (ou legenda). Esse texto não é exibido com o controle de exibição de lista, 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. Para os itens de exibição de lista, a propriedade Name é o texto do item de lista. |
| get_accParent | O Pai do objeto list-view é 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 dos itens de exibição de lista é o objeto list-view. |
| Get_accrole | A Função de ROLE_SYSTEM_LIST e cada item no controle de exibição de lista tem a propriedade Role de ROLE_SYSTEM_LISTITEM. |
| Get_accselection | |
| Get_accstate | A propriedade State do objeto list-view é uma combinação de um ou mais dos seguintes valores: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN A propriedade State dos itens de exibição de lista é uma combinação de um ou mais dos seguintes valores: | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL Além disso, marcar itens de exibição de lista de caixas também têm o estado STATE_SYSTEM_CHECKED. |
Observações
- A Acessibilidade Ativa da Microsoft não expõe o texto do item de exibição de lista em aplicativos que usam uma função de retorno de chamada para adicionar o texto ao item.
- Os itens de exibição de lista que são recortados não têm STATE_SYSTEM_INVISIBLE definido. Para determinar se um item de lista é recortado, os clientes podem comparar as coordenadas do item retornadas por accLocation com a região de recorte da janela.
- A Acessibilidade Ativa da Microsoft não dá suporte ao uso do método accNavigate para navegar até o controle de cabeçalho dentro de um controle de exibição de lista que está na exibição Detalhes. No entanto, os clientes usam a função AccessibleObjectFromPoint para acessar o controle de cabeçalho.
- Para objetos não retangulares, como itens de exibição de lista na exibição Detalhes, as coordenadas do retângulo delimitador do item recuperadas por accLocation falham se testadas com accHitTest porque accHitTest determina os limites do objeto em uma base pixel a pixel.