MenuItem QML Type

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

• Lista de todos los miembros, incluidos los heredados

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))
• menu : Menu
• role : enumeration
• separator : bool
• shortcut : keysequence
• subMenu : Menu
• text : string
• visible : bool

Señales

• hovered()
• triggered()

Métodos

• void toggle()

Descripción detallada

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

Un elemento de menú consta de icon, text, y shortcut.

Menu {
    id: zoomMenu

    MenuItem {
        text: qsTr("Zoom In")
        shortcut: StandardKey.ZoomIn
        onTriggered: zoomIn()
    }

    MenuItem {
        text: qsTr("Zoom Out")
        shortcut: StandardKey.ZoomOut
        onTriggered: zoomOut()
    }
}

Véase también Menu y MenuItemGroup.

Documentación de propiedades

checkable : bool

Esta propiedad indica si el elemento es comprobable.

Un elemento de menú seleccionable tiene un estado activado/desactivado. Por ejemplo, en un procesador de textos, un elemento de menú "Negrita" puede estar activado o desactivado. Un elemento de menú no comprobable es un elemento de 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 indica si el elemento está marcado (activado) o no (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.

Los elementos deshabilitados no pueden ser activados por el usuario. No desaparecen de los menús, pero se muestran de una forma que indica que no están disponibles. Por ejemplo, pueden aparecer sólo en tonos grises.

Cuando un elemento está desactivado, no es posible activarlo a través de shortcut.

font : font

Esta propiedad contiene la fuente del elemento de menú.

Véase también text.

group : MenuItemGroup

Esta propiedad contiene el grupo al que pertenece el elemento, o null si el elemento no está en ningún grupo.

icon group

Esta propiedad contiene el icono del elemento de 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 null si el elemento no está en ningún menú.

role : enumeration

Esta propiedad contiene el rol del elemento. El rol determina si el elemento debe colocarse en el menú de aplicaciones en macOS.

Valores disponibles:

Especificar la función sólo 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 esos menús. Por ejemplo, si tienes un menú "Archivo" en tu barra de menús y el menú "Archivo" tiene un submenú, especificar un rol para los elementos de ese submenú no tiene ningún efecto. Nunca se moverá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 acceso directo del elemento de menú.

La secuencia de teclas de acceso directo puede ser una de las siguientes: standard keyboard shortcuts, o puede especificarse mediante una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para trigger el acceso directo.

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 contiene el elemento, o null si el elemento no es un elemento de submenú.

text : string

Esta propiedad contiene el texto del elemento de menú.

visible : bool

Esta propiedad indica si el elemento es visible. El valor por defecto es true.

Documentación de la señal

hovered()

Esta señal se emite cuando el usuario pasa el ratón por encima del elemento del menú.

triggered()

Esta señal se emite cuando el elemento de menú es activado por el usuario.

Documentación del método

void toggle()

Cambia el estado checked a su estado opuesto.