在 PySide6 开发中，QButtonGroup 是一个非常实用的小部件，它能够帮助我们管理一组按钮（如 QPushButton 或 QRadioButton），并提供了一些便捷的功能来简化按钮间的交互逻辑。本文将详细介绍 QButtonGroup 的基本用法，并通过实际例子展示其具体应用场景。
首先，我们需要了解 QButtonGroup 的主要作用：它可以将多个按钮组织在一起，方便开发者获取当前选中的按钮，或者监听按钮状态的变化。这在需要实现单选或多选功能时尤其有用。
创建和添加按钮到 QButtonGroup
创建一个 QButtonGroup 实例非常简单，只需调用 `QButtonGroup()` 即可。接下来，可以通过 `addButton()` 方法将按钮加入到组中。每个按钮都可以关联一个 ID，以便后续通过这个 ID 来识别特定的按钮。
```python
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QButtonGroup
class MyWidget(QWidget):
def __init__(self):
super().__init__()
layout = QVBoxLayout()
self.button_group = QButtonGroup(self)
button1 = QPushButton("Button 1")
button2 = QPushButton("Button 2")
button3 = QPushButton("Button 3")
将按钮添加到 QButtonGroup，并指定唯一的 ID
self.button_group.addButton(button1, id=1)
self.button_group.addButton(button2, id=2)
self.button_group.addButton(button3, id=3)
layout.addWidget(button1)
layout.addWidget(button2)
layout.addWidget(button3)
self.setLayout(layout)
连接信号槽，当按钮被点击时触发相应事件
self.button_group.buttonClicked.connect(self.on_button_clicked)
def on_button_clicked(self, btn):
print(f"Button with ID {btn.id()} was clicked.")
if __name__ == "__main__":
app = QApplication([])
widget = MyWidget()
widget.show()
app.exec()
```
在这个例子中，我们创建了一个包含三个按钮的窗口，并使用 QButtonGroup 来管理这些按钮。每当用户点击某个按钮时，都会触发 `on_button_clicked` 方法，并打印出被点击按钮的 ID。
获取当前选中的按钮
除了监听按钮点击事件外，QButtonGroup 还提供了 `checkedButton()` 方法，可以用来获取当前选中的按钮。如果没有任何按钮被选中，则返回 None。
```python
def check_current_button(self):
checked_btn = self.button_group.checkedButton()
if checked_btn:
print(f"Currently checked button is: {checked_btn.text()}")
else:
print("No button is currently checked.")
```
结论
QButtonGroup 是 PySide6 中处理按钮集合的一个强大工具。通过合理地使用它，我们可以更高效地管理应用程序中的按钮逻辑，无论是简单的单选还是复杂的多选功能都能轻松实现。希望这篇文章能帮助你更好地理解和应用 QButtonGroup 在你的项目中。
