CheckBox
ImportStatement: import QtQuick.Controls 1.2
Since: Qt 5.1
Inherits: FocusScope
Properties
activeFocusOnPress: bool
checked :bool
checkedState: int
exclusiveGroup: ExclusiveGroup
hovered :bool
partiallyCheckedEnabled: bool
pressed :bool
style : Component
text :string
Signals
clicked()
DetailedDescription
CheckBox是复选框按钮,有打开和关闭两个状态。一般的形象是方框里面有对勾。它一般用于在不影响其它的情况下选择应用程序的特征是打开开始关闭。
CheckBox的状态能使用checked属性设置。除了checked和unchecked状态,CheckBox还有第三个状态:部分选择(partiallychecked)。它出现在其他的状态对CheckBox有影响时。最常见的是选择树的部分子节点被选中的情况。
设置partiallyCheckedEnabled为真,部分选择状态便是可用的。直接设置checkedState为Qt.PartiallyChecked,而partiallyCheckedEnabled为假,则等同于设置checked。text是选择框边上的文字。
Column {
CheckBox {
text: qsTr("Breakfast")
}
CheckBox {
text: qsTr("Lunch")
}
CheckBox {
text: qsTr("Dinner")
}
}
无论什么时候,CheckBox被点击,它发射clicked()信号。
我们能用CheckBoxStyle为CheckBox创建特定的样式。
PropertyDocumentation
activeFocusOnPress: bool
如果为真,当组件被按下时,获得焦点。forceActiveFocus()将被控制调用。
checked :bool
如果组件被选择,为真。
checkedState: int
这个属性指明了当前组件的checked状态。可能的值是:
Qt.UnChecked- 组件没有被选择(默认值)
Qt.Checked -组件被选择
Qt.PartiallyChecked- 组件被部分选择。
checked属性也决定了这个属性是Qt.Checked还是Qt.UnChecked。反之亦然。
exclusiveGroup: ExclusiveGroup
保存了控制隶属的单独组。
hovered :bool
鼠标是否在组件上悬停。
partiallyCheckedEnabled: bool
部分选择是否可用。当checked不能确定时,组件处于部分选择状态。设置checkedState到Qt.PartiallyChecked,应该先设置这个属性为真,当这个属性为真,checked为假。这个属性默认为假。
pressed :bool
控制被按下,这个属性为真。设置这个属性,需人工鼠标点击。
style :Component
组件的样式。
text :string
选择框边上的文本。
SignalDocumentation
clicked()
当组件被点击,发射这个信号。