Partilhar via

Controle de List-View (Referência de elemento da interface do usuário do MSAA)

Observação

Este tópico descreve List-View objetos de de controle para fins de referência de elemento da interface do usuário do MSAA. Como criar List-View objetos de de controle 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 de lista exibe uma coleção de itens, cada um consistindo de 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 suporta os seguintes IAccessible métodos:

Método Observações
accDoDefaultAction O objeto de exibição de lista em si não tem uma propriedade DefaultAction; no entanto, o métodoaccDoDefaultActionclica duas vezes em itens de exibição de lista.
accHitTest
accLocalização
accNavigate
accSelecione

Propriedades IAccessible

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

Propriedade Observações
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 duas vezes".
get_accDescription O objeto list-view em si não suporta a propriedade Description; no entanto, a propriedade Description para cada item de exibição de lista é o texto contido na segunda coluna e nas colunas subsequentes 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 comercial (&), o Microsoft Ative Accessibility retornará uma cadeia de caracteres não Nula como a propriedade KeyboardShortcut.
get_accName O Nome 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 de 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 de exibição de lista é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve o controle e tem o mesmo nome Name propriedade e nome de 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 : 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 da caixa de seleção também têm o estado STATE_SYSTEM_CHECKED.

Observações

  • O Microsoft Ative Accessibility 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 cortados não têm STATE_SYSTEM_INVISIBLE definido. Para determinar se um item de lista é cortado, os clientes podem comparar as coordenadas do item retornadas por accLocation com a região de recorte da janela.
  • O Microsoft Ative Accessibility não oferece 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á no modo de exibição Detalhes. No entanto, os clientes usam a funçãoAccessibleObjectFromPoint para chegar ao controle de cabeçalho.
  • Para objetos não retangulares, como itens de exibição de lista na visualização Detalhes, as coordenadas do retângulo delimitador do item recuperadas por accLocation falhar se testadas com accHitTest porque accHitTest determina os limites do objeto pixel a pixel.

Interface IAccessible

  • Last updated on