CheckDelegate QML Type

オン／オフを切り替え可能なチェックインジケーターを備えた項目デリゲート。詳細...

• 継承されたメンバーを含む、すべてのメンバーのリスト

プロパティ

• checkState : enumeration
• nextCheckState : function (since QtQuick.Controls 2.4 (Qt 5.11))
• tristate : bool

詳細説明

CheckDelegateは、オン（チェック済み）またはオフ（チェックなし）に切り替え可能な項目デリゲートを提供します。チェックデリゲートは通常、リスト内のオプション群から1つまたは複数のオプションを選択するために使用されます。オプションの数が少ない場合や、オプションを一意に識別する必要がある場合は、代わりにCheckBox の使用を検討してください。

CheckDelegateは、ItemDelegate からAPIを継承しており、 はAbstractButton から継承されています。例えば、text を設定し、AbstractButton APIを使用してclicks に反応させることができます。チェックデリゲートの状態は、checked プロパティで設定できます。

チェック済みおよび未チェックの状態に加え、3つ目の状態として「部分的にチェック済み」があります。この状態は、tristate プロパティを使用して有効にできます。この状態は、通常のチェック済み／未チェックの状態を判断できないことを示します。これは通常、チェックデリゲートに影響を与える他の状態が存在するためです。この状態は、たとえばツリービューで複数の子ノードが選択されている場合などに役立ちます。

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

「CheckDelegateのカスタマイズ」、「デリゲート コントロール」、および「CheckBox 」も参照してください 。

プロパティのドキュメント

checkState : enumeration

このプロパティは、チェックデリゲートのチェック状態を決定します。

利用可能な状態：

「 tristate 」および「checked 」も参照してください 。

nextCheckState : function [since QtQuick.Controls 2.4 (Qt 5.11)]

このプロパティには、ユーザーがタッチ、マウス、またはキーボードを介してチェックデリゲートをインタラクティブに切り替えた際に、次のチェック状態を決定するために呼び出されるコールバック関数が格納されます。

デフォルトでは、通常のチェックデリゲートは「Qt.Unchecked 」と「Qt.Checked 」の状態を循環し、3 状態のチェックデリゲートは「Qt.Unchecked 」、「Qt.PartiallyChecked 」、および「Qt.Checked 」の状態を循環します。

nextCheckState コールバック関数を使用すると、デフォルトの挙動を上書きできます。次の例は、外部条件に応じて「部分的にチェック済み」の状態を表示できるが、ユーザーがインタラクティブに切り替えた場合には決して「部分的にチェック済み」の状態に移行しない、3 状態チェックデリゲートを実装しています。

CheckDelegate {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

このプロパティは、QtQuick.Controls 2.4 (Qt 5.11) で導入されました。

tristate : bool

このプロパティは、チェックデリゲートに 3 つの状態があるかどうかを決定します。

以下のアニメーションでは、最初のチェックデリゲートは3状態です:

デフォルトはfalse であり、つまり、デリゲートは2つの状態のみを持ちます。