Partilhar via

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

Observação

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

 

Uma caixa de combinação é uma caixa de listagem combinada com um controle estático ou um controle de edição que exibe o item atualmente selecionado 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 quando o usuário seleciona a seta suspensa (que é um botão de pressão) ao lado do controle. Se o campo de seleção for um controle de edição, o usuário pode 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 propriedadesIAccessibledepende de qual das seguintes partes da caixa de combinação é consultada 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 pressão)
  • A caixa de listagem
  • Os itens da lista na caixa de listagem

Métodos IAccessible

As caixas de combinação suportam os seguintes métodos IAccessible:

Propriedades IAccessible

As caixas de combinação suportam as seguintes propriedadesIAccessible:

  • get_accChild

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

    Parte da caixa de combinação Contagem de crianças
    Janela da caixa de combinação 3
    Editar controlo 0
    Seta suspensa 0
    Caixa de listagem O número de itens da 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
    Editar controlo 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 TecladoAtalho
    Janela da caixa de combinação Chave de acesso do rótulo associado
    Editar controlo Nenhum
    Seta suspensa "Alt+Seta para baixo"
    Caixa de listagem Nenhum
    Item de lista Nenhum

     

    A chave 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 Designação
    Janela da caixa de combinação Controle de texto estático usado como um rótulo
    Editar controlo 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 da 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 Nome para as duas caixas de combinação são "Examinar:" e "Arquivos do tipo:".

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

    Parte da caixa de combinação Pai
    Janela da caixa de combinação Uma janela com a propriedade Role de ROLE_SYSTEM_WINDOW que circunda a caixa de combinação e tem a mesma propriedade Name e nome da classe da janela que a caixa de combinação.
    Controle de edição (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. Esta janela rodeia 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 de edição (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
    Editar controlo 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
    Editar controlo 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 deveria retornar VT_EMPTY.

Interface IAccessible

 

 

  • Last updated on