Тип QML CheckBox

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

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

Свойства

• checkState : перечисление
• tristate : bool

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

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

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

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

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

См. также Настройка CheckBox и Кнопки.

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

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

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

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

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

tristate : bool

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

На анимации ниже первый флажок — трехсостоятельный:

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