Controle de barra de ferramentas (referência de elemento de interface do usuário msaa)
Observação
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 de barra de ferramentas 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.
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 IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | A barra de ferramentas em si dá suporte ao método accDoDefaultAction . Para os botões na barra de ferramentas, accDoDefaultAction chama 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 IAccessible :
| 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 sua propriedade DefaultAction . A propriedade DefaultAction para todos os outros botões da barra de ferramentas é "Pressione". |
| 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 e comercial (&), 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 servidores devem fornecer texto significativo na instrução de definição de recurso 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ção SetWindowText . |
| get_accParent | A propriedade Parent é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve o controle e tem a mesma propriedade Name e nome de classe de janela que o controle. |
| Get_accrole | A propriedade Role é ROLE_SYSTEM_TOOLBAR. |
| Get_accselection | |
| Get_accstate | O valor da 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 |
Observações
Os botões em uma barra de ferramentas enviam EVENT_OBJECT_STATECHANGE eventos.