MenuItem QML Type

Stellt ein Element innerhalb eines Menüs vor. Mehr...

Import Statement:	`import QtQuick.Controls`
Inherits:	AbstractButton

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

void triggered()

Detaillierte Beschreibung

MenuItem ist ein Convenience-Typ, der die API von AbstractButton implementiert und eine vertraute Art und Weise bietet, auf Menüpunkte zu reagieren, die z. B. triggered sind.

MenuItem erbt seine API von AbstractButton. Sie können zum Beispiel text und das Symbol mit der API AbstractButton einstellen.

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()
        }
    }
}

Siehe auch Menü anpassen, Menu und Menü-Steuerelemente.

Eigenschaft Dokumentation

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

Diese Eigenschaft enthält den Pfeil des Untermenüs.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch Menü anpassen.

highlighted : bool

Diese Eigenschaft gibt an, ob der Menüpunkt vom Benutzer hervorgehoben wird.

Ein Menüpunkt kann durch Mouse-Hover oder Tastaturnavigation hervorgehoben werden.

Der Standardwert ist false.

Siehe auch Menu::currentIndex.

implicitTextPadding : bool [since 6.8]

Diese Eigenschaft gibt den Mindestabstand zwischen dem linken Rand von contentItem und dem Text an. Sie wird verwendet, um eine gemeinsame textPadding für alle MenuItems innerhalb einer Menu zu berechnen.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch textPadding.

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

Diese Eigenschaft enthält das Menü, das diesen Menüpunkt enthält, oder null, wenn der Punkt nicht in einem Menü ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

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

Diese Eigenschaft enthält das Untermenü, das dieser Eintrag im übergeordneten Menü darstellt, oder null, wenn dieser Eintrag kein Untermenüeintrag ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

textPadding : bool [read-only, since 6.8]

Diese Eigenschaft enthält das Maximum von implicitTextPadding unter allen Menüpunkten innerhalb desselben menu.

Diese Eigenschaft kann vom Stil verwendet werden, um sicherzustellen, dass alle Menüpunkte innerhalb desselben Menüs in Bezug auf text ausgerichtet werden.

Ein Menu kann aus vielen verschiedenen Menüpunkten bestehen, einige können anklickbar sein, einige können ein Symbol haben, und einige enthalten nur Text. Und sehr oft möchte eine Formatvorlage sicherstellen, dass der Text in allen Menüpunkten linksbündig ausgerichtet ist (oder rechtsbündig für mirrored ). Indem man jedem MenuItem seinen eigenen minimalen Text-Padding für implicitTextPadding zuweist (unter Berücksichtigung von Icons und Häkchen), aber textPadding für die tatsächliche Positionierung des text verwendet, sollten alle MenuItems am Ende ausgerichtet sein.

Damit dies funktioniert, sollten alle MenuItems implicitTextPadding auf den Mindestabstand zwischen dem linken Rand von contentItem und dem Text setzen.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch implicitTextPadding.

Signal Dokumentation

void triggered()

Dieses Signal wird ausgegeben, wenn der Menüpunkt durch den Benutzer ausgelöst wird.

Hinweis: Der entsprechende Handler ist onTriggered.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.