Controle da barra de ferramentas (referência de elemento da interface do usuário do MSAA)
Nota
Este tópico descreve objetos de controle de barra de ferramentas para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos de controle da barra de ferramentas 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.
Um controle de barra de ferramentas contém botões que executam comandos de menu e geralmente está contido em 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 dá suporte aos seguintes métodos deIAccessible:
| Método | Comentários |
|---|---|
| accDoDefaultAction | A barra de ferramentas em si dá suporte ao métodoaccDoDefaultAction. Para os botões na barra de ferramentas, accDoDefaultAction chamadas postMessage com a mensagem BM_CLICK para clicar no botão especificado. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propriedades IAccessible
Um controle de barra de ferramentas dá suporte às seguintes propriedades deIAccessible:
| Propriedade | Comentários |
|---|---|
| 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. Botões com o estilo TBSTYLE_DROPDOWN têm "Open" como 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 da barra de ferramentas contiver um caractere ampersand (&), a Acessibilidade Ativa da Microsoft retornará uma cadeia de caracteres não nula como a propriedade KeyboardShortcut. |
| get_accName | A propriedade Name da barra de ferramentas é obtida 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 recurso do controle para ajudar os usuários de utilitários cliente a identificar o controle. O texto da janela pode ser definido usando a função SetWindowText. |
| get_accParent | A propriedade Pai é uma janela (ROLE_SYSTEM_WINDOW) que envolve o controle e tem a mesma propriedade Name e o nome da classe de janela que o controle. |
| get_accRole | A propriedade de Função é ROLE_SYSTEM_TOOLBAR. |
| get_accSelection | |
| get_accState | O valor para a propriedade State para a barra de ferramentas em si é 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 |
Anotações
Os botões em uma barra de ferramentas enviam eventos EVENT_OBJECT_STATECHANGE.