Partilhar via


Controle da barra de ferramentas (referência do elemento da interface do usuário do MSAA)

Observação

Este tópico descreve controle da barra de ferramentas objetos para fins de referência de elemento da interface do usuário do MSAA. Como criar controle de barra de ferramentas 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.

Um controle de barra de ferramentas contém botões que executam comandos de menu e geralmente está contido dentro de uma janela abaixo da barra de menus.

O nome da classe de janela para um controle de barra de ferramentas é TOOLBARCLASSNAME, que é definido como "ToolbarWindow32" em Commctrl.h.

Métodos IAccessible

Um controle de barra de ferramentas suporta os seguintes IAccessible métodos:

Método Observações
accDoDefaultAction A barra de ferramentas em si suporta o métodoaccDoDefaultAction. Para os botões na barra de ferramentas, accDoDefaultAction chama PostMessage com a mensagem BM_CLICK para clicar no botão especificado.
accHitTest
accLocalização
accNavigate
accSelecione

Propriedades IAccessible

Um controle de barra de ferramentas suporta os seguintes IAccessible propriedades:

Propriedade Observações
get_accChild
get_accChildCount A propriedade ChildCount é o número de controles contidos na barra de ferramentas.
get_accDefaultAction O objeto da barra de ferramentas em si não tem uma propriedade DefaultAction. A propriedade DefaultAction para botões da barra de ferramentas depende do estilo do botão da barra de ferramentas. Os botões com o estilo TBSTYLE_DROPDOWN têm "Open" como sua propriedade DefaultAction. A propriedade DefaultAction para todos os outros botões da barra de ferramentas é "Pressionar".
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut As barras de ferramentas não têm atalhos de teclado. No entanto, se o texto da janela para a barra de ferramentas contiver um caractere comercial (&), o Microsoft Ative Accessibility retornará uma cadeia de caracteres não Nula como a propriedade KeyboardShortcut.
get_accName A propriedade Name para a barra de ferramentas é obtida a partir do texto da janela do controle (ou legenda). Esse texto não é exibido com a barra de ferramentas, portanto, os desenvolvedores de servidor devem fornecer texto significativo na instrução de definição de recursos do controle para ajudar os usuários de utilitários de cliente a identificar o controle. O texto da janela pode ser definido usando a funçãoSetWindowText.
get_accParent A propriedade Parent é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve o controle e tem a mesma propriedade Name e window class name que o controle.
get_accRole A propriedade Role é ROLE_SYSTEM_TOOLBAR.
get_accSelection
get_accState O valor para a propriedade State da própria barra de ferramentas é zero, o que significa que o objeto está visível. Os valores possíveis para a propriedade State dos botões da barra de ferramentas são: STATE_SYSTEM_INVISIBLE ou
STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE

Observações

Os botões em uma barra de ferramentas enviam EVENT_OBJECT_STATECHANGE eventos.

Interface IAccessible