CheckDelegate QML Type

Item delegate with a check indicator that can be toggled on or off. 更多...

import 语句：	import QtQuick.Controls 2.2
Since:	Qt 5.7
继承：	ItemDelegate

所有成员列表，包括继承成员

特性

checkState : enumeration
tristate : bool

详细描述

CheckDelegate presents an item delegate that can be toggled on (checked) or off (unchecked). Check delegates are typically used to select one or more options from a set of options in a list. For smaller sets of options, or for options that need to be uniquely identifiable, consider using CheckBox 代替。

CheckDelegate inherits its API from ItemDelegate , which is inherited from AbstractButton . For instance, you can set text , and react to clicks 使用 AbstractButton API. The state of the check delegate can be set with the checked 特性。

In addition to the checked and unchecked states, there is a third state: partially checked. The partially checked state can be enabled using the tristate property. This state indicates that the regular checked/unchecked state can not be determined; generally because of other states that affect the check delegate. This state is useful when several child nodes are selected in a treeview, for example.

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

另请参阅 Customizing CheckDelegate , 委托控件，和 CheckBox .

特性文档编制

checkState : enumeration

This property determines the check state of the check delegate.

Available states:

常量	描述
`Qt.Unchecked`	The delegate is unchecked.
`Qt.PartiallyChecked`	The delegate is partially checked. This state is only used when tristate is enabled.
`Qt.Checked`	The delegate is checked.

另请参阅 tristate and checked .

tristate : bool

This property determines whether the check delegate has three states.

In the animation below, the first checkdelegate is tri-state:

默认为 false , i.e., the delegate has only two states.