Тип QML CheckBox

Кнопка выбора, которую можно переключать включено/выключено. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• checkState : перечисление
• nextCheckState : функция
• tristate : bool

Подробное описание

CheckBox представляет собой кнопку выбора, которую можно переключать в состояние включено (отмечено) или выключено (не отмечено). Кнопки выбора обычно используются для выбора одного или нескольких вариантов из набора вариантов. Для больших наборов вариантов, таких как в списке, рассмотрите использование CheckDelegate вместо этого.

CheckBox наследует свой API от AbstractButton. Например, состояние CheckBox можно установить с помощью свойства checked.

Помимо состояний включено и выключено, существует третье состояние: частично включено. Состояние частично включено можно включить с помощью свойства tristate. Это состояние указывает, что обычное состояние включено/выключено нельзя определить; обычно из-за других состояний, которые влияют на CheckBox. Это состояние полезно, например, когда несколько дочерних узлов выбраны в дереве.

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

Иерархические группы checkboxes можно управлять с помощью неисключительной ButtonGroup.

Следующий пример демонстрирует, как комбинированное состояние выбора дочерних элементов может быть привязано к состоянию выбора родительского checkbox:

Column {
    ButtonGroup {
        id: childGroup
        exclusive: false
        checkState: parentBox.checkState
    }

    CheckBox {
        id: parentBox
        text: qsTr("Parent")
        checkState: childGroup.checkState
    }

    CheckBox {
        checked: true
        text: qsTr("Child 1")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }

    CheckBox {
        text: qsTr("Child 2")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }
}

См. также Настройка CheckBox, ButtonGroup и Кнопки управления.

Документация по свойствам

checkState : перечисление

Это свойство содержит состояние выбора checkbox.

Доступные состояния:

См. также tristate и checked.

nextCheckState : функция

Это свойство содержит функцию обратного вызова, которая вызывается для определения следующего состояния выбора, когда пользователь интерактивно переключает CheckBox с помощью касания, мыши или клавиатуры.

По умолчанию обычный checkbox циклически переключается между состояниями Qt.Unchecked и Qt.Checked, а checkbox со тремя состояниями циклически переключается между состояниями Qt.Unchecked, Qt.PartiallyChecked, и Qt.Checked.

Функция обратного вызова nextCheckState может переопределять стандартное поведение. Следующий пример реализует checkbox с тремя состояниями, который может представлять частично отмеченное состояние в зависимости от внешних условий, но никогда не переключается в частично отмеченное состояние при интерактивном переключении пользователем.

CheckBox {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

Это свойство было введено в QtQuick.Controls 2.4 (Qt 5.11).

tristate : bool

Это свойство указывает, является ли checkbox checkbox с тремя состояниями.

На анимации ниже первый checkbox имеет три состояния:

По умолчанию false, т.е. checkbox имеет только два состояния.