Тип QML CheckBox

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

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

Свойства

• checkedState : int
• partiallyCheckedEnabled : bool

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

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

Состояние флажка можно установить с помощью свойства 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
    }
}

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

Вы можете создать пользовательский вид для флажка, назначив 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.