Тип 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, назначив стили 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.