Back to Qt.io
Contact Us Blog Download Qt

ActionGroup QML Type

アクションをグループ化します。詳細...

Import Statement: import QtQuick.Controls
Inherits:

QtObject

プロパティ

付属プロパティ

シグナル

メソッド

詳細説明

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も参照してください 。

プロパティ Documentation

actions : list<Action> [default]

このプロパティは、グループ内のアクションのリストを保持します。

groupも参照して ください。


checkedAction : Action

このプロパティは、排他的グループで現在選択されているアクションを保持します。排他的グループがない場合、またはグループが非排他的である場合は、null 。

デフォルトでは、排他的アクショングループに追加された最初のチェックされたアクションです。

exclusiveも参照のこと 。


enabled : bool

このプロパティは、アクショングループが有効かどうかを保持する。デフォルト値はtrue である。

このプロパティがfalse の場合、グループ内のすべてのアクションは無効である。このプロパティがtrue の場合、明示的に無効化されない限り、グループ内のすべてのアクションが有効化される。


exclusive : bool

このプロパティは、アクショングループが排他的であるかどうかを保持する。デフォルト値はtrue である。

このプロパティがtrue の場合、グループ内の1つのアクションのみが常にチェック可能である。ユーザは任意のアクションをトリガしてそれをチェックすることができ、そのアクションはグループ内のチェックされたアクションとして既存のアクションを置き換える。

排他的グループでは、ユーザーは現在チェックされているアクションをトリガーしてチェックを外すことはできない。

非排他的グループでは、アクションのチェックやチェックの解除は、グループ内の他のアクションに影響を与えない。さらに、checkedAction プロパティの値はnull です。


Attached プロパティの説明

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も参照してください 。


Signal ドキュメンテーション

triggered(Action action)

このシグナルは、グループ内のaction がトリガーされたときに発せられます。

このシグナルは、同じグループ内のすべてのアクションに共通のシグナルハンドラを実装するのに便利です。

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

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

注意: 対応するハンドラはonTriggered 。

Action::triggered()も参照してください 。


メソッドの説明

void addAction(Action action)

アクショングループにaction を追加します。

メモ： アクション・グループにオブジェクトを手動で追加することは通常不要です。actions プロパティとgroup attached プロパティは、便利で宣言的な構文を提供します。

actions とgroupも参照してください 。


void removeAction(Action action)

action をアクショングループから削除する。

注意： アクション・グループからオブジェクトを手動で削除することは通常不要です。actions プロパティとgroup attached プロパティは、便利で宣言的な構文を提供します。

actions とgroupも参照してください 。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。