MenuItem QML Type

Affiche un élément dans un menu. En savoir plus…

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

Propriétés

• arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• highlighted : bool
• implicitTextPadding : real (since 6.8)
• menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• textPadding : real (since 6.8)

Signaux

• void triggered()

Description détaillée

MenuItem est un type de commodité qui implémente l'API AbstractButton, offrant ainsi un moyen intuitif de gérer, par exemple, les éléments de menu sur lesquels l'on clique ( triggered).

MenuItem hérite de son API de AbstractButton. Par exemple, vous pouvez définir l'text et l'icône à l'aide de l'API AbstractButton.

Button {
    id: fileButton
    text: "File"
    onClicked: menu.open()

    Menu {
        id: menu

        MenuItem {
            text: "New..."
            onTriggered: document.reset()
        }
        MenuItem {
            text: "Open..."
            onTriggered: openDialog.open()
        }
        MenuItem {
            text: "Save"
            onTriggered: saveDialog.open()
        }
    }
}

Voir également Personnalisation du menu, Menu et Contrôles de menu.

Documentation sur les propriétés

arrow : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient l'élément « flèche » du sous-menu.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir également Personnalisation du menu.

highlighted : bool

Cette propriété indique si l'élément de menu est mis en surbrillance par l'utilisateur.

Un élément de menu peut être mis en surbrillance au passage de la souris ou lors de la navigation au clavier.

La valeur par défaut est « false ».

Voir également Menu::currentIndex.

implicitTextPadding : real [since 6.8]

Cette propriété définit l'espace minimal nécessaire entre le bord gauche de l'contentItem et le texte. Elle sert à calculer une « textPadding » commune à tous les MenuItems d'un Menu.

Cette propriété a été introduite dans Qt 6.8.

Voir également « textPadding ».

menu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient le menu dans lequel se trouve cet élément de menu, ou la valeur « null » si l'élément ne figure pas dans un menu.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

subMenu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient le sous-menu que cet élément affiche dans le menu parent, ou la valeur « null » si cet élément n'est pas un élément de sous-menu.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

textPadding : real [read-only, since 6.8]

Cette propriété contient la valeur maximale de l'implicitTextPadding parmi tous les éléments de menu d'un même menu.

Cette propriété peut être utilisée par le style pour garantir que tous les MenuItems d'un même Menu soient alignés par rapport à l'text.

Un « Menu » peut se composer de nombreux « MenuItems » différents : certains peuvent être cochables, d’autres peuvent comporter une icône, et d’autres encore ne contiennent que du texte. Très souvent, un style souhaite s’assurer que le texte contenu dans chacun d’entre eux soit aligné à gauche (ou à droite pour les éléments de type « mirrored »). En laissant chaque élément « MenuItem » attribuer son propre espacement de texte minimal à « implicitTextPadding » (en tenant compte des icônes et des coches), mais en utilisant «textPadding» pour positionner réellement l’« text », tous les éléments «MenuItems» devraient finalement être alignés

Pour que cela fonctionne, tous les MenuItems doivent définir implicitTextPadding sur l’espace minimal nécessaire entre le bord gauche de l’ contentItem et le texte.

Cette propriété a été introduite dans Qt 6.8.

Voir également implicitTextPadding.

Documentation sur les signaux

void triggered()

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