Caixa de listagem (referência de elemento de interface do usuário do MSAA)
Observação
Este tópico descreve objetos List Box para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos List Box em várias estruturas de interface do usuário não está descrito aqui. Consulte a documentação de referência de API para a estrutura de interface do usuário que você está usando.
As caixas de listagem exibem uma lista 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 dão suporte aos seguintes métodos IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | O objeto de caixa de listagem em si não tem uma propriedade DefaultAction ; no entanto, accDoDefaultAction clica duas vezes em itens de 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. |
| Acclocation | |
| Accnavigate | |
| Accselect |
Propriedades IAccessible
As caixas de listagem dão suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| 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 é "Double Click". |
| 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 nome de classe de janela 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 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: 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 |