CheckBox QML Type
An option button that can be checked or unchecked. More...
| Import Statement: | import QtQuick.Controls 2.0 |
| Since: | Qt 5.7 |
| Inherits: |
Properties
- checkState : enumeration
- tristate : bool
Detailed Description
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.
The state of the checkbox can be set with the checked property.
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.
| A check box in its normal state. |
| A check box that is checked. |
| A check box that has active focus. |
| A check box that is disabled. |
ColumnLayout {
CheckBox {
checked: true
text: qsTr("First")
}
CheckBox {
text: qsTr("Second")
}
CheckBox {
checked: true
text: qsTr("Third")
}
}
See also Customizing CheckBox and Button Controls.
Property Documentation
This property holds whether the checkbox is a tri-state checkbox.
The default is false, i.e., the checkbox has only two states.



