Elemento de menú (referencia de elemento de interfaz de usuario de MSAA)
Nota:
En este tema se describen los objetos Menu Item con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear objetos de elemento de menú en varios marcos de interfaz de usuario aquí. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.
Un elemento de menú representa un elemento determinado en una barra de menús o un menú emergente. Por ejemplo, La accesibilidad activa de Microsoft crea un objeto de elemento de menú para el menú Archivo de la barra de menús. De forma similar, Microsoft Active Accessibility crea un objeto de elemento de menú para el elemento de menú Abrir desde el menú emergente Archivo .
El nombre de la clase de ventana de un elemento de menú es "#32768".
Métodos IAccessible
Un elemento de menú admite los siguientes métodos IAccessible :
| Método | Comentarios |
|---|---|
| accDoDefaultAction | Para los elementos de menú de la barra de menús, accDoDefaultAction muestra o cierra el menú en función del estado del menú. Para los elementos de menú de un menú emergente, accDoDefaultAction hace clic en el elemento de menú para ejecutar el comando de menú. |
| acchittest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propiedades IAccessible
Un elemento de menú admite las siguientes propiedades IAccessible :
| Propiedad | Comentarios |
|---|---|
| get_accChild | Recupera la interfaz IDispatch en el objeto de menú emergente de este elemento. |
| get_accChildCount | La propiedad ChildCount es una para los elementos de menú que muestran un menú o submenú; de lo contrario, la propiedad ChildCount es cero. |
| get_accDefaultAction | La propiedad DefaultAction para los elementos de menú que muestran un menú o submenú es "Abrir" o "Cerrar" en función del estado del menú. La propiedad DefaultAction para todos los demás elementos de menú es "Execute". |
| get_accFocus | |
| get_accKeyboardShortcut | La propiedad KeyboardShortcut es la tecla de acceso del elemento de menú, que es el carácter subrayado en el texto del nombre del elemento de menú. Por ejemplo, la propiedad KeyboardShortcut del elemento de menú Archivo es "f". |
| get_accName | La propiedad Name es la misma que el nombre del elemento de menú. |
| get_accParent | La propiedad Parent es la barra de menús o el menú emergente que contiene el elemento de menú. |
| get_accRole | La propiedad Role es ROLE_SYSTEM_MENUITEM. |
| get_accState | La propiedad State es STATE_SYSTEM_INVISIBLE o una combinación de uno o varios de los valores siguientes: STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_CHECKED | | STATE_SYSTEM_DEFAULT | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_HASPOPUP |
Notas
- Cuando se usa en un elemento de menú, accDoDefaultAction devuelve S_OK pero no puede realizar la acción si el carácter usado en la tecla de acceso es ?, !, @, o cualquier otro carácter que requiera la tecla MAYÚS u otra tecla modificadora. Esto también sucede en los teclados internacionales con un carácter de tecla de acceso que requiere que se presione la tecla ALT GR.
- El método accSelect con SELFLAG_TAKEFOCUS no hace que un elemento de menú se abra o cierre un menú emergente. Los clientes usan el método accDoDefaultAction para abrir o cerrar un menú emergente.
- Un elemento de barra de menús que no muestra un menú emergente devuelve "Aplicación" para la propiedad Name en lugar del nombre del elemento de menú.