Тип 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.