Тип QML CheckBox

Флажок с текстовой меткой. Подробнее...

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

Свойства

• checkedState : int
• partiallyCheckedEnabled : bool

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

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

Состояние флажка можно установить с помощью свойства checked.

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

Состояние "частично выбрано" может быть доступно пользователю, установив partiallyCheckedEnabled в true, или установить его напрямую, установив checkedState в Qt.PartiallyChecked. checkedState ведет себя идентично checked, когда partiallyCheckedEnabled — false; установка одного из них соответствующим образом установит другой.

Метка отображается рядом с флажком, и вы можете установить текст метки, используя свойство text.

Column {
    CheckBox {
        text: qsTr("Breakfast")
        checked: true
    }
    CheckBox {
        text: qsTr("Lunch")
    }
    CheckBox {
        text: qsTr("Dinner")
        checked: true
    }
}

Всякий раз, когда нажимается флажок CheckBox, генерируется сигнал clicked().

Вы можете создать пользовательский вид для флажка CheckBox, назначив стиль CheckBoxStyle.

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

checkedState : int

Это свойство указывает текущее состояние "выбрано" флажка.

Возможные значения: Qt.UnChecked — флажок не выбран (по умолчанию). Qt.Checked — флажок выбран. Qt.PartiallyChecked — флажок находится в состоянии частичного выбора (или "смешанном").

Свойство checked также определяет, является ли это свойство Qt.Checked или Qt.UnChecked, и наоборот.

partiallyCheckedEnabled : bool

Это свойство определяет, доступно ли состояние Qt.PartiallyChecked.

Флажок может находиться в состоянии частичного выбора, когда обычное состояние выбора не может быть определено.

Установка checkedState в Qt.PartiallyChecked неявно установит это свойство в true.

Если это свойство true, checked будет false.

По умолчанию это свойство false.