C
CheckBox QML Type
Check button that can be toggled on or off. More...
Import Statement: | import QtQuick.Controls |
Since: | Qt Quick Ultralite 1.0 |
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.
CheckBox inherits its API from AbstractButton. For instance, the state of the checkbox can be set using 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.
Column { CheckBox { checked: true text: qsTr("First") } CheckBox { text: qsTr("Second") } CheckBox { checked: true text: qsTr("Third") } }
See also Controls Styling and Button Controls.
Property Documentation
checkState : enumeration |
tristate : bool |
This property holds whether the checkbox is a tri-state checkbox.
In the animation below, the first checkbox is tri-state:
The default is false
, that is, the checkbox has only two states.
Available under certain Qt licenses.
Find out more.