MenuItemGroup QML Type

Un grupo para gestionar elementos de menú nativos. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• checkedItem : MenuItem
• enabled : bool
• exclusive : bool
• items : list<MenuItem>
• visible : bool

Señales

• hovered(MenuItem item)
• triggered(MenuItem item)

Métodos

• void addItem(MenuItem item)
• void clear()
• void removeItem(MenuItem item)

Descripción detallada

El MenuItemGroup agrupa elementos de menú nativos.

MenuItemGroup es exclusivo por defecto. En un grupo de elementos de menú exclusivos, sólo se puede marcar un elemento en cada momento; si se marca otro elemento, automáticamente se desactiva el que estaba marcado anteriormente. MenuItemGroup puede configurarse como no exclusivo, lo que resulta especialmente útil para mostrar, ocultar, activar y desactivar elementos juntos como un grupo.

La forma más sencilla de utilizar MenuItemGroup es asignar 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 tratan 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 }
}

Casos de uso más avanzados pueden ser manejados usando los métodos addItem() y removeItem().

Véase también MenuItem.

Documentación de propiedades

checkedItem : MenuItem

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

enabled : bool

Esta propiedad indica si el grupo está habilitado. El valor por defecto es true.

El estado habilitado del grupo afecta al estado habilitado de cada elemento del grupo, excepto que los elementos deshabilitados explícitamente no se habilitan aunque el grupo esté habilitado.

exclusive : bool

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

En un grupo de elementos de menú exclusivos, sólo se puede marcar un elemento a la vez; si se marca otro elemento, automáticamente se desmarca el marcado anteriormente.

items : list<MenuItem>

Esta propiedad contiene la lista de elementos del grupo.

visible : bool

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

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

Documentación de la señal

hovered(MenuItem item)

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

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

triggered(MenuItem item)

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

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.