class QCheckBox#

提供带有文本标签的复选框小部件的QCheckBox。详情…

概述#

属性#

tristateᅟ - 复选框是否为三态复选框

方法#

def __init__()
def checkState()
def isTristate()
def setCheckState()
def setTristate()

虚拟方法#

def initStyleOption()

信号#

def checkStateChanged()
定义 stateChanged()

注意

此文档可能包含从 C++ 自动翻译到 Python 的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译存在问题，您也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 创建工单的方式让我们知道

详细描述#

警告

本节包含从 C++ 自动翻译到 Python 的代码片段，可能包含错误。

一个 QCheckBox 是一个可以选择打开（选中）或关闭（未选中）的选项按钮。复选框通常用于表示在没有影响其他选项的情况下可以启用或禁用的应用功能。可以实现不同类型的行为。例如，可以使用 QButtonGroup 有逻辑地组织复选按钮，从而实现可选的复选框。但是，QButtonGroup 不提供任何可视化表示。

下面的图像进一步说明了独占和非独占复选框之间的区别。

每次复选框被选中或取消选中时，都会发出信号 checkStateChanged() 。如果您想每次复选框状态改变时触发一个动作，请连接到此信号。您可以使用 isChecked() 来查询复选框是否被选中。

除了常规的选中和非选中状态以外，QCheckBox 可选还提供了一个表示“未改变”的第三种状态。当您需要提供一个既不选中也不取消选中复选框的选择时，这很有用。如果您需要此第三状态，可以使用 setTristate() 启用它，并使用 checkState() 查询当前的切换状态。

与 QPushButton 一样，复选框显示文本，并可选地显示一个小图标。图标通过 setIcon() 设置。文本可以通过构造函数设置或在 setText() 中设置。可以通过在首选字符之前放置一个与号来指定快捷键。例如

checkbox = QCheckBox("Case sensitive", self)

在此示例中，快捷键是 Alt+A。有关详细信息，请参阅 QShortcut 文档。若要显示实际与号，请使用 `&&`。

重要的继承函数：text()、setText()、text()、pixmap()、setPixmap()、accel()、setAccel()、isToggleButton()、setDown()、isDown()、isOn()、checkState()、autoRepeat()、isExclusiveToggle()、group()、setAutoRepeat()、toggle()、pressed()、released()、clicked()、toggled()、checkState()和checkStateChanged()。

另见

QAbstractButton QRadioButton

注意

使用from __feature__ import true_property时可以直接使用属性，否则通过访问器函数。

property tristateᅟ: bool#

该属性表示复选框是否为三态复选框。

默认为false，即复选框只有两个状态。

访问函数

isTristate()
setTristate()

__init__([parent=None])#

参数: parent – QWidget

使用给定的 parent 构建一个没有文本的复选框。

parent 被传递给 QAbstractButton 构造函数。

__init__(text[, parent=None])

参数

text – str
parent – QWidget

构建一个给定 parent 和 text 的复选框。

parent 被传递给 QAbstractButton 构造函数。

checkState()#

返回类型：: CheckState

返回复选框的选中状态。如果您不需要三态支持，也可以使用 isChecked()，它返回一个布尔值。

另见

setCheckState() CheckState

checkStateChanged(arg__1)#

参数: arg__1 – CheckState

每当复选框的状态发生变化时，即用户检查或取消检查时，都会发出此信号。

state 包含复选框的新 Qt::CheckState。

initStyleOption(option)#

参数: option – QStyleOptionButton

使用此 QCheckBox 的值初始化 option。此方法对需要 QStyleOptionButton 但不想亲自填写所有信息的子类很有用。

另见

initFrom()

isTristate()#

返回类型：: bool

属性 tristateᅟ 的获取器。

setCheckState(state)#

参数: state – CheckState

设置复选框的选中状态为 state。如果您不需要三位状态支持，也可以使用 setChecked() 方法，它接收一个布尔值。

另见

checkState() CheckState

setTristate([y=true])#

参数: y – bool

另见

isTristate()

属性 tristate 的设置器。

stateChanged(arg__1)#

参数: arg__1 – int

请使用 checkStateChanged (Qt::CheckState) 代替。