CheckBox QML Type

オン・オフを切り替えられるチェック・ボタン。もっと見る...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

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

詳細説明

CheckBox は、オン (チェック済み) またはオフ (チェックなし) に切り替えられるオプション・ボタンを表示します。チェックボックスは通常、一連のオプションから1つ以上のオプションを選択するために使用されます。リ ス ト 内の よ う な大 き なオプシ ョ ン群の場合は、 かわ り にCheckDelegate を使用す る こ と を考慮 し て く だ さ い。

チェックボックスは、そのAPIをAbstractButton から継承しています。例えば、チェックボックスの状態はchecked プロパティで設定できます。

checkedとuncheckedに加え、第3の状態としてpartially checkedがあります。部分的にチェックされた状態は、tristate プロパティを使用して有効にすることができます。この状態は、一般的にチェックボックスに影響を与える他の状態があるため、通常のチェック済み/未チェック状態を決定できないことを示します。この状態は、ツリービューで複数の子ノードが選択されている場合などに便利です。

ColumnLayout {
    CheckBox {
        checked: true
        text: qsTr("First")
    }
    CheckBox {
        text: qsTr("Second")
    }
    CheckBox {
        checked: true
        text: qsTr("Third")
    }
}

階層化されたチェックボックスグループは、非排他的ButtonGroup で管理できます。

次の例は、子ノードのチェック状態を親チェックボックスのチェック状態に結合する方法を示しています：

Column {
    ButtonGroup {
        id: childGroup
        exclusive: false
        checkState: parentBox.checkState
    }

    CheckBox {
        id: parentBox
        text: qsTr("Parent")
        checkState: childGroup.checkState
    }

    CheckBox {
        checked: true
        text: qsTr("Child 1")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }

    CheckBox {
        text: qsTr("Child 2")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }
}

チェックボックス、ButtonGroup 、ボタンコントロールのカスタマイズも参照してください 。

プロパティの説明

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

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

tristate : bool

このプロパティは、チェックボックスがトライステートチェックボックスであるかどうかを保持します。

下のアニメーションでは、最初のチェックボックスがトライステートです：

デフォルトはfalse で、チェックボックスは2つの状態しか持ちません。