Compartilhar via

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

Nota

Este tópico descreve caixa de combinação objetos para fins de referência de elemento de interface do usuário do MSAA. Como criar caixa de combinação 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.

 

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 em todos os momentos ou somente suspensa quando o usuário seleciona a seta suspensa (que é um botão de push) 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 deIAccessible dodepende de quais das seguintes partes da caixa de combinação são consultadas pelo cliente:

  • A janela caixa de combinação
  • O controle de edição ou controle de texto estático
  • A seta suspensa (que é um botão de push)
  • 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 deIAccessible:

  • accDoDefaultAction
  • accHitTest
  • accLocation
  • accNavigate
  • accSelect

Propriedades IAccessible

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

  • 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 caixa de combinação 3
    Editar controle 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 caixa de combinação Nenhum
    Editar controle 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 caixa de combinação Chave de acesso do rótulo associado
    Editar controle 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 Nome
    Janela caixa de combinação Controle de texto estático usado como um rótulo
    Editar controle 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 "Pesquisar:" 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 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 o nome da classe de janela que a caixa de combinação.
    Editar controle (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 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 de função
    Janela caixa de combinação ROLE_SYSTEM_COMBOBOX
    Editar controle (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 Possíveis estados
    Janela 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 controle 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 caixa de combinação Texto do item de lista selecionado no momento
    Editar controle Texto do item de lista selecionado no momento
    Seta suspensa Nenhum
    Caixa de listagem Nenhum
    Item de lista Nenhum

     

Anotações

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

interface IAccessible