CheckBox QML Type

A check box control. More...

Import Statement: import Qt.labs.controls 1.0



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.

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")

Note: Types in the Qt.labs module are not guaranteed to remain compatible in future versions.

See also Customizing CheckBox and Button Controls.

Property Documentation

checkState : enumeration

This property holds the check state of the checkbox.

Available states:

Qt.UncheckedThe checkbox is unchecked.
Qt.PartiallyCheckedThe checkbox is partially checked. This state is only used when tristate is enabled.
Qt.CheckedThe checkbox is checked.

See also tristate and checked.

tristate : bool

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

The default is false, i.e., the checkbox has only two states.

© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.