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 アクショングループは、一度に1つのオプションしか選択できないアクションで使用されます。

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 attached プロパティによって、アクションを別の場所で宣言し、特定のグループに割り当てることもできます。

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 の場合、グループ内の1つのアクショ ンのみをいつでもチェックすることができる。ユーザは任意のアクションをトリガしてそれをチェックすることができ、そのアクションはグループ内のチェックされたアクションとして既存のアクションを置き換える。

排他的グループでは、ユーザーは現在チェックされているアクションをトリガーしてチェッ ク解除することはできない。代わりに、グループ内の別のアクションをトリガーして、そ のグループの新しいチェック済みアクションを設定しなければならない。

非排他的グループでは、アクションのチェックやチェックの解除は、グループ内の他のアクションに影響を与えない。さらに、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も参照してください 。