MenuItem QML Type

Ein nativer Menüpunkt. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• checkable : bool
• checked : bool
• enabled : bool
• font : font
• group : MenuItemGroup
• icon (since Qt.labs.platform 1.1 (Qt 5.12))
  • 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))
• menu : Menu
• role : enumeration
• separator : bool
• shortcut : keysequence
• subMenu : Menu
• text : string
• visible : bool

Signale

• hovered()
• triggered()

Methoden

• void toggle()

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

Siehe auch Menu und MenuItemGroup.

Dokumentation der Eigenschaften

checkable : bool

Diese Eigenschaft gibt an, ob der Eintrag ankreuzbar 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 das Element angekreuzt (on) oder nicht angekreuzt (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 vom 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 seine shortcut ausgelöst 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 das Element gehört, oder null, wenn das Element nicht in einer Gruppe ist.

icon group

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

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

Diese Eigenschaften wurden in Qt.labs.platform 1.1 (Qt 5.12) eingeführt.

Siehe auch QIcon::fromTheme().

menu : Menu [read-only]

Diese Eigenschaft enthält das Menü, zu dem das Element gehört, oder null, wenn sich das Element nicht in einem Menü befindet.

role : enumeration

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

Verfügbare Werte:

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 festgelegt werden, oder sie kann durch eine Zeichenkette angegeben werden, die eine Folge von bis zu vier Tastendrücken enthält, die erforderlich sind, um trigger die Tastenkombination zu erreichen.

Der Standardwert ist eine leere Tastenfolge.

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

subMenu : Menu [read-only]

Diese Eigenschaft enthält das Untermenü, das der Eintrag enthält, oder null, wenn der Eintrag kein Untermenüeintrag ist.

text : string

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

visible : bool

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

Signal Dokumentation

hovered()

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

triggered()

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

Dokumentation der Methode

void toggle()

Schaltet den Zustand von checked in den entgegengesetzten Zustand um.