Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Observação
Este tópico descreve objetos Item de Menu para fins de Referência de Elemento da Interface do Usuário do MSAA. Como criar Item de Menu 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 item de menu representa um item específico em uma barra de menus ou menu pop-up. Por exemplo, o Microsoft Ative Accessibility cria um objeto de item de menu para o menu File na barra de menus. Da mesma forma, o Microsoft Ative 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 suporta os seguintes IAccessible métodos:
| Método | Observações |
|---|---|
| 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 | |
| accLocalização | |
| accNavigate | |
| accSelecione |
Propriedades IAccessible
Um item de menu suporta as seguintes propriedades IAccessible:
| Propriedade | Observações |
|---|---|
| get_accChild | Recupera o IDispatch interface para o objeto de menu pop-up para este item. |
| get_accChildCount | A propriedade ChildCount é uma para itens de menu que exibem um menu ou submenu; caso contrário, a propriedade ChildCount é 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 é "Execute". |
| get_accFocus | |
| get_accKeyboardShortcut | A propriedade KeyboardShortcut é a tecla 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 menu File é "f". |
| get_accName | A propriedade Name é igual ao nome do item de menu. |
| get_accParent | A propriedade pai é 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 não consegue executar a ação se o caractere usado na chave de acesso for ?, !, @ ou qualquer outro caractere que exija a tecla SHIFT ou outra tecla modificadora. Isso também acontece em teclados internacionais com um caractere de tecla de acesso que requer 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 da 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.