Share via

Elemento de menú (referencia de elemento de interfaz de usuario de MSAA)

  • Artículo

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ú.

IAccessible (interfaz)

Barra de menús

Menú emergente