Тип QML CheckDelegate

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

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

Свойства

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

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

CheckDelegate представляет собой делегат элемента, который можно переключать включено (выбрано) или выключено (не выбрано). Делегаты проверки обычно используются для выбора одного или нескольких вариантов из набора вариантов в списке. Для небольших наборов вариантов или для вариантов, которые необходимо однозначно идентифицировать, следует использовать 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.

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, т.е. делегат имеет только два состояния.