CheckDelegate QML Type

带有可开启或关闭的复选指示器的项目委托。更多

• 所有成员（包括继承成员）的列表

属性

• checkState : enumeration
• nextCheckState : function (since QtQuick.Controls 2.4 (Qt 5.11))
• tristate : bool

详细说明

CheckDelegate 显示一个可切换为打开（选中）或关闭（取消选中）的项目委托。选中委托通常用于从列表中的一组选项中选择一个或多个选项。对于较小的选项集或需要唯一标识的选项，可考虑使用CheckBox 代替。

CheckDelegate 的 API 继承自ItemDelegate ，而 又继承自AbstractButton 。例如，您可以设置text ，并使用AbstractButton API 对clicks 做出反应。可以使用checked 属性设置校验委托的状态。

除了 "已选中 "和 "未选中 "状态外，还有第三种状态："部分选中"。可以使用tristate 属性启用部分选中状态。这种状态表示无法确定常规的已选中/未选中状态，通常是因为其他状态影响了选中委托。例如，在树状视图中选择了多个子节点时，这种状态非常有用。

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

另请参阅 自定义 CheckDelegate、委托控件和CheckBox 。

属性文档

CheckDelegate {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

tristate : bool

该属性决定了选中委托是否有三种状态。

在下面的动画中，第一个校验委托是三态的：

默认值为false ，即委托只有两种状态。