class QButtonGroup#

《a class="reference internal" href="#PySide6.QtWidgets.QButtonGroup" title="PySide6.QtWidgets.QButtonGroup">QButtonGroup》类提供了一个容器来组织按钮小部件的组。更多…

概述#

属性#

exclusiveᅟ - 是否按钮组为互斥

方法#

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

信号#

定义 buttonClicked()
定义 buttonPressed()
定义 buttonReleased()
定义 buttonToggled()
定义 idClicked()
定义 idPressed()
定义 idReleased()
定义 idToggled()

注意

本文档可能包含自动从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。ID -1 被留给了 QButtonGroup 表示“没有这样的按钮”。映射机制的目的在于简化用户界面试图中枚举值的表示。

参阅

QGroupBox QPushButton QCheckBox QRadioButton

注意

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

property exclusiveᅟ: bool#

此属性存储了按钮组是否独占。

如果此属性为true，则组内只能在任何时候选中一个按钮。用户可以点击任何按钮进行选择，并将该按钮替换为组内现有的选中按钮。

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

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

访问函数

exclusive()
setExclusive()

__init__([parent=None])#

参数:: parent – QObject

构建一个新的、空的按钮组，具有指定的parent。

参阅

addButton() setExclusive()

addButton(arg__1[, id=-1])#

参数:

arg__1 – QAbstractButton
id – int

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

参阅

removeButton() buttons()

button(id)#

参数:: id – int
返回类型：: QAbstractButton

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

buttonClicked(arg__1)#

参数:: arg__1 – QAbstractButton

当指定的 button 被点击时，会发出此信号。按钮被点击是指它首次按下然后释放，当按下其快捷键，或者程序上调用 click() 或 animateClick() 时。

参阅

checkedButton() clicked()

buttonPressed(arg__1)#

参数:: arg__1 – QAbstractButton

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

参阅

pressed()

buttonReleased(arg__1)#

参数:: arg__1 – QAbstractButton

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

参阅

released()

buttonToggled(arg__1, arg__2)#

参数:

arg__1 – QAbstractButton
arg__2 – bool

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

参阅

toggled()

buttons()#

返回类型：: . QAbstractButton 的列表

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

参阅

addButton() removeButton()

checkedButton()#

返回类型：: QAbstractButton

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

参阅

buttonClicked()

checkedId()#

返回类型：: int

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

参阅

setId()

exclusive()#

返回类型：: bool

参阅

setExclusive()

属性 exclusive 的获取器。

id(button)#

参数:: button – QAbstractButton
返回类型：: int

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

参阅

setId()

idClicked(arg__1)#

参数:: arg__1 – int

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

参阅

checkedButton() clicked()

idPressed(arg__1)#

参数:: arg__1 – int

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

参阅

pressed()

idReleased(arg__1)#

参数:: arg__1 – int

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

参阅

released()

idToggled(arg__1, arg__2)#

参数:

arg__1 – int
arg__2 – bool

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

参阅

toggled()

removeButton(arg__1)#

参数:: arg__1 – QAbstractButton

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

参阅

addButton() buttons()

setExclusive(arg__1)#

参数:: arg__1 – bool

参阅

exclusive()

属性 exclusive 的设置器。

setId(button, id)#

参数:

button – QAbstractButton
id – int

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

参阅

id()