MenuItem QML Type

Présente un élément dans un menu. Plus d'informations...

• 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 met en œuvre l'API AbstractButton, fournissant un moyen familier de répondre aux éléments de menu qui sont triggered, par exemple.

MenuItem hérite de l'API de AbstractButton. Par exemple, vous pouvez définir 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 de la flèche du sous-menu.

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

Voir aussi Personnaliser le menu.

highlighted : bool

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

Un élément de menu peut être mis en évidence par le survol de la souris ou la navigation au clavier.

La valeur par défaut est false.

Voir également Menu::currentIndex.

implicitTextPadding : real [since 6.8]

Cette propriété indique l'espace minimum nécessaire entre le bord gauche du site contentItem et le texte. Elle est utilisée pour calculer un textPadding commun à tous les éléments de menu à l'intérieur d'un Menu.

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

Voir aussi textPadding.

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

Cette propriété contient le menu qui contient cet élément de menu, ou null si l'élément n'est 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 présente dans le menu parent, ou null si cet élément n'est pas un 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 le maximum implicitTextPadding trouvé parmi tous les éléments de menu à l'intérieur du même menu.

Cette propriété peut être utilisée par le style pour s'assurer que tous les éléments de menu du même menu sont alignés par rapport à text.

Un site Menu peut comporter de nombreux éléments de menu différents, certains pouvant être vérifiés, d'autres pouvant avoir une icône et d'autres encore contenant simplement du texte. Très souvent, un style veut s'assurer que le texte à l'intérieur de tous ces éléments est aligné à gauche (ou à droite pour les éléments mirrored ). En laissant chaque site MenuItem attribuer sa propre marge de texte minimale à implicitTextPadding (en tenant compte des icônes et des coches), mais en utilisant textPadding pour positionner réellement le site text, tous les éléments de menu devraient être alignés au bout du compte

Pour que cela fonctionne, tous les éléments de menu doivent définir implicitTextPadding comme étant l'espace minimum nécessaire entre le bord gauche de contentItem et le texte.

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

Voir aussi implicitTextPadding.

Documentation sur les signaux

void triggered()

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