PySide6.QtWidgets.QButtonGroup¶

class QButtonGroup¶

QButtonGroup 类提供了一个容器来组织按钮小部件组。更多…

概要¶

属性¶

exclusiveᅟ - 按钮组是否是独占的

方法¶

def __init__()
def addButton()
def button()
def buttons()
def checkedButton()
def checkedId()
def exclusive()
def id()
def removeButton()
def setExclusive()
def setId()

注意

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

详细描述¶

QButtonGroup 提供了一个抽象的容器，可以将按钮小部件放入其中。它不提供此容器的视觉表示（有关容器小部件，请参见 QGroupBox），而是管理组中每个按钮的状态。

一个exclusive按钮组会关闭所有可切换的按钮，除了被点击的那个。默认情况下，按钮组是独占的。按钮组中的按钮通常是可切换的QPushButton、QCheckBox（通常用于非独占按钮组）或QRadioButton。如果你创建了一个独占按钮组，你应该确保组中的一个按钮最初是被选中的；否则，组最初将处于没有按钮被选中的状态。

可以使用addButton()向组中添加按钮，并使用removeButton()移除按钮。如果组是独占的，当前选中的按钮可以通过checkedButton()获取。如果点击了一个按钮，会发出buttonClicked()信号；对于独占组中的可选中按钮，这意味着该按钮已被选中。组中的按钮列表由buttons()返回。

此外，QButtonGroup 可以在整数和按钮之间进行映射。你可以使用 setId() 为按钮分配一个整数 id，并使用 id() 检索它。当前选中的按钮的 id 可以通过 checkedId() 获取，并且有一个信号 idClicked() 会发出按钮的 id。QButtonGroup 保留了 id -1 来表示“没有这样的按钮”。映射机制的目的是简化用户界面中枚举值的表示。

另请参阅

QGroupBox QPushButton QCheckBox QRadioButton

注意

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

property exclusiveᅟ: bool¶

此属性表示按钮组是否为独占的。

如果此属性为true，则在任何给定时间，组中只能有一个按钮被选中。用户可以点击任何按钮来选中它，该按钮将替换组中现有的选中按钮。

在一个独占组中，用户不能通过点击当前选中的按钮来取消选中它；相反，必须点击组中的另一个按钮来为该组设置新的选中按钮。

默认情况下，此属性为 true。

Access functions:

exclusive()
setExclusive()

__init__([parent=None])¶

Parameters:: 父对象 – QObject

使用给定的parent构造一个新的、空的按钮组。

另请参阅

addButton() setExclusive()

addButton(button[, id=-1])¶

Parameters:

按钮 – QAbstractButton
id – int

将给定的button添加到按钮组中。如果id为-1，将为按钮分配一个id。自动分配的id保证为负数，从-2开始。如果您要分配自己的id，请使用正值以避免冲突。

另请参阅

removeButton() buttons()

button(id)¶

Parameters:: id – int
Return type:: QAbstractButton

返回具有指定id的按钮，如果不存在这样的按钮，则返回None。

buttonClicked(button)¶

Parameters:: 按钮 – QAbstractButton

当给定的button被点击时，会发出此信号。按钮在首次按下并释放、输入其快捷键时，或以编程方式调用click()或animateClick()时，按钮被视为被点击。

另请参阅

checkedButton() clicked()

buttonPressed(button)¶

Parameters:: 按钮 – QAbstractButton

当给定的button被按下时，会发出此信号。

另请参阅

pressed()

buttonReleased(button)¶

Parameters:: 按钮 – QAbstractButton

当给定的button被释放时，会发出此信号。

另请参阅

released()

buttonToggled(button, checked)¶

Parameters:

按钮 – QAbstractButton
checked – 布尔值

当给定的button被切换时，会发出此信号。如果按钮被选中，checked为true；如果按钮未被选中，则为false。

另请参阅

toggled()

buttons()¶

Return type:: QAbstractButton的列表

返回按钮组的按钮列表。这可能为空。

另请参阅

addButton() removeButton()

checkedButton()¶

Return type:: QAbstractButton

返回按钮组中选中的按钮，如果没有按钮被选中，则返回None。

另请参阅

buttonClicked()

checkedId()¶

Return type:: 整数

返回checkedButton()的id，如果没有按钮被选中，则返回-1。

另请参阅

setId()

exclusive()¶

Return type:: 布尔

另请参阅

setExclusive()

属性 exclusiveᅟ 的获取器。

id(button)¶

Parameters:: 按钮 – QAbstractButton
Return type:: 整数

返回指定button的id，如果不存在这样的按钮则返回-1。

另请参阅

setId()

idClicked(id)¶

Parameters:: id – int

当点击具有给定id的按钮时，会发出此信号。

另请参阅

checkedButton() clicked()

idPressed(id)¶

Parameters:: id – int

当按下具有给定id的按钮时，会发出此信号。

另请参阅

pressed()

idReleased(id)¶

Parameters:: id – int

当释放具有给定id的按钮时，会发出此信号。

另请参阅

released()

idToggled(id, checked)¶

Parameters:

id – int
checked – 布尔值

当具有给定id的按钮被切换时，会发出此信号。如果按钮被选中，checked为true；如果按钮未被选中，则为false。

另请参阅

toggled()

removeButton(button)¶

Parameters:: 按钮 – QAbstractButton

从按钮组中移除给定的button。

另请参阅

addButton() buttons()

setExclusive(arg__1)¶

Parameters:: arg__1 – 布尔值

另请参阅

exclusive()

属性 exclusiveᅟ 的设置器。

setId(button, id)¶

Parameters:

按钮 – QAbstractButton
id – int

设置指定button的id。请注意，id不能为-1。

另请参阅

id()