C

复选框 QML 类型

可以打开或关闭的复选按钮。 更多信息...

导入语句import QtQuick.Controls
自Qt Quick Ultralite 1.0
继承

AbstractButton

属性

详细描述

复选框显示一个可以打开（选中）或关闭（未选中）的选项按钮。复选框通常用于从一组选项中选择一个或多个选项。

复选框从 AbstractButton 继承其 API。例如，可以使用 checked 属性设置复选框的状态。

除了选中和不选中状态外，还有第三个状态：部分选中。可以通过使用 tristate 属性来启用部分选中状态。此状态表明常规的选中/未选中状态无法确定；通常因为其他影响复选框的状态。当在树视图中选择了多个子节点时，此状态很有用。

Column {
    CheckBox {
        checked: true
        text: qsTr("First")
    }
    CheckBox {
        text: qsTr("Second")
    }
    CheckBox {
        checked: true
        text: qsTr("Third")
    }
}

另请参阅 控件样式 和 按钮控件。

属性文档

checkState : 枚举型

此属性保留复选框的选中状态。

可用状态

常数描述
Qt.Unchecked复选框未被选中。
Qt.PartiallyChecked复选框部分选中。此状态仅在 tristate 启用时使用。
Qt.Checked复选框被选中。

另请参阅 tristate 和 checked。


tristate : 布尔型

此属性保留复选框是否为三态复选框。

在下述动画中，第一个复选框是三态的

默认值为 false，即复选框只有两个状态。


在一定的 Qt 许可下可用。
了解更多。