Item de menu (referência de elemento da interface do usuário do MSAA)
Observação
Este tópico descreve objetos de Item de Menu para fins de referência de elemento de interface do usuário do MSAA. Como criar objetos item de menu 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 item de menu representa um item específico em uma barra de menus ou menu pop-up. Por exemplo, o Microsoft Active Accessibility cria um objeto de item de menu para o menu Arquivo na barra de menus. Da mesma forma, o Microsoft Active Accessibility cria um objeto de item de menu para o item de menu Abrir no menu pop-up Arquivo .
O nome da classe de janela para um item de menu é "#32768".
Métodos IAccessible
Um item de menu dá suporte aos seguintes métodos IAccessible :
| Método | Comentários |
|---|---|
| Accdodefaultaction | Para itens de menu da barra de menus, accDoDefaultAction exibe ou fecha o menu dependendo do estado do menu. Para itens de menu de um menu pop-up, accDoDefaultAction clica no item de menu para executar o comando de menu. |
| Acchittest | |
| Acclocation | |
| Accnavigate | |
| Accselect |
Propriedades IAccessible
Um item de menu dá suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChild | Recupera a interface IDispatch para o objeto de menu pop-up deste item. |
| get_accChildCount | A propriedade ChildCount é uma para itens de menu que exibem um menu ou submenu; caso contrário, a propriedade ChildCount será zero. |
| get_accDefaultAction | A propriedade DefaultAction para itens de menu que exibem um menu ou submenu é "Abrir" ou "Fechar" dependendo do estado do menu. A propriedade DefaultAction para todos os outros itens de menu é "Executar". |
| Get_accfocus | |
| Get_acckeyboardshortcut | A propriedade KeyboardShortcut é a chave de acesso do item de menu, que é o caractere sublinhado no texto do nome do item de menu. Por exemplo, a propriedade KeyboardShortcut para o item de menuFile é "f". |
| Get_accname | A propriedade Name é a mesma que o nome do item de menu. |
| get_accParent | A propriedade Parent é a barra de menus ou o menu pop-up que contém o item de menu. |
| Get_accrole | A propriedade Role é ROLE_SYSTEM_MENUITEM. |
| Get_accstate | A propriedade State é STATE_SYSTEM_INVISIBLE ou uma combinação de um ou mais dos seguintes valores: STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_CHECKED | STATE_SYSTEM_DEFAULT | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_FOCUSED STATE_SYSTEM_HASPOPUP | |
Observações
- Quando usado em um item de menu, accDoDefaultAction retorna S_OK mas falha ao executar a ação se o caractere usado na chave de acesso for ?, !, @ou qualquer outro caractere que exija a chave SHIFT ou outra chave modificadora. Isso também acontece em teclados internacionais com um caractere de tecla de acesso que exige que a tecla ALT GR seja pressionada.
- O método accSelect com SELFLAG_TAKEFOCUS não faz com que um item de menu abra ou feche um menu pop-up. Os clientes usam o método accDoDefaultAction para abrir ou fechar um menu pop-up.
- Um item de barra de menus que não exibe um menu pop-up retorna "Application" para a propriedade Name em vez do nome do item de menu.