En esta página

MenuItemGroup QML Type

Un grupo para gestionar los elementos del menú nativo. Más...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Propiedades

Señales

Métodos

Descripción detallada

MenuItemGroup agrupa elementos de menú nativos.

MenuItemGroup es exclusivo por defecto. En un grupo de elementos de menú exclusivo, solo se puede marcar un elemento a la vez; al marcar otro elemento, el que estaba marcado anteriormente se desmarca automáticamente. MenuItemGroup se puede configurar como no exclusivo, lo cual resulta especialmente útil para mostrar, ocultar, activar y desactivar elementos de forma conjunta como un grupo.

La forma más sencilla de utilizar MenuItemGroup es asignarle una lista de elementos.

Menu {
    id: verticalMenu
    title: qsTr("Vertical")

    MenuItemGroup {
        id: verticalGroup
        items: verticalMenu.items
    }

    MenuItem { text: qsTr("Top"); checkable: true }
    MenuItem { text: qsTr("Center"); checked: true }
    MenuItem { text: qsTr("Bottom"); checkable: true }
}

En ocasiones, un mismo menú puede contener elementos que no deben incluirse en el mismo grupo exclusivo. Estos casos se gestionan mejor utilizando la propiedad ` group `.

Menu {
    id: horizontalMenu
    title: qsTr("Horizontal")

    MenuItemGroup {
        id: horizontalGroup
    }

    MenuItem {
        checked: true
        text: qsTr("Left")
        group: horizontalGroup
    }
    MenuItem {
        checkable: true
        text: qsTr("Center")
        group: horizontalGroup
    }
    MenuItem {
        text: qsTr("Right")
        checkable: true
        group: horizontalGroup
    }

    MenuItem { separator: true }
    MenuItem { text: qsTr("Justify"); checkable: true }
    MenuItem { text: qsTr("Absolute"); checkable: true }
}

Los casos de uso más avanzados pueden gestionarse mediante los métodos ` addItem()` y ` removeItem()`.

Nota: No se garantiza que los tipos de los módulos Qt.labs sigan siendo compatibles en futuras versiones.

Véase también ` MenuItem`.

Documentación de la propiedad

checkedItem : MenuItem

Esta propiedad contiene el elemento seleccionado actualmente en el grupo, o ` null ` si no hay ningún elemento seleccionado.

enabled : bool

Esta propiedad indica si el grupo está activado. El valor por defecto es « true ».

El estado de activación del grupo afecta al estado de activación de cada elemento del grupo, salvo en el caso de los elementos desactivados explícitamente, que no se activan aunque el grupo esté activado.

exclusive : bool

Esta propiedad indica si el grupo es exclusivo. El valor por defecto es « true ».

En un grupo de elementos de menú exclusivo, solo se puede marcar un elemento a la vez; al marcar otro elemento, el que estaba marcado anteriormente se desmarca automáticamente.

items : list<MenuItem>

Esta propiedad contiene la lista de elementos del grupo.

visible : bool

Esta propiedad indica si el grupo está visible. El valor por defecto es « true ».

La visibilidad del grupo afecta a la visibilidad de cada elemento del grupo, salvo en el caso de los elementos ocultos explícitamente, que no son visibles aunque el grupo sea visible.

Documentación de Signal

hovered(MenuItem item)

Esta señal se emite cuando el usuario pasa el cursor por encima de un item del grupo.

Nota: El controlador correspondiente es onHovered.

Véase también MenuItem::hovered().

triggered(MenuItem item)

Esta señal se emite cuando el usuario activa un « item » del grupo.

Nota: El controlador correspondiente es onTriggered.

Véase también MenuItem::triggered().

Documentación del método

void addItem(MenuItem item)

Añade un « item » al grupo.

void clear()

Elimina todos los elementos del grupo.

void removeItem(MenuItem item)

Elimina un « item » del grupo.

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