MenuItem QML Type
Un elemento de menú nativo. Más...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Inherited By: |
Propiedades
- checkable : bool
- checked : bool
- enabled : bool
- font : font
- group : MenuItemGroup
- icon
(since Qt.labs.platform 1.1 (Qt 5.12))- icon.mask : bool
(since Qt.labs.platform 1.1 (Qt 5.12)) - icon.name : string
(since Qt.labs.platform 1.1 (Qt 5.12)) - icon.source : url
(since Qt.labs.platform 1.1 (Qt 5.12))
- icon.mask : bool
- menu : Menu
- role : enumeration
- separator : bool
- shortcut : keysequence
- subMenu : Menu
- text : string
- visible : bool
Señales
Métodos
- void toggle()
Descripción detallada
El tipo MenuItem proporciona una API de QML para los elementos de menú de la plataforma nativa.

Un elemento de menú consta de un ` icon`, un ` text` y un ` shortcut`.
Menu {
id: zoomMenu
MenuItem {
text: qsTr("Zoom In")
shortcut: StandardKey.ZoomIn
onTriggered: zoomIn()
}
MenuItem {
text: qsTr("Zoom Out")
shortcut: StandardKey.ZoomOut
onTriggered: zoomOut()
}
}Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
Véase también « Menu » y « MenuItemGroup ».
Documentación de propiedades
checkable : bool
Esta propiedad indica si el elemento se puede marcar.
Un elemento de menú que se puede marcar tiene un estado de activado/desactivado. Por ejemplo, en un procesador de textos, el elemento de menú «Negrita» puede estar activado o desactivado. Un elemento de menú que no se puede marcar es un comando que simplemente se ejecuta, por ejemplo, «Guardar archivo».
El valor por defecto es « false ».
Véase también « checked » y « MenuItemGroup ».
checked : bool
Esta propiedad se mantiene independientemente de si el elemento está marcado (activado) o desmarcado (desactivado). El valor por defecto es « false ».
Véase también checkable y MenuItemGroup.
enabled : bool
Esta propiedad indica si el elemento está habilitado. El valor por defecto es « true ».
El usuario no puede activar los elementos desactivados. No desaparecen de los menús, pero se muestran de forma que se indique que no están disponibles. Por ejemplo, pueden mostrarse utilizando únicamente tonos de gris.
Cuando un elemento está desactivado, no es posible activarlo a través de su ` shortcut`.
font : font
Esta propiedad contiene la fuente del elemento del menú.
Véase también text.
group : MenuItemGroup
Esta propiedad contiene el grupo al que pertenece el elemento o el valor « null » si el elemento no pertenece a ningún grupo.
icon group
icon.mask : bool [since Qt.labs.platform 1.1 (Qt 5.12)]
icon.name : string [since Qt.labs.platform 1.1 (Qt 5.12)]
icon.source : url [since Qt.labs.platform 1.1 (Qt 5.12)]
Esta propiedad contiene el icono del elemento del menú.
MenuItem {
icon.mask: true
icon.name: "edit-undo"
icon.source: "qrc:/images/undo.png"
}Estas propiedades se introdujeron en Qt Labs Platform 1.1 (Qt 5.12).
Véase también QIcon::fromTheme().
menu : Menu [read-only]
Esta propiedad contiene el menú al que pertenece el elemento, o bien ` null ` si el elemento no forma parte de ningún menú.
role : enumeration
Esta propiedad indica la función del elemento. La función determina si el elemento debe incluirse en el menú de la aplicación en macOS.
Valores disponibles:
| Constante | Descripción |
|---|---|
MenuItem.NoRole | El elemento no debe incluirse en el menú de la aplicación |
MenuItem.TextHeuristicRole | El elemento debe incluirse en el menú de la aplicación en función del texto de la acción (valor por defecto) |
MenuItem.ApplicationSpecificRole | El elemento debe incluirse en el menú de la aplicación con una función específica de la aplicación |
MenuItem.AboutQtRole | El elemento gestiona la opción de menú «Acerca de Qt». |
MenuItem.AboutRole | El elemento debe colocarse donde se encuentra el elemento de menú «Acerca de» en el menú de la aplicación. El texto del elemento de menú se establecerá como «Acerca de <NOMBRE de la aplicación>». El nombre de la aplicación se obtiene del archivo Info.plist del paquete de la aplicación (véase Qt para macOS: implementación). |
MenuItem.PreferencesRole | El elemento debe colocarse donde se encuentra la opción de menú «Preferencias...» en el menú de la aplicación. |
MenuItem.QuitRole | La opción debe colocarse donde se encuentra la opción de menú «Salir» en el menú de la aplicación. |
Especificar la función solo tiene efecto en los elementos que se encuentran en los menús inmediatos de una barra de menús, no en los submenús de dichos menús. Por ejemplo, si tienes un menú «Archivo» en tu barra de menús y este menú tiene un submenú, especificar una función para los elementos de ese submenú no tiene ningún efecto. Nunca se trasladarán al menú de la aplicación.
separator : bool
Esta propiedad indica si el elemento es una línea separadora. El valor por defecto es « false ».
Véase también « MenuSeparator ».
shortcut : keysequence
Esta propiedad contiene el atajo de teclado del elemento del menú.
La secuencia de teclas de acceso rápido puede establecerse como una de las siguientes: standard keyboard shortcuts, o bien puede especificarse mediante una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para trigger el acceso rápido.
El valor por defecto es una secuencia de teclas vacía.
MenuItem {
shortcut: "Ctrl+E,Ctrl+W"
onTriggered: edit.wrapMode = TextEdit.Wrap
}subMenu : Menu [read-only]
Esta propiedad contiene el submenú que incluye el elemento, o bien « null » si el elemento no es un elemento de submenú.
text : string
Esta propiedad contiene el texto del elemento del menú.
visible : bool
Esta propiedad indica si el elemento está visible. El valor por defecto es « true ».
Documentación de Signal
hovered()
Esta señal se emite cuando el usuario pasa el cursor por encima de la opción del menú.
Nota: El controlador correspondiente es onHovered.
triggered()
Esta señal se emite cuando el usuario activa la opción del menú.
Nota: El controlador correspondiente es onTriggered.
Documentación del método
void toggle()
Cambia el estado de « checked » a su estado opuesto.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.