MenuItemGroup QML Type

Un groupe pour gérer les éléments de menu natifs. Plus d'informations...

• 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 groupe MenuItemGroup regroupe les éléments de menu natifs.

Le groupe MenuItemGroup est exclusif par défaut. Dans un groupe d'éléments de menu exclusifs, un seul élément peut être coché à la fois ; le fait de cocher un autre élément décoche automatiquement l'élément précédemment coché. MenuItemGroup peut être configuré comme non exclusif, ce qui est particulièrement utile pour afficher, masquer, activer et désactiver des éléments en tant que groupe.

La manière la plus simple d'utiliser MenuItemGroup est d'assigner 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 }
}

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

Des cas d'utilisation plus avancés peuvent être traités à l'aide des méthodes addItem() et removeItem().

Voir aussi MenuItem.

Documentation sur les propriétés

checkedItem : MenuItem

Cette propriété contient l'élément actuellement coché dans le groupe, ou null si aucun élément n'est coché.

enabled : bool

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

L'état activé du groupe affecte l'état activé de chaque élément du groupe, 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 exclusifs, un seul élément peut être coché à la fois ; le fait de cocher un autre élément décoche automatiquement l'élément précédemment coché.

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 affecte la visibilité de chaque élément du groupe, sauf que les éléments explicitement cachés ne sont pas visibles même si le groupe est visible.

Documentation sur les signaux

hovered(MenuItem item)

Ce signal est émis lorsque l'utilisateur survole une page item dans le groupe.

Voir également MenuItem::hovered().

triggered(MenuItem item)

Ce signal est émis lorsqu'un utilisateur déclenche item dans le groupe.

Voir aussi MenuItem::triggered().

Documentation de la méthode

void addItem(MenuItem item)

Ajoute une adresse item au groupe.

void clear()

Supprime tous les éléments du groupe.

void removeItem(MenuItem item)

Supprime un item du groupe.