CheckBox QML Type

A check box control. More...

Import Statement: import Qt.labs.controls 1.0
Inherits:

AbstractButton

Properties

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:

ConstantDescription
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.