Partilhar via


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

Observação

Este tópico descreve objetos Caixa de Lista para fins de Referência de Elemento da Interface do Usuário do MSAA. Como criar caixa de listagem 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 da interface do usuário que você está usando.

As caixas de listagem exibem uma lista a partir da 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 suportam os seguintes métodos IAccessible:

Método Observações
accDoDefaultAction O objeto de caixa de listagem em si não tem uma propriedade DefaultAction; no entanto, accDoDefaultAction clica duas vezes em itens da caixa de listagem.
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.
accLocalização
accNavigate
accSelecione

Propriedades IAccessible

As caixas de listagem suportam as seguintes propriedadesIAccessible:

Propriedade Observações
get_accChild A propriedade ChildCount é o número de itens na caixa de listagem.
get_accDefaultAction O objeto de caixa de listagem em si não tem uma propriedade DefaultAction; no entanto, a propriedade DefaultAction para cada item de lista é "Clique duas vezes".
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut A propriedade KeyboardShortcut é a tecla de acesso à 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 anexado à cadeia de caracteres "Alt+".
get_accName A propriedade Name para o 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 Nome é o texto do item de lista.
get_accParent A propriedade Parent é uma janela ( ROLE_SYSTEM_WINDOW ) que circunda a caixa de listagem e tem a mesma propriedade Name e window class name que a caixa de listagem. A propriedade Parent 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 Seleção 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 de 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