QML类型说明-CheckBox

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()

当组件被点击，发射这个信号。