controle List-View (referência de elemento da interface do usuário do MSAA)
Nota
Este tópico descreve objetos List-View Control para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos List-View Control 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 deIAccessible:
| 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 deIAccessible:
| 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 colunas segunda e subsequente 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 para o controle de exibição de lista contiver um caractere de e comercial (&), a Acessibilidade Ativa da Microsoft retornará uma cadeia de caracteres não Null como a propriedade KeyboardShortcut. |
| get_accName | O Name para o 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 servidor 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 o mesmo nome nome e o nome da classe de janela que o controle. A propriedade Parent dos itens de exibição de lista é o objeto de exibição de lista. |
| get_accRole | A função de ROLE_SYSTEM_LISTe 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 de : 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, os itens de exibição de lista de caixas de seleção também têm o estado STATE_SYSTEM_CHECKED. |
Anotaçõ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.