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

Ausführliche Beschreibung

Der Typ „MenuItem“ stellt eine QML-API für native Plattform-Menüelemente bereit.

Ein Menüelement besteht aus einem „ icon “, einem „ text “ und einem „ 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 zu Eigenschaften

checkable : bool

Diese Eigenschaft gibt an, ob das Element markierbar ist.

Ein aktivierbarer Menüpunkt verfügt über einen Ein-/Aus-Zustand. In einem Textverarbeitungsprogramm kann beispielsweise der Menüpunkt „Fett“ entweder aktiviert oder deaktiviert sein. Ein nicht aktivierbarer 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 gilt unabhängig davon, ob das Element aktiviert (eingeschaltet) oder deaktiviert (ausgeschaltet) ist. Der Standardwert lautet „ false “.

Siehe auch „ checkable “ und „ MenuItemGroup “.

enabled : bool

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

Deaktivierte Elemente können vom Benutzer nicht ausgelöst werden. Sie verschwinden nicht aus den Menüs, werden jedoch so dargestellt, dass deutlich wird, dass sie nicht verfügbar sind. Beispielsweise können sie ausschließlich in Graustufen angezeigt werden.

Ist ein Element deaktiviert, kann es nicht über seine „ shortcut “ ausgelöst werden.

font : font

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

Siehe auch „ text “.

group : MenuItemGroup

Diese Eigenschaft enthält die Gruppe, zu der das Element gehört, oder den Wert „ null “, falls das Element keiner Gruppe angehört.

icon group

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

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 den Wert „ null “, falls das Element nicht in einem Menü enthalten ist.

role : enumeration

Diese Eigenschaft gibt die Rolle des Elements an. Die Rolle bestimmt, ob das Element unter macOS im Anwendungsmenü angezeigt werden soll.

Verfügbare Werte:

Die Angabe der Rolle wirkt sich nur auf Einträge aus, die sich in den direkten Menüs einer Menüleiste befinden, nicht jedoch auf Einträge in den Untermenüs dieser Menüs. Wenn Sie beispielsweise ein „Datei“-Menü in Ihrer Menüleiste haben und dieses „Datei“-Menü ein Untermenü enthält, hat die Festlegung einer Rolle für die Einträge in diesem Untermenü keine Auswirkung. Sie werden niemals in das Anwendungsmenü verschoben.

separator : bool

Diese Eigenschaft gibt an, ob es sich bei dem Element um eine Trennlinie handelt. Der Standardwert ist „ false “.

Siehe auch „ MenuSeparator “.

shortcut : keysequence

Diese Eigenschaft enthält die Tastenkombination des Menüpunkts.

Die Tastenkombination kann auf eine der folgenden Tasten gesetzt werden: standard keyboard shortcuts. Alternativ kann sie durch eine Zeichenfolge angegeben werden, die eine Abfolge von bis zu vier Tastenanschlägen enthält, die zum Auslösen der Tastenkombination erforderlich sind: trigger.

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 das Element umfasst, oder den Wert „ null “, falls es sich bei dem Element nicht um ein Untermenüelement handelt.

text : string

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

visible : bool

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

Signal-Dokumentation

hovered()

Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Menüpunkt bewegt wird.

triggered()

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

Methodendokumentation

void toggle()

Schaltet den Status „ checked “ in den entgegengesetzten Status um.