MenuItemGroup QML Type

Un groupe permettant de gérer les éléments de menu natifs. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Signaux

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

Méthodes

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

Description détaillée

Le MenuItemGroup regroupe des éléments de menu natifs.

Par défaut, MenuItemGroup est exclusif. Dans un groupe d'éléments de menu exclusif, un seul élément peut être coché à la fois ; cocher un autre élément décoche automatiquement celui qui était coché auparavant. MenuItemGroup peut être configuré comme non exclusif, ce qui est particulièrement utile pour afficher, masquer, activer et désactiver des éléments ensemble, en tant que groupe.

La manière la plus simple d'utiliser MenuItemGroup consiste à lui attribuer une liste d'éléments.

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 }
}

Un même menu peut parfois contenir des éléments qui ne doivent pas être inclus dans le même groupe exclusif. Dans ce cas, il est préférable d’utiliser la propriété ` 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 }
}

Les cas d’utilisation plus avancés peuvent être gérés à l’aide des méthodes ` addItem()` et ` removeItem()`.

Voir également MenuItem.

Documentation sur les propriétés

checkedItem : MenuItem

Cette propriété contient l'élément actuellement sélectionné dans le groupe, ou la valeur « null » si aucun élément n'est sélectionné.

enabled : bool

Cette propriété indique si le groupe est activé. La valeur par défaut est « true ».

L'état d'activation du groupe influe sur l'état d'activation de chaque élément qu'il contient, sauf que les éléments explicitement désactivés ne sont pas activés, même si le groupe est activé.

exclusive : bool

Cette propriété indique si le groupe est exclusif. La valeur par défaut est « true ».

Dans un groupe d'éléments de menu exclusif, un seul élément peut être coché à la fois ; le fait de cocher un autre élément décoche automatiquement celui qui était coché auparavant.

items : list<MenuItem>

Cette propriété contient la liste des éléments du groupe.

visible : bool

Cette propriété indique si le groupe est visible. La valeur par défaut est « true ».

La visibilité du groupe influe sur celle de chacun de ses éléments, sauf que les éléments explicitement masqués ne sont pas visibles, même si le groupe est visible.

Documentation Signal

hovered(MenuItem item)

Ce signal est émis lorsque l'utilisateur passe la souris sur une « item » du groupe.

Voir également MenuItem::hovered().

triggered(MenuItem item)

Ce signal est émis lorsqu'un « item » du groupe est déclenché par l'utilisateur.

Voir aussi MenuItem::triggered().

Documentation de la méthode

void addItem(MenuItem item)

Ajoute une « item » au groupe.

void clear()

Supprime tous les éléments du groupe.

void removeItem(MenuItem item)

Supprime une « item » du groupe.