ActionGroup QML Type

将行动分组。更多

• 所有成员（包括继承成员）的列表

属性

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

附属物业

• group : ActionGroup

信号

• triggered(Action action)

方法

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

详细说明

ActionGroup 是一个非可视的操作组。互为exclusive 的动作组用于一次只能选择其中一个选项的动作。

使用 ActionGroup 的最直接方法是将操作声明为组的子操作。

ActionGroup {
    id: alignmentGroup

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

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

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

另外，group 附加属性允许在其他地方声明操作，并将其分配给特定组。

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
}

使用addAction() 和removeAction() 方法可以处理更高级的用例。

另请参阅 Action 和ButtonGroup 。

属性文档

actions : list<Action> [default]

该属性包含组中的操作列表。

另请参阅 group 。

checkedAction : Action

该属性保存当前在排他性组中选择的操作，如果没有该操作或该组是非排他性的，则保存null 。

默认情况下，它是添加到排他性操作组中的第一个被选中的操作。

另请参阅 exclusive 。

enabled : bool

该属性表示是否启用了操作组。默认值为true 。

如果该属性为false ，则组中的所有操作都被禁用。如果此属性为true ，除非明确禁用，否则组中的所有操作都将启用。

exclusive : bool

该属性用于确定行动组是否具有排他性。默认值为true 。

如果该属性为true ，则在任何时候都只能检查组中的一个动作。用户可以触发任何动作来选中它，该动作将取代现有动作，成为组中已选中的动作。

在排他性组中，用户不能通过触发当前已选中的操作来取消选中；相反，必须触发组中的另一个操作来为该组设置新的已选中操作。

在非排他性组中，选中和取消选中操作不会影响组中的其他操作。此外，checkedAction 属性的值是null 。

附加属性文档

ActionGroup.group : ActionGroup

此属性可将动作附加到动作组。

ActionGroup { id: group }

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

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

另请参阅 actions 。

信号文档

triggered(Action action)

当组中的action 被触发时，就会发出该信号。

该信号便于为同组中的所有操作实施通用信号处理程序。

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

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

另请参阅 Action::triggered() 。

方法文档

void addAction(Action action)

将action 添加到操作组。

另请参阅 actions 和group 。

void removeAction(Action action)

从操作组中删除action 。

另请参阅 actions 和group 。