このページでは

C

CheckBox QML Type

オン/オフを切り替えられるチェックボタン。詳細...

Import Statement: import QtQuick.Controls
Since: Qt Quick Ultralite 1.0
Inherits:

AbstractButton

プロパティ

詳細説明

CheckBoxは、オン(チェック済み)またはオフ(チェックなし)に切り替え可能なオプションボタンを表します。チェックボックスは通常、一連の選択肢の中から1つまたは複数の選択肢を選択するために使用されます。

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

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

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

「コントロールのスタイル設定」および「ボタンコントロールも参照してください

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

checkState : Qt::CheckState

このプロパティは、チェックボックスのチェック状態を保持します。

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

tristate : bool [default]

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

以下のアニメーションでは、最初のチェックボックスが3状態のチェックボックスとなっています:

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

特定のQtライセンスの下で利用可能です。
詳細はこちら。