MenuItem QML Type

Un élément de menu natif. Plus d'informations...

• 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 de la plate-forme native.

Un élément de menu se compose de icon, text, et 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 contrôlable.

Un élément de menu contrôlable a 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 contrôlable est un élément de commande qui est simplement exécuté, par exemple l'enregistrement d'un fichier.

La valeur par défaut est false.

Voir également checked et MenuItemGroup.

checked : bool

Cette propriété indique si l'élément est coché (on) ou décoché (off). 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 ils sont affichés d'une manière qui indique 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 par l'intermédiaire de son site shortcut.

font : font

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

Voir aussi text.

group : MenuItemGroup

Cette propriété contient le groupe auquel l'élément appartient, ou null si l'élément ne fait pas partie d'un 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 aussi QIcon::fromTheme().

menu : Menu [read-only]

Cette propriété contient le menu auquel l'élément appartient, ou null si l'élément n'est pas dans un menu.

role : enumeration

Cette propriété contient le rôle de l'élément. Le rôle détermine si l'élément doit être placé dans le menu d'application sous macOS.

Valeurs disponibles :

La spécification du rôle n'a d'effet que sur les éléments qui se trouvent dans les menus immédiats d'une barre de menus, et non dans les sous-menus de ces menus. Par exemple, si vous avez un menu "Fichier" dans votre ménubar et que le menu "Fichier" a un sous-menu, la spécification d'un rôle pour les éléments de ce sous-menu n'a aucun effet. Ils ne seront jamais déplacés vers le menu d'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 de l'élément de menu.

La séquence de touches du raccourci peut être définie sur l'une des pages standard keyboard shortcuts, ou peut être spécifiée par une chaîne contenant une séquence de quatre pressions de touches maximum nécessaires pour trigger 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 que l'élément contient, ou null si l'élément n'est pas un 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'élément de menu est survolé par l'utilisateur.

triggered()

Ce signal est émis lorsque l'élément de menu est déclenché par l'utilisateur.

Documentation de la méthode

void toggle()

Bascule de l'état checked à l'état opposé.