MenuItemGroup QML Type

Eine Gruppe zur Verwaltung nativer Menüelemente. Mehr...

• Liste aller Elemente, einschließlich der vererbten Elemente

Eigenschaften

• checkedItem : MenuItem
• enabled : bool
• exclusive : bool
• items : list<MenuItem>
• visible : bool

Signale

• hovered(MenuItem item)
• triggered(MenuItem item)

Methoden

• void addItem(MenuItem item)
• void clear()
• void removeItem(MenuItem item)

Ausführliche Beschreibung

Die MenuItemGroup fasst native Menüelemente zusammen.

MenuItemGroup ist standardmäßig exklusiv. In einer exklusiven Menüelementgruppe kann jeweils nur ein Element ausgewählt sein; wird ein anderes Element ausgewählt, wird das zuvor ausgewählte automatisch abgewählt. MenuItemGroup kann als nicht-exklusiv konfiguriert werden, was besonders nützlich ist, um Elemente gemeinsam als Gruppe ein- und auszublenden sowie zu aktivieren und zu deaktivieren.

Die einfachste Art, „MenuItemGroup“ zu verwenden, besteht darin, eine Liste von Elementen zuzuweisen.

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

Manchmal enthält dasselbe Menü Elemente, die nicht in derselben exklusiven Gruppe enthalten sein sollten. Solche Fälle lassen sich am besten mithilfe der Eigenschaft „ group “ handhaben.

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 lassen sich mit den Methoden „ addItem()“ und „ removeItem()“ handhaben.

Siehe auch „ MenuItem “.

Dokumentation zur Eigenschaft

checkedItem : MenuItem

Diese Eigenschaft enthält das aktuell markierte Element in der Gruppe oder den Wert „ null “, falls kein Element markiert ist.

enabled : bool

Diese Eigenschaft gibt an, ob die Gruppe aktiviert ist. Der Standardwert lautet „ 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 es sich um eine exklusive Gruppe handelt. Der Standardwert lautet „ true “.

In einer exklusiven Menüelementgruppe kann jeweils nur ein Element ausgewählt sein; wird ein anderes Element ausgewählt, wird das zuvor ausgewählte automatisch abgewählt.

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 lautet „ true “.

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

Signal-Dokumentation

hovered(MenuItem item)

Dieses Signal wird ausgelöst, wenn der Mauszeiger des Benutzers über ein „ item “ in der Gruppe bewegt wird.

Siehe auch MenuItem::hovered().

triggered(MenuItem item)

Dieses Signal wird ausgesendet, wenn ein „ item “ in der Gruppe vom Benutzer ausgelöst wird.

Siehe auch MenuItem::triggered().

Methodendokumentation

void addItem(MenuItem item)

Fügt der Gruppe einen „ item “ hinzu.

void clear()

Entfernt alle Elemente aus der Gruppe.

void removeItem(MenuItem item)

Entfernt ein „ item “ aus der Gruppe.