Back to Qt.io
Contact Us Blog Download Qt

MenuItem QML Type

Ein nativer Menüpunkt. Mehr...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

MenuSeparator

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Der MenuItem-Typ bietet eine QML-API für plattformeigene Menüpunkte.

Ein Menüpunkt besteht aus einem icon, text und shortcut.

Menu {
    id: zoomMenu

    MenuItem {
        text: qsTr("Zoom In")
        shortcut: StandardKey.ZoomIn
        onTriggered: zoomIn()
    }

    MenuItem {
        text: qsTr("Zoom Out")
        shortcut: StandardKey.ZoomOut
        onTriggered: zoomOut()
    }
}

Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

Siehe auch Menu und MenuItemGroup.

Eigenschaft Dokumentation

checkable : bool

Diese Eigenschaft gibt an, ob der Eintrag überprüfbar ist.

Ein überprüfbarer Menüpunkt hat einen Ein/Aus-Status. In einem Textverarbeitungsprogramm kann z. B. der Menüpunkt "Fett" entweder ein- oder ausgeschaltet sein. Ein nicht überprüfbarer Menüpunkt ist ein Befehl, der einfach ausgeführt wird, z. B. "Datei speichern".

Der Standardwert ist false.

Siehe auch checked und MenuItemGroup.


checked : bool

Diese Eigenschaft gibt an, ob der Eintrag markiert (on) oder nicht markiert (off) ist. Der Standardwert ist false.

Siehe auch checkable und MenuItemGroup.


enabled : bool

Diese Eigenschaft gibt an, ob das Element aktiviert ist. Der Standardwert ist true.

Deaktivierte Elemente können nicht durch den Benutzer ausgelöst werden. Sie verschwinden nicht aus den Menüs, aber sie werden so angezeigt, dass sie nicht verfügbar sind. Sie können zum Beispiel nur in Grautönen angezeigt werden.

Wenn ein Element deaktiviert ist, kann es nicht über shortcut aufgerufen werden.


font : font

Diese Eigenschaft enthält die Schriftart des Menüeintrags.

Siehe auch text.


group : MenuItemGroup

Diese Eigenschaft enthält die Gruppe, zu der der Eintrag gehört, oder null, wenn der Eintrag nicht in einer Gruppe ist.


icon group

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

Diese Eigenschaft enthält das Symbol des Menüpunkts.

MenuItem {
    icon.mask: true
    icon.name: "edit-undo"
    icon.source: "qrc:/images/undo.png"
}

Diese QML-Eigenschaft wurde in Qt.labs.platform 1.1 (Qt 5.12) eingeführt.

Siehe auch QIcon::fromTheme().


Diese Eigenschaft enthält das Menü, zu dem der Eintrag gehört, oder null, wenn der Eintrag nicht in einem Menü ist.


role : enumeration

Diese Eigenschaft enthält die Rolle des Eintrags. Die Rolle bestimmt, ob das Element in das Anwendungsmenü unter macOS eingefügt werden soll.

Verfügbare Werte:

KonstanteBeschreibung
MenuItem.NoRoleDer Eintrag soll nicht in das Anwendungsmenü aufgenommen werden
MenuItem.TextHeuristicRoleDer Eintrag soll in das Anwendungsmenü aufgenommen werden, basierend auf dem Text der Aktion (Standard)
MenuItem.ApplicationSpecificRoleDer Eintrag soll mit einer anwendungsspezifischen Rolle in das Anwendungsmenü aufgenommen werden
MenuItem.AboutQtRoleDer Eintrag behandelt den Menüpunkt "Über Qt".
MenuItem.AboutRoleDer Eintrag sollte dort platziert werden, wo sich der Menüpunkt "Über" im Anwendungsmenü befindet. Der Text des Menüpunkts wird auf "Über <Anwendungsname>" gesetzt. Der Name der Anwendung wird aus der Datei Info.plist im Paket der Anwendung geholt (siehe Qt für macOS - Bereitstellung).
MenuItem.PreferencesRoleDer Eintrag sollte dort platziert werden, wo sich der Menüpunkt "Einstellungen..." im Anwendungsmenü befindet.
MenuItem.QuitRoleDer Eintrag sollte dort platziert werden, wo sich der Menüpunkt "Beenden" im Anwendungsmenü befindet.

Die Angabe der Rolle wirkt sich nur auf Elemente aus, die sich in den direkten Menüs einer Menüleiste befinden, nicht aber in den Untermenüs dieser Menüs. Wenn Sie z. B. ein Menü "Datei" in Ihrer Menüleiste haben und das Menü "Datei" ein Untermenü hat, hat die Angabe einer Rolle für die Einträge in diesem Untermenü keine Auswirkungen. Sie werden niemals in das Anwendungsmenü verschoben.


separator : bool

Diese Eigenschaft gibt an, ob das Element eine Trennlinie ist. Der Standardwert ist false.

Siehe auch MenuSeparator.


shortcut : keysequence

Diese Eigenschaft enthält die Tastenkombination für den Menüpunkt.

Die Tastenkombination kann auf eine der standard keyboard shortcuts gesetzt werden, oder sie kann durch eine Zeichenkette angegeben werden, die eine Folge von bis zu vier Tastendrücken enthält, die erforderlich sind, um die Tastenkombination trigger zu erreichen.

Der Standardwert ist eine leere Tastenfolge.

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

Diese Eigenschaft enthält das Untermenü, das der Eintrag enthält, oder null, wenn es sich nicht um einen Untermenüeintrag handelt.


text : string

Diese Eigenschaft enthält den Text des Menüeintrags.


visible : bool

Diese Eigenschaft gibt an, ob der Eintrag sichtbar ist. Der Standardwert ist true.


Signal Dokumentation

hovered()

Dieses Signal wird ausgegeben, wenn der Benutzer den Mauszeiger über den Menüpunkt bewegt.

Hinweis: Der entsprechende Handler ist onHovered.


triggered()

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

Hinweis: Der entsprechende Handler ist onTriggered.


Methode Dokumentation

void toggle()

Schaltet den Zustand von checked in den entgegengesetzten Zustand um.


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