Compartilhar via

Caixa de combinação (Referência de elemento de interface do usuário do MSAA)

  • Artigo

Observação

Este tópico descreve objetos Combo Box para fins de Referência de Elemento de Interface do Usuário do MSAA. Como criar objetos Combo 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.

 

Uma caixa de combinação é uma caixa de listagem combinada a um controle estático ou um controle de edição que exibe o item selecionado no momento na parte da caixa de listagem da caixa de combinação. A parte da caixa de listagem do controle é exibida o tempo todo ou somente suspensa quando o usuário seleciona a seta suspensa (que é um botão de ação) ao lado do controle. Se o campo de seleção for um controle de edição, o usuário poderá inserir informações que não estão na lista; caso contrário, o usuário só pode selecionar itens na lista.

O nome da classe de janela para uma caixa de combinação é "COMBOBOX".

O conteúdo das propriedades IAccessible depende de quais das seguintes partes da caixa de combinação são consultadas pelo cliente:

  • A janela da caixa de combinação
  • O controle de edição ou controle de texto estático
  • A seta suspensa (que é um botão de ação)
  • A caixa de listagem
  • Os itens de lista na caixa de listagem

Métodos IAccessible

As caixas de combinação dão suporte aos seguintes métodos IAccessible :

Propriedades IAccessible

As caixas de combinação dão suporte às seguintes propriedades IAccessible :

  • get_accChild

  • get_accChildCount — A tabela a seguir mostra o valor da contagem filho para diferentes partes da caixa de combinação.

    Parte da caixa de combinação ChildCount
    Janela da caixa de combinação 3
    Controle de edição 0
    Seta suspensa 0
    Caixa de listagem O número de itens de lista
    Item de lista 0

     

  • get_accDefaultAction — A tabela a seguir mostra a propriedade DefaultAction para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Defaultaction
    Janela da caixa de combinação Nenhum
    Controle de edição Nenhum
    Seta suspensa "Abrir" ou "Fechar" dependendo do estado da lista suspensa
    Caixa de listagem Nenhum
    Item de lista "Clique duas vezes"

     

  • get_accDescription

  • Get_accfocus

  • get_accHelp

  • get_accHelpTopic

  • get_accKeyboardShortcut — A tabela a seguir mostra a propriedade KeyboardShortcut para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação KeyboardShortcut
    Janela da caixa de combinação Chave de acesso do rótulo associado
    Controle de edição Nenhum
    Seta suspensa "Alt+Seta para baixo"
    Caixa de listagem Nenhum
    Item de lista Nenhum

     

    A tecla de acesso para uma caixa de combinação é o caractere sublinhado no texto de um controle de texto estático associado que rotula a caixa de combinação. Por exemplo, em uma caixa de diálogo Abrir padrão que abre arquivos, como no Microsoft WordPad, a caixa de combinação rotulada "Arquivos do tipo:" tem o KeyboardShortcut "Alt+t".

  • get_accName — A tabela a seguir mostra a propriedade Name para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Nome
    Janela da caixa de combinação Controle de texto estático usado como um rótulo
    Controle de edição Controle de texto estático usado como um rótulo
    Seta suspensa "Abrir" ou "Fechar" dependendo do estado da lista suspensa
    Caixa de listagem Rótulo associado
    Item de lista Texto do item de lista

     

    A propriedade Name de uma caixa de combinação, seu controle de edição filho e sua caixa de listagem filho é o texto de um controle de texto estático associado que rotula a caixa de combinação. Por exemplo, em uma caixa de diálogo Abrir padrão que abre arquivos, como no WordPad, as propriedades Name para as duas caixas de combinação são "Look in:" e "Files of type:".

  • get_accParent — A tabela a seguir mostra o valor pai de diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Parent
    Janela da caixa de combinação Uma janela com a propriedade Role de ROLE_SYSTEM_WINDOW que envolve a caixa de combinação e tem a mesma propriedade Name e nome da classe de janela que a caixa de combinação.
    Controle editar (ou controle de texto estático) A janela da caixa de combinação.
    Seta suspensa A janela da caixa de combinação.
    Janela pai da caixa de listagem A janela da caixa de combinação. Essa janela envolve a caixa de listagem.
    Caixa de listagem A janela pai da caixa de listagem.
    Item de lista A caixa de listagem.

     

  • get_accRole — A tabela a seguir mostra a propriedade Role para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Função
    Janela da caixa de combinação ROLE_SYSTEM_COMBOBOX
    Controle editar (ou controle de texto estático) ROLE_SYSTEM_TEXT ou ROLE_SYSTEM_STATICTEXT
    Seta suspensa ROLE_SYSTEM_PUSHBUTTON
    Caixa de listagem ROLE_SYSTEM_LIST
    Item de lista ROLE_SYSTEM_LISTITEM

     

  • get_accState — A tabela a seguir mostra a propriedade State para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Estados possíveis
    Janela da caixa de combinação | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDED STATE_SYSTEM_COLLAPSED
    Controle de edição | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_NORMAL
    Seta suspensa 0, o que significa que o botão está visível e não pressionado; ou STATE_SYSTEM_PRESSED | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_NORMAL
    Caixa de listagem | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATING STATE_SYSTEM_NORMAL
    Item de lista | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_NORMAL

     

  • get_accValue — A tabela a seguir mostra a propriedade Value para diferentes partes de uma caixa de combinação.

    Parte da caixa de combinação Valor
    Janela da caixa de combinação Texto do item de lista selecionado no momento
    Controle de edição Texto do item de lista selecionado no momento
    Seta suspensa Nenhum
    Caixa de listagem Nenhum
    Item de lista Nenhum

     

Observações

  • Quando accNavigate é chamado com o sinalizador NAVDIR_NEXT na parte da caixa de listagem de uma caixa de combinação, ele navega incorretamente para a janela da bandeja quando deve retornar VT_EMPTY.

IAccessible Interface