Back to Qt.io
Contact Us Blog Download Qt

ActionGroup QML Type

Fasst Aktionen zusammen. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

QtObject

Eigenschaften

Beigefügte Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

ActionGroup ist eine nicht-visuelle Gruppe von Aktionen. Eine gegenseitige exclusive Aktionsgruppe wird mit Aktionen verwendet, bei denen jeweils nur eine der Optionen ausgewählt werden kann.

Der einfachste Weg, ActionGroup zu verwenden, besteht darin, Aktionen als Kinder 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 dazu ermöglicht die Eigenschaft group attached, die Aktionen an anderer Stelle zu deklarieren und sie einer bestimmten Gruppe zuzuordnen.

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
}

Weitergehende Anwendungsfälle können mit den Methoden addAction() und removeAction() behandelt werden.

Siehe auch Action und ButtonGroup.

Eigenschaft Dokumentation

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 null, wenn es keine gibt oder die Gruppe nicht exklusiv ist.

Standardmäßig ist es die erste überprüfte Aktion, die zu einer exklusiven Aktionsgruppe hinzugefügt wurde.

Siehe auch exclusive.


enabled : bool

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

Wenn diese Eigenschaft false lautet, sind alle Aktionen in der Gruppe deaktiviert. Wenn diese Eigenschaft true lautet, sind alle Aktionen in der Gruppe aktiviert, sofern sie nicht explizit deaktiviert sind.


exclusive : bool

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

Wenn diese Eigenschaft true lautet, kann immer nur eine Aktion in der Gruppe geprüft werden. Der Benutzer kann eine beliebige Aktion auslösen, um sie zu prüfen, und diese Aktion ersetzt die bestehende als die geprüfte Aktion in der Gruppe.

In einer exklusiven Gruppe kann der Benutzer die Markierung der aktuell markierten Aktion nicht aufheben, indem er sie auslöst; stattdessen muss eine andere Aktion in der Gruppe ausgelöst werden, um die neue markierte Aktion für diese Gruppe zu setzen.

In einer nicht-exklusiven Gruppe hat das Markieren und Deaktivieren von Aktionen keine Auswirkungen auf die anderen Aktionen in der Gruppe. Außerdem ist der Wert der Eigenschaft checkedAction null .


Angehängte Eigenschaft Dokumentation

ActionGroup.group : ActionGroup

Diese Eigenschaft fügt eine Aktion an eine Aktionsgruppe an.

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 ausgegeben, wenn eine action in der Gruppe ausgelöst wurde.

Dieses Signal ist praktisch für die Implementierung eines gemeinsamen Signalhandlers für alle Aktionen in derselben Gruppe.

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

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

Hinweis: Der entsprechende Handler ist onTriggered.

Siehe auch Action::triggered().


Methode Dokumentation

void addAction(Action action)

Fügt eine action zur Aktionsgruppe hinzu.

Hinweis: Das manuelle Hinzufügen von Objekten zu einer Aktionsgruppe ist normalerweise nicht notwendig. Die Eigenschaft actions und die angehängte Eigenschaft group bieten eine bequeme und deklarative Syntax.

Siehe auch actions und group.


void removeAction(Action action)

Entfernt ein action aus der Aktionsgruppe.

Hinweis: Das manuelle Entfernen von Objekten aus einer Aktionsgruppe ist in der Regel nicht erforderlich. Die Eigenschaft actions und die angehängte Eigenschaft group bieten eine bequeme und deklarative Syntax.

Siehe auch actions und group.


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