Compartilhar via


Caixa de listagem (referência de elemento da interface do usuário do MSAA)

Nota

Este tópico descreve list box objetos para fins de referência de elemento de interface do usuário do MSAA. Como criar List Box 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 de interface do usuário que você está usando.

As caixas de listagem exibem uma lista na qual um usuário pode selecionar um ou mais itens. Uma caixa de listagem é criada com uma barra de rolagem vertical, uma barra de controle horizontal ou ambas.

O nome da classe de janela para uma caixa de listagem é "LISTBOX".

Métodos IAccessible

As caixas de listagem dão suporte aos seguintes métodos deIAccessible:

Método Comentários
accDoDefaultAction O objeto da caixa de listagem em si não tem uma propriedade DefaultAction; no entanto, accDoDefaultAction itens de caixa de listagem de cliques duplos.
accHitTest O método accHitTest retornará zero se o ponto testado estiver dentro da caixa de listagem, mas não em um item na caixa de listagem. Se o ponto testado estiver em um item na caixa de listagem, accHitTest retornará o índice do item da caixa de listagem.
accLocation
accNavigate
accSelect

Propriedades IAccessible

As caixas de listagem dão suporte às seguintes propriedades deIAccessible:

Propriedade Comentários
get_accChild A propriedade ChildCount é o número de itens na caixa de listagem.
get_accDefaultAction O objeto da caixa de listagem em si não tem uma propriedade DefaultAction; no entanto, a propriedade DefaultAction para cada item de lista é "Clique Duplo".
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut A propriedade KeyboardShortcut é a tecla de acesso da caixa de listagem, que é um caractere sublinhado no texto do rótulo associado à caixa de listagem. A cadeia de caracteres retornada contém o caractere de chave de acesso acrescentado à cadeia de caracteres "Alt+".
get_accName A propriedade Name do objeto de caixa de listagem é o texto de um controle de texto estático que rotula a caixa de listagem. Para os itens da caixa de listagem, a propriedade Name é o texto do item de lista.
get_accParent A propriedade Parent é uma janela (ROLE_SYSTEM_WINDOW) que envolve a caixa de listagem e tem a mesma propriedade Name e o nome da classe de janela que a caixa de listagem. A propriedade Pai dos itens da caixa de listagem é o objeto da caixa de listagem.
get_accRole A propriedade Role é ROLE_SYSTEM_LIST. Os itens na caixa de listagem têm a propriedade Role de ROLE_SYSTEM_LISTITEM.
get_accSelection A propriedade Selection recupera os itens selecionados na caixa de listagem.
get_accState A propriedade State do objeto de caixa de listagem é 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 do item da caixa de listagem é uma combinação de um ou mais dos seguintes valores:
STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL

interface IAccessible

caixa de combinação

barra de rolagem