内容

• 特性
• 信号
• 详细描述

CheckBox QML Type

A checkbox with a text label. 更多...

import 语句：	import QtQuick.Controls 1.4
Since:	Qt 5.1
继承：	FocusScope

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

特性

• activeFocusOnPress : bool
• checked : bool
• checkedState : int
• exclusiveGroup : ExclusiveGroup
• hovered : bool
• partiallyCheckedEnabled : bool
• pressed : bool
• style : Component
• text : string
• tooltip : string

信号

• clicked ()

详细描述

A CheckBox is an option button that can be toggled on (checked) or off (unchecked). Checkboxes are typically used to represent features in an application that can be enabled or disabled without affecting others.

The state of the checkbox can be set with the checked 特性。

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

The partially checked state can be made available to the user by setting partiallyCheckedEnabled to true , or set directly by setting checkedState to Qt.PartiallyChecked . checkedState behaves identically to checked 当 partiallyCheckedEnabled is false ; setting one will appropriately set the other.

The label is shown next to the checkbox, and you can set the label text using its text 特性。

Column {
    CheckBox {
        text: qsTr("Breakfast")
        checked: true
    }
    CheckBox {
        text: qsTr("Lunch")
    }
    CheckBox {
        text: qsTr("Dinner")
        checked: true
    }
}
					

Whenever a CheckBox is clicked, it emits the clicked() 信号。

You can create a custom appearance for a CheckBox by assigning a CheckBoxStyle .

特性文档编制

activeFocusOnPress : bool

此特性是 true if the control takes the focus when it is pressed; forceActiveFocus() will be called on the control.

checked : bool

此特性是 true if the control is checked.

checkedState : int

This property indicates the current checked state of the checkbox.

可能的值： Qt.UnChecked - The checkbox is not checked (default). Qt.Checked - The checkbox is checked. Qt.PartiallyChecked - The checkbox is in a partially checked (or "mixed") state.

The checked property also determines whether this property is Qt.Checked or Qt.UnChecked , and vice versa.

exclusiveGroup : ExclusiveGroup

This property stores the ExclusiveGroup that the control belongs to.

[read-only] hovered : bool

This property indicates whether the control is being hovered.

partiallyCheckedEnabled : bool

This property determines whether the Qt.PartiallyChecked state is available.

A checkbox may be in a partially checked state when the regular checked state can not be determined.

设置 checkedState to Qt.PartiallyChecked will implicitly set this property to true .

若此特性为 true , checked 将是 false .

默认情况下，此特性为 false .

pressed : bool

此特性是 true if the control is being pressed. Set this property to manually invoke a mouse click.

style : Component

The style Component for this control.

另请参阅 Qt Quick Controls Styles QML Types .

text : string

This property holds the text that the label should display.

tooltip : string

This property holds the button tooltip.

This QML property was introduced in QtQuick.Controls 1.7.

信号文档编制

clicked ()

Emitted whenever the control is clicked.