Тип QML CheckBox

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

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

Свойства

• activeFocusOnPress : bool
• checked : bool
• checkedState : int
• exclusiveGroup : ExclusiveGroup
• hovered : bool
• partiallyCheckedEnabled : bool
• pressed : bool
• style : Component
• text : string

Сигналы

• clicked()

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

Флажок 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.

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

activeFocusOnPress : bool

Это свойство true если элемент получает фокус при нажатии; forceActiveFocus() будет вызван для элемента.

checked : bool

Это свойство true если элемент выбран.

checkedState : int

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

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

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

exclusiveGroup : ExclusiveGroup

Это свойство хранит ExclusiveGroup, к которому принадлежит элемент.

[только для чтения] hovered : bool

Это свойство указывает, находится ли элемент под курсором.

partiallyCheckedEnabled : bool

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

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

Установка checkedState в Qt.PartiallyChecked неявным образом установит это свойство в true.

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

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

pressed : bool

Это свойство true если элемент нажат. Установите это свойство, чтобы вручную вызвать щелчок мыши.

style : Component

Стиль Component для этого элемента.

См. также Типы QML Qt Quick Controls Styles.

text : string

Это свойство содержит текст, который должна отображать метка.

Документация сигналов

clicked()

Вызывается всякий раз, когда элемент нажимается.