CheckBox QML Type

Check button that can be toggled on or off. 更多...

导入语句: import QtQuick.Controls .
Since: Qt Quick Ultralite 1.0




CheckBox presents an option button that can be toggled on (checked) or off (unchecked). Check boxes are typically used to select one or more options from a set of options.

CheckBox inherits its API from AbstractButton . For instance, the state of the checkbox can be set using the checked 特性。

In addition to the checked and unchecked states, there is a third state: partially checked. The partially checked state can be enabled using the tristate property. This state indicates that the regular checked/unchecked state can not be determined; generally because of other states that affect the checkbox. This state is useful when several child nodes are selected in a treeview, for example.

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

另请参阅 Controls Styling and 按钮控件 .


checkState : enumeration

This property holds the check state of the checkbox.

Available states:

常量 描述
Qt.Unchecked The checkbox is unchecked.
Qt.PartiallyChecked The checkbox is partially checked. This state is only used when tristate is enabled.
Qt.Checked The checkbox is checked.

另请参阅 tristate and checked .

tristate : bool

This property holds whether the checkbox is a tri-state checkbox.

In the animation below, the first checkbox is tri-state:

默认为 false , that is, the checkbox has only two states.