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

Это свойство определяет, доступно ли состояние «частично выбрано».

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

Установка checkedState в Qt.PartiallyChecked неявно устанавливает это свойство в true.

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

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