Тип QML CheckDelegate

Делегат элемента с индикатором выбора, который можно переключать включено/выключено. Подробнее...

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

Свойства

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

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

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

CheckDelegate наследует свой API от ItemDelegate, который наследуется от AbstractButton. Например, вы можете установить text и реагировать на нажатия с помощью API AbstractButton. Состояние делегата проверки можно установить с помощью свойства checked.

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

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

См. также Настройка CheckDelegate, Делегатские элементы управления и CheckBox.

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

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

Это свойство определяет состояние проверки делегата проверки.

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

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

[с QtQuick.Controls 2.4 (Qt 5.11)] nextCheckState : функция

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

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

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

CheckDelegate {
    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

Это свойство определяет, имеет ли делегат проверки три состояния.

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

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