Тип делегата CheckDelegate QML

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

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

Свойства

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

На анимации ниже, первый checkdelegate — три-состояние:

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