ActionGroup QML Type

Gruppiert Aktionen. Mehr...

• Liste aller Elemente, einschließlich vererbter Elemente

Eigenschaften

• actions : list<Action>
• checkedAction : Action
• enabled : bool
• exclusive : bool

Zugehörige Eigenschaften

• group : ActionGroup

Signale

• triggered(Action action)

Methoden

• void addAction(Action action)
• void removeAction(Action action)

Ausführliche Beschreibung

Eine ActionGroup ist eine nicht-visuelle Gruppe von Aktionen. Eine „ exclusive “ Aktionsgruppe wird für Aktionen verwendet, bei denen jeweils nur eine der Optionen ausgewählt werden kann.

Die einfachste Art, ActionGroup zu verwenden, besteht darin, Aktionen als untergeordnete Elemente der Gruppe zu deklarieren.

ActionGroup {
    id: alignmentGroup

    Action {
        checked: true
        checkable: true
        text: qsTr("Left")
    }

    Action {
        checkable: true
        text: qsTr("Center")
    }

    Action {
        checkable: true
        text: qsTr("Right")
    }
}

Alternativ ermöglicht die angehängte Eigenschaft „ group “, die Aktionen an anderer Stelle zu deklarieren und sie einer bestimmten Gruppe zuzuweisen.

ActionGroup { id: alignmentGroup }

Action {
    checked: true
    checkable: true
    text: qsTr("Left")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Center")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Right")
    ActionGroup.group: alignmentGroup
}

Fortgeschrittenere Anwendungsfälle lassen sich mit den Methoden „ addAction() “ und „ removeAction() “ umsetzen.

Siehe auch „ Action “ und „ ButtonGroup “.

Dokumentation zu Eigenschaften

actions : list<Action> [default]

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

Siehe auch „ group “.

checkedAction : Action

Diese Eigenschaft enthält die aktuell ausgewählte Aktion in einer exklusiven Gruppe oder den Wert „ null “, falls keine solche Gruppe vorhanden ist oder die Gruppe nicht exklusiv ist.

Standardmäßig ist dies die erste markierte Aktion, die einer exklusiven Aktionsgruppe hinzugefügt wurde.

Siehe auch „ exclusive “.

enabled : bool

Diese Eigenschaft gibt an, ob die Aktionsgruppe aktiviert ist. Der Standardwert lautet „ true “.

Wenn diese Eigenschaft auf „ false “ gesetzt ist, sind alle Aktionen in der Gruppe deaktiviert. Wenn diese Eigenschaft auf „ true “ gesetzt ist, sind alle Aktionen in der Gruppe aktiviert, sofern sie nicht ausdrücklich deaktiviert wurden.

exclusive : bool

Diese Eigenschaft gibt an, ob die Aktionsgruppe exklusiv ist. Der Standardwert lautet „ true “.

Wenn diese Eigenschaft auf „ true “ gesetzt ist, kann zu jedem Zeitpunkt nur eine Aktion in der Gruppe markiert sein. Der Benutzer kann eine beliebige Aktion auslösen, um sie zu markieren, und diese Aktion ersetzt dann die bisherige als markierte Aktion in der Gruppe.

In einer exklusiven Gruppe kann der Benutzer die aktuell markierte Aktion nicht durch Auslösen deaktivieren; stattdessen muss eine andere Aktion in der Gruppe ausgelöst werden, um die neue markierte Aktion für diese Gruppe festzulegen.

In einer nicht-exklusiven Gruppe hat das Aktivieren und Deaktivieren von Aktionen keine Auswirkungen auf die anderen Aktionen in der Gruppe. Darüber hinaus lautet der Wert der Eigenschaft „ checkedAction “ „ null “.

Dokumentation zu den angehängten Eigenschaften

ActionGroup.group : ActionGroup [attached]

Diese Eigenschaft ordnet einer Aktionsgruppe eine Aktion zu.

ActionGroup { id: group }

Action {
    checked: true
    text: qsTr("Option A")
    ActionGroup.group: group
}

Action {
    text: qsTr("Option B")
    ActionGroup.group: group
}

Siehe auch „ actions “.

Signal-Dokumentation

triggered(Action action)

Dieses Signal wird ausgesendet, wenn eine „ action “ in der Gruppe ausgelöst wurde.

Dieses Signal eignet sich gut zur Implementierung eines gemeinsamen Signal-Handlers für alle Aktionen derselben Gruppe.

ActionGroup {
    onTriggered: console.log("triggered:", action.text)

    Action { text: "First" }
    Action { text: "Second" }
    Action { text: "Third" }
}

Siehe auch Action::triggered().

Methodendokumentation

void addAction(Action action)

Fügt der Aktionsgruppe eine „ action “ hinzu.

Siehe auch „ actions “ und „ group “.

void removeAction(Action action)

Entfernt ein „ action “ aus der Aktionsgruppe.

Siehe auch „ actions “ und „ group “.