PySide6.QtWidgets.QCheckBox¶

class QCheckBox¶

QCheckBox 小部件提供了一个带有文本标签的复选框。更多…

概要¶

属性¶

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

方法¶

• def __init__()

• def checkState()

• def isTristate()

• def setCheckState()

• def setTristate()

虚拟方法¶

• def initStyleOption()

信号¶

• def checkStateChanged()

• def 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文档。要显示实际的&符号，请使用‘&&’。

另请参阅

QAbstractButton QRadioButton

注意

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

property tristateᅟ: bool¶

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

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

Access functions:

• isTristate()

• setTristate()

__init__([parent=None])¶

Parameters:

父级 – QWidget

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

parent 被传递给 QAbstractButton 构造函数。

__init__(text[, parent=None])

Parameters:

• 文本 – str

• parent – QWidget

使用给定的parent和text构造一个复选框。

parent 被传递给 QAbstractButton 构造函数。

checkState()¶

Return type:

CheckState

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

另请参阅

setCheckState() CheckState

checkStateChanged(state)¶

Parameters:

状态 – CheckState

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

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

initStyleOption(option)¶

Parameters:

选项 – QStyleOptionButton

使用此QCheckBox的值初始化option。此方法对于需要QStyleOptionButton但不希望自己填写所有信息的子类非常有用。

另请参阅

initFrom()

isTristate()¶

Return type:

布尔

属性 tristateᅟ 的获取器。

setCheckState(state)¶

Parameters:

状态 – CheckState

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

另请参阅

checkState() CheckState

setTristate([y=true])¶

Parameters:

y – 布尔值

另请参阅

isTristate()

属性 tristateᅟ 的设置器。

stateChanged(state)¶

Parameters:

状态 – int

注意

此函数已弃用。

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

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

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