PySide6.QtWidgets.QButtonGroup

class QButtonGroup

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

PySide6.QtWidgets.QButtonGroup 的继承图

概要

属性

方法

信号

注意

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

详细描述

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

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

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

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

注意

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

property exclusiveᅟ: bool

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

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

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

默认情况下,此属性为 true

Access functions:
__init__([parent=None])
Parameters:

父对象QObject

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

addButton(button[, id=-1])
Parameters:

将给定的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:

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

另请参阅

toggled()

buttons()
Return type:

QAbstractButton的列表

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

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:

设置指定buttonid。请注意,id不能为-1。

另请参阅

id()