MenuItem QML Type

Zeigt einen Eintrag in einem Menü an. Mehr...

• Liste aller Elemente, einschließlich vererbter Elemente

Eigenschaften

• 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)

Signale

• void triggered()

Ausführliche Beschreibung

„MenuItem“ ist ein Komforttyp, der die „ AbstractButton “-API implementiert und eine vertraute Möglichkeit bietet, beispielsweise auf die Auswahl von Menüelementen („ triggered “) zu reagieren.

MenuItem erbt seine API von „ AbstractButton “. So können Sie beispielsweise „ text “ und das Symbol mithilfe der API „ AbstractButton “ festlegen.

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“.

Dokumentation zu den Eigenschaften

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

Diese Eigenschaft enthält das Pfeilsymbol für das Untermenü.

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 markiert ist.

Ein Menüpunkt kann durch Bewegen des Mauszeigers oder per Tastaturnavigation markiert werden.

Der Standardwert lautet „ false “.

Siehe auch „ Menu::currentIndex “.

implicitTextPadding : real [since 6.8]

Diese Eigenschaft gibt den Mindestabstand vom linken Rand des „ contentItem “ zum Text an. Sie wird verwendet, um einen gemeinsamen „ textPadding “ für alle „MenuItems“ innerhalb eines „ 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ü, in dem sich dieser Menüpunkt befindet, oder den Wert „ null “, falls der Menüpunkt nicht in einem Menü enthalten 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 dieses Element im übergeordneten Menü anzeigt, oder den Wert „ null “, falls dieses Element kein Untermenüelement ist.

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

textPadding : real [read-only, since 6.8]

Diese Eigenschaft enthält den maximalen implicitTextPadding, der unter allen Menüelementen innerhalb desselben menu gefunden wurde.

Diese Eigenschaft kann vom Stil verwendet werden, um sicherzustellen, dass alle „MenuItems“ innerhalb desselben Menüs in Bezug auf den „ text “ ausgerichtet sind.

Ein „ Menu “ kann aus vielen verschiedenen „MenuItems“ bestehen, von denen einige aktivierbar sein können, andere ein Symbol haben und wieder andere lediglich Text enthalten. Sehr häufig möchte ein Stil sicherstellen, dass der Text in allen Elementen linksbündig ausgerichtet ist (bzw. rechtsbündig bei „ mirrored “-Elementen). Indem jedes „ MenuItem “ seinen eigenen minimalen Textabstand über „ implicitTextPadding “ festlegt (unter Berücksichtigung von Symbolen und Häkchen), aber „textPadding“ verwendet, um den „ text “ tatsächlich zu positionieren, sollten alle „MenuItems“ am Ende ausgerichtet sein

Damit dies funktioniert, sollten alle MenuItems „ implicitTextPadding “ auf den minimalen Abstand setzen, der vom linken Rand des „ contentItem “ bis zum Text benötigt wird.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch „ implicitTextPadding “.

Signal-Dokumentation

void triggered()

Dieses Signal wird ausgelöst, wenn der Menüpunkt vom Benutzer aufgerufen wird.