Тип QML CheckBox

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

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

Свойства

• activeFocusOnPress : bool
• checked : bool
• checkedState : int
• exclusiveGroup : ExclusiveGroup
• hovered : bool
• partiallyCheckedEnabled : bool
• pressed : bool
• style : Component
• text : string
• tooltip : 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.

text : string

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

tooltip : string

Это свойство содержит всплывающую подсказку кнопки.

Это свойство QML было добавлено в QtQuick.Controls 1.7.

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

clicked()

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