Back to Qt.io
Contact Us Blog Download Qt

MenuItemGroup QML Type

Eine Gruppe für die Verwaltung nativer Menüpunkte. Mehr...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Die MenuItemGroup gruppiert native Menüpunkte zusammen.

MenuItemGroup ist standardmäßig exklusiv. In einer exklusiven Menüpunktgruppe kann immer nur ein Punkt markiert werden; die Markierung eines anderen Punktes hebt automatisch die Markierung des vorher markierten Punktes auf. MenuItemGroup kann als nicht-exklusiv konfiguriert werden, was besonders nützlich ist, um Elemente gemeinsam als Gruppe anzuzeigen, auszublenden, zu aktivieren und zu deaktivieren.

Die einfachste Art, MenuItemGroup zu verwenden, ist die Zuweisung einer Liste von Elementen.

Menu {
    id: verticalMenu
    title: qsTr("Vertical")

    MenuItemGroup {
        id: verticalGroup
        items: verticalMenu.items
    }

    MenuItem { text: qsTr("Top"); checkable: true }
    MenuItem { text: qsTr("Center"); checked: true }
    MenuItem { text: qsTr("Bottom"); checkable: true }
}

Ein und dasselbe Menü kann manchmal Elemente enthalten, die nicht in dieselbe exklusive Gruppe aufgenommen werden sollten. Solche Fälle werden am besten mit der Eigenschaft group behandelt.

Menu {
    id: horizontalMenu
    title: qsTr("Horizontal")

    MenuItemGroup {
        id: horizontalGroup
    }

    MenuItem {
        checked: true
        text: qsTr("Left")
        group: horizontalGroup
    }
    MenuItem {
        checkable: true
        text: qsTr("Center")
        group: horizontalGroup
    }
    MenuItem {
        text: qsTr("Right")
        checkable: true
        group: horizontalGroup
    }

    MenuItem { separator: true }
    MenuItem { text: qsTr("Justify"); checkable: true }
    MenuItem { text: qsTr("Absolute"); checkable: true }
}

Fortgeschrittenere Anwendungsfälle können mit den Methoden addItem() und removeItem() behandelt werden.

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

Siehe auch MenuItem.

Eigenschaft Dokumentation

checkedItem : MenuItem

Diese Eigenschaft enthält das aktuell markierte Element in der Gruppe, oder null, wenn kein Element markiert ist.


enabled : bool

Diese Eigenschaft gibt an, ob die Gruppe aktiviert ist. Der Standardwert ist true.

Der Aktivierungsstatus der Gruppe wirkt sich auf den Aktivierungsstatus jedes Elements in der Gruppe aus, mit der Ausnahme, dass explizit deaktivierte Elemente nicht aktiviert werden, selbst wenn die Gruppe aktiviert ist.


exclusive : bool

Diese Eigenschaft gibt an, ob die Gruppe exklusiv ist. Der Standardwert ist true.

In einer exklusiven Menüpunktgruppe kann immer nur ein Punkt markiert werden; die Markierung eines anderen Punktes hebt automatisch die Markierung des zuvor markierten Punktes auf.


items : list<MenuItem>

Diese Eigenschaft enthält die Liste der Elemente in der Gruppe.


visible : bool

Diese Eigenschaft gibt an, ob die Gruppe sichtbar ist. Der Standardwert ist true.

Die Sichtbarkeit der Gruppe wirkt sich auf die Sichtbarkeit der einzelnen Elemente in der Gruppe aus, mit der Ausnahme, dass explizit ausgeblendete Elemente nicht sichtbar sind, auch wenn die Gruppe sichtbar ist.


Signal Dokumentation

hovered(MenuItem item)

Dieses Signal wird ausgegeben, wenn ein item in der Gruppe vom Benutzer mit dem Mauszeiger bewegt wird.

Hinweis: Der entsprechende Handler ist onHovered.

Siehe auch MenuItem::hovered().


triggered(MenuItem item)

Dieses Signal wird ausgegeben, wenn ein item in der Gruppe durch den Benutzer ausgelöst wird.

Hinweis: Der entsprechende Handler ist onTriggered.

Siehe auch MenuItem::triggered().


Methode Dokumentation

void addItem(MenuItem item)

Fügt ein item zur Gruppe hinzu.


void clear()

Entfernt alle Elemente aus der Gruppe.


void removeItem(MenuItem item)

Entfernt ein item aus der Gruppe.


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