Spec-Zone.ru › Qt 5.9

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

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

Заявление импорта: import QtQuick.Controls 2.2
С: Qt 5.7
Наследует:

ItemDelegate

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

Свойства

  • checkState : перечисление
  • 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 : перечисление

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

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

Константа Описание
Qt.Unchecked Делегат не выбран.
Qt.PartiallyChecked Делегат частично выбран. Это состояние используется только при включенном tristate.
Qt.Checked Делегат выбран.

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

tristate : bool

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

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtquick-controls2-checkdelegate.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API