【PySide6快速入门】 QRadioButton单选按钮

前言

在图形用户界面中，单选按钮（Radio Button）是一种常见的控件，通常用于在一组互斥的选项中进行选择。QRadioButton 是 PySide6 中的一个控件，提供了单选按钮的实现，允许用户从一组选项中选择一个选项。与复选框（CheckBox）不同，单选按钮是互斥的，也就是说，在同一组中的多个单选按钮只能有一个被选中。本文将介绍 QRadioButton 的基本用法，以及常用的函数和功能，帮助你轻松实现单选按钮的功能。

什么是QRadioButton？

QRadioButton 是 PySide6 提供的一个单选按钮控件，用于实现一组选项中只能选择一个的功能。通常，多个 QRadioButton 控件被放置在同一个容器中（如 QGroupBox 或 QButtonGroup），以实现单选行为。用户只能选择其中一个选项，其他选项会自动取消选择。

特点：

1. 单选功能： 同一组内的 QRadioButton 控件只能选择一个，适合用于互斥的选项。
2. 与 QButtonGroup 配合使用： 可以将多个 QRadioButton 放入一个 QButtonGroup，更好地管理它们的互斥关系。
3. 支持文本与图标： QRadioButton 不仅可以显示文本，还可以显示图标，增强用户界面的表现力。
4. 自动选择： 用户可以点击某个单选按钮，自动选中该按钮并取消选中其他按钮。

如何使用QRadioButton？

1. 基本用法

QRadioButton 控件的基本用法非常简单，通常通过创建一个 QRadioButton 对象并设置文本来实现。可以通过 setChecked() 方法设置按钮的初始状态。

示例代码：

from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QRadioButton

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

radio_button1 = QRadioButton("Option 1")  # 创建 QRadioButton
radio_button2 = QRadioButton("Option 2")
radio_button3 = QRadioButton("Option 3")

layout.addWidget(radio_button1)
layout.addWidget(radio_button2)
layout.addWidget(radio_button3)

window.setLayout(layout)
window.show()

app.exec()

在这个示例中，我们创建了三个 QRadioButton 控件，分别表示三个不同的选项。

2. 设置默认选中项

可以通过 setChecked() 方法设置一个单选按钮为默认选中状态。

示例代码：

radio_button1.setChecked(True)  # 设置第一个单选按钮为选中状态

3. 响应状态变化

QRadioButton 提供了 toggled() 信号，可以在按钮的选中状态变化时进行响应。

示例代码：

def on_toggled(checked):
    print(f"Radio button checked: {checked}")

radio_button1.toggled.connect(on_toggled)

在这个示例中，我们通过 toggled() 信号响应按钮状态的变化，当按钮的选中状态发生变化时，输出相应的信息。

4. 使用QButtonGroup管理多个单选按钮

为了管理多个 QRadioButton 的互斥关系，通常将它们放入一个 QButtonGroup 中。QButtonGroup 可以帮助我们自动管理按钮的互斥状态，并且提供一些额外的功能，如获取当前选中的按钮。

示例代码：

from PySide6.QtWidgets import QButtonGroup

button_group = QButtonGroup()
button_group.addButton(radio_button1)
button_group.addButton(radio_button2)
button_group.addButton(radio_button3)

button_group.buttonClicked.connect(lambda button: print(f"Selected: {button.text()}"))

在这个示例中，我们将三个 QRadioButton 添加到一个 QButtonGroup 中，这样它们会自动成为互斥的关系。当某个按钮被点击时，buttonClicked 信号会触发，我们可以获取选中的按钮并进行操作。

QRadioButton 常用函数分类介绍

1. 状态控制函数

• setChecked(checked)
  设置单选按钮的选中状态。

  • 参数： checked：布尔值，True 表示选中，False 表示未选中。
  • 返回值： 无。

• isChecked()
  获取单选按钮的选中状态。

  • 返回值： 布尔值，True 表示选中，False 表示未选中。

2. 文本和图标设置

• setText(text)
  设置按钮的显示文本。

  • 参数： text：要显示的文本字符串。
  • 返回值： 无。

• text()
  获取按钮显示的文本。

  • 返回值： 返回一个字符串，表示按钮的文本内容。

• setIcon(icon)
  设置按钮的图标。

  • 参数： icon：一个 QIcon 对象，用于设置按钮的图标。
  • 返回值： 无。

• icon()
  获取按钮的图标。

  • 返回值： 返回一个 QIcon 对象，表示按钮的图标。

3. 信号与槽

• toggled(checked)
  当按钮的选中状态变化时触发的信号。

  • 参数： checked：布尔值，表示按钮是否被选中。
  • 返回值： 无。

• clicked()
  当按钮被点击时触发的信号。

  • 返回值： 无。

4. 其他功能

• setAutoExclusive(exclusive)
  设置是否启用自动排他功能。当多个单选按钮被添加到 QButtonGroup 中时，如果某个按钮被选中，其他按钮会自动取消选中。

  • 参数： exclusive：布尔值，True 启用自动排他，False 禁用。
  • 返回值： 无。

• setToolTip(toolTip)
  设置按钮的工具提示。

  • 参数： toolTip：显示在鼠标悬停时的提示文本。
  • 返回值： 无。

• setEnabled(enabled)
  设置按钮是否可用。

  • 参数： enabled：布尔值，True 表示按钮可用，False 表示按钮不可用。
  • 返回值： 无。

• isEnabled()
  获取按钮是否可用。

  • 返回值： 布尔值，True 表示按钮可用，False 表示按钮不可用。

总结

QRadioButton 是一个非常实用的控件，特别适用于实现单选功能。当你需要在一组选项中让用户选择一个时，QRadioButton 是非常合适的选择。通过结合 QButtonGroup 使用，你可以轻松管理多个 QRadioButton 之间的互斥关系。QRadioButton 支持文本、图标的设置，也能响应状态变化事件，非常适用于各种表单、设置面板等场景。

通过掌握 QRadioButton 的使用，你可以为用户提供更加友好和直观的选择界面，使得用户能够快速理解并做出选择。