MenuItem QML Type

Un élément de menu natif. En savoir plus…

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

Propriétés

• 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

Signaux

• hovered()
• triggered()

Méthodes

• void toggle()

Description détaillée

Le type MenuItem fournit une API QML pour les éléments de menu natifs de la plateforme.

Un élément de menu se compose d’un « icon », d’un « text » et d’un « shortcut ».

Menu {
    id: zoomMenu

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

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

Voir également Menu et MenuItemGroup.

Documentation sur les propriétés

checkable : bool

Cette propriété indique si l'élément est cochable.

Un élément de menu cochable présente un état activé/désactivé. Par exemple, dans un traitement de texte, un élément de menu « Gras » peut être activé ou désactivé. Un élément de menu non cochable est une commande qui est simplement exécutée, par exemple « Enregistrer le fichier ».

La valeur par défaut est « false ».

Voir également « checked » et « MenuItemGroup ».

checked : bool

Cette propriété s'applique que l'élément soit coché (activé) ou non coché (désactivé). La valeur par défaut est « false ».

Voir également checkable et MenuItemGroup.

enabled : bool

Cette propriété indique si l'élément est activé. La valeur par défaut est « true ».

Les éléments désactivés ne peuvent pas être déclenchés par l’utilisateur. Ils ne disparaissent pas des menus, mais sont affichés de manière à indiquer qu’ils ne sont pas disponibles. Par exemple, ils peuvent être affichés uniquement en nuances de gris.

Lorsqu’un élément est désactivé, il n’est pas possible de le déclencher via son ` shortcut`.

font : font

Cette propriété définit la police de l'élément de menu.

Voir également text.

group : MenuItemGroup

Cette propriété contient le nom du groupe auquel appartient l'élément, ou la valeur « null » si l'élément n'appartient à aucun groupe.

icon group

Cette propriété contient l'icône de l'élément de menu.

MenuItem {
    icon.mask: true
    icon.name: "edit-undo"
    icon.source: "qrc:/images/undo.png"
}

Ces propriétés ont été introduites dans Qt Labs Platform 1.1 (Qt 5.12).

Voir également QIcon::fromTheme().

menu : Menu [read-only]

Cette propriété contient le menu auquel appartient l'élément, ou la valeur « null » si l'élément ne figure dans aucun menu.

role : enumeration

Cette propriété définit le rôle de l'élément. Le rôle détermine si l'élément doit être ajouté au menu de l'application sous macOS.

Valeurs disponibles :

La spécification du rôle n'a d'effet que sur les éléments situés dans les menus immédiats d'une barre de menus, et non dans les sous-menus de ces derniers. Par exemple, si votre barre de menus comporte un menu « Fichier » et que ce menu « Fichier » comporte un sous-menu, la spécification d’un rôle pour les éléments de ce sous-menu n’aura aucun effet. Ceux-ci ne seront jamais déplacés vers le menu de l’application.

separator : bool

Cette propriété indique si l'élément est une ligne de séparation. La valeur par défaut est « false ».

Voir également MenuSeparator.

shortcut : keysequence

Cette propriété contient le raccourci clavier de l'élément de menu.

La séquence de touches de raccourci peut être définie sur l'une des valeurs suivantes : standard keyboard shortcuts. Elle peut également être spécifiée par une chaîne de caractères contenant une séquence de quatre touches au maximum, nécessaires pour trigger r le raccourci.

La valeur par défaut est une séquence de touches vide.

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

subMenu : Menu [read-only]

Cette propriété contient le sous-menu auquel l'élément appartient, ou la valeur « null » si l'élément n'est pas un élément de sous-menu.

text : string

Cette propriété contient le texte de l'élément de menu.

visible : bool

Cette propriété indique si l'élément est visible. La valeur par défaut est « true ».

Documentation sur les signaux

hovered()

Ce signal est émis lorsque l'utilisateur passe la souris sur l'élément de menu.

triggered()

Ce signal est émis lorsque l'utilisateur active l'élément de menu.

Documentation de la méthode

void toggle()

Permet de basculer l'état « checked » vers son état opposé.