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()
信号¶
def
buttonClicked()
def
buttonPressed()
def
buttonReleased()
def
buttonToggled()
def
idClicked()
def
idPressed()
def
idReleased()
def
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。QButtonGroup
保留了 id-1
来表示“没有这样的按钮”。映射机制的目的是简化用户界面中枚举值的表示。注意
当使用
from __feature__ import true_property
时,属性可以直接使用,否则通过访问器函数使用。- property exclusiveᅟ: bool¶
此属性表示按钮组是否为独占的。
如果此属性为
true
,则在任何给定时间,组中只能有一个按钮被选中。用户可以点击任何按钮来选中它,该按钮将替换组中现有的选中按钮。在一个独占组中,用户不能通过点击当前选中的按钮来取消选中它;相反,必须点击组中的另一个按钮来为该组设置新的选中按钮。
默认情况下,此属性为
true
。- Access functions:
使用给定的
parent
构造一个新的、空的按钮组。- addButton(button[, id=-1])¶
- Parameters:
按钮 –
QAbstractButton
id – int
将给定的
button
添加到按钮组中。如果id
为-1,将为按钮分配一个id。自动分配的id保证为负数,从-2开始。如果您要分配自己的id,请使用正值以避免冲突。另请参阅
- button(id)¶
- Parameters:
id – int
- Return type:
返回具有指定
id
的按钮,如果不存在这样的按钮,则返回None
。- buttonClicked(button)¶
- Parameters:
按钮 –
QAbstractButton
当给定的
button
被点击时,会发出此信号。按钮在首次按下并释放、输入其快捷键时,或以编程方式调用click()
或animateClick()
时,按钮被视为被点击。另请参阅
- buttonPressed(button)¶
- Parameters:
按钮 –
QAbstractButton
当给定的
button
被按下时,会发出此信号。另请参阅
- buttonReleased(button)¶
- Parameters:
按钮 –
QAbstractButton
当给定的
button
被释放时,会发出此信号。另请参阅
- buttonToggled(button, checked)¶
- Parameters:
按钮 –
QAbstractButton
checked – 布尔值
当给定的
button
被切换时,会发出此信号。如果按钮被选中,checked
为true;如果按钮未被选中,则为false。另请参阅
- buttons()¶
- Return type:
返回按钮组的按钮列表。这可能为空。
- checkedButton()¶
- Return type:
返回按钮组中选中的按钮,如果没有按钮被选中,则返回
None
。另请参阅
- checkedId()¶
- Return type:
整数
返回
checkedButton()
的id,如果没有按钮被选中,则返回-1。另请参阅
- exclusive()¶
- Return type:
布尔
另请参阅
属性
exclusiveᅟ
的获取器。- id(button)¶
- Parameters:
按钮 –
QAbstractButton
- Return type:
整数
返回指定
button
的id,如果不存在这样的按钮则返回-1。另请参阅
- idClicked(id)¶
- Parameters:
id – int
当点击具有给定
id
的按钮时,会发出此信号。另请参阅
- idPressed(id)¶
- Parameters:
id – int
当按下具有给定
id
的按钮时,会发出此信号。另请参阅
- idReleased(id)¶
- Parameters:
id – int
当释放具有给定
id
的按钮时,会发出此信号。另请参阅
- idToggled(id, checked)¶
- Parameters:
id – int
checked – 布尔值
当具有给定
id
的按钮被切换时,会发出此信号。如果按钮被选中,checked
为true;如果按钮未被选中,则为false。另请参阅
- removeButton(button)¶
- Parameters:
按钮 –
QAbstractButton
从按钮组中移除给定的
button
。另请参阅
- setExclusive(arg__1)¶
- Parameters:
arg__1 – 布尔值
另请参阅
属性
exclusiveᅟ
的设置器。- setId(button, id)¶
- Parameters:
按钮 –
QAbstractButton
id – int
设置指定
button
的id
。请注意,id
不能为-1。另请参阅