### ### PyQt5 中 QRadioButton 的使用与功能 `QRadioButton` 是 PyQt5 中用于实现单选按钮的控件，通常用于让用户在多个选项中选择一个。与 `QCheckBox` 不同，`QRadioButton` 控件之间具有互斥性，即同一时间只能选择一个按钮。`QRadioButton` 提供了多种方法和信号，用于获取状态、设置文本、绑定事件等。 #### 初始化与基本设置 可以通过 `QRadioButton` 的构造函数创建按钮，并使用 `setText()` 方法设置显示文本。按钮默认为未选中状态，可以通过 `setChecked(True)` 来设置默认选中项： ```python from PyQt5.QtWidgets import QApplication, QWidget, QRadioButton, QVBoxLayout app = QApplication([]) window = QWidget() layout = QVBoxLayout() radio1 = QRadioButton("Option 1") radio2 = QRadioButton("Option 2") radio1.setChecked(True) layout.addWidget(radio1) layout.addWidget(radio2) window.setLayout(layout) window.show() app.exec_() ``` 该方式适用于手动管理多个单选按钮的情况，也可以将多个按钮放入 `QButtonGroup` 中进行统一管理[^1]。 #### 信号与槽函数 `QRadioButton` 提供了 `toggled` 信号，当按钮状态发生变化时会触发该信号。可以将其连接到自定义的槽函数，以执行相应的操作。例如，以下代码展示了如何在按钮状态变化时输出当前状态： ```python def on_radio_toggled(checked): if checked: print("Option selected") radio1.toggled.connect(on_radio_toggled) ``` 该信号的参数 `checked` 表示当前按钮是否被选中，可以用于判断用户选择的具体选项[^1]。 #### 状态查询与设置 可以通过 `isChecked()` 方法获取按钮当前是否被选中，适用于在程序逻辑中判断用户的选择。例如： ```python if radio1.isChecked(): print("Option 1 is selected") ``` 此外，可以通过 `setEnabled(False)` 来禁用按钮，使其不可点击，也可以通过 `setText()` 动态修改按钮的文本内容[^1]。 #### 使用 QButtonGroup 统一管理 若需要管理多个 `QRadioButton` 实例，推荐使用 `QButtonGroup` 将其组合在一起。该类提供了统一的信号和状态管理功能，例如可以通过 `buttonClicked()` 信号获取当前被点击的按钮： ```python from PyQt5.QtWidgets import QButtonGroup group = QButtonGroup() group.addButton(radio1) group.addButton(radio2) group.buttonClicked.connect(lambda btn: print(f"Selected: {btn.text()}")) ``` 该方式简化了多个按钮的状态管理和事件绑定[^1]。 ---