En esta página

MenuItem QML Type

Un elemento de menú nativo. Más...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

MenuSeparator

Propiedades

Señales

Métodos

Descripción detallada

El tipo MenuItem proporciona una API de QML para los elementos de menú de la plataforma nativa.

Menú nativo con las opciones «Acercar» y «Alejar»

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().

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:

ConstanteDescripción
MenuItem.NoRoleEl elemento no debe incluirse en el menú de la aplicación
MenuItem.TextHeuristicRoleEl elemento debe incluirse en el menú de la aplicación en función del texto de la acción (valor por defecto)
MenuItem.ApplicationSpecificRoleEl elemento debe incluirse en el menú de la aplicación con una función específica de la aplicación
MenuItem.AboutQtRoleEl elemento gestiona la opción de menú «Acerca de Qt».
MenuItem.AboutRoleEl 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.PreferencesRoleEl elemento debe colocarse donde se encuentra la opción de menú «Preferencias...» en el menú de la aplicación.
MenuItem.QuitRoleLa 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
}

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.