小白白也能学会的 PyQt 教程 —— QRadioButton 介绍以及基本使用

文章目录

• 一、QRadioButton快速入门

• 1. QRadioButton简介
• 2. QRadioButton快速上手

• 二、响应单选按钮点击事件

• 1、信号和槽机制：
• 2、创建槽函数来响应单选按钮点击：
• 3、示例：执行特定操作或显示相关内容：

• 三、单选按钮的常用功能和属性

• 1、按钮状态的管理：
• 2、设置按钮的大小、位置和布局：
• 3、样式设置：
• 4、其他常用属性：

• 四、继承 QRadioButton 的自定义单选按钮

• 1、继承 QRadioButton 类：
• 2、重写按钮的行为：
• 3、重写按钮的外观：
• 4、使用自定义单选按钮：
• 五、简单总结

一、QRadioButton快速入门

1. QRadioButton简介

QRadioButton是PyQt中用于创建单选按钮的类。它继承自QAbstractButton类，间接继承自QWidget类，因此可以像其他窗口部件一样进行布局和管理。

作为常用的小部件之一，QRadioButton可用于在用户界面中提供单选选项。它可以和其他QRadioButton进行组合，形成一组互斥的选项，即同一时间只能选择其中一个。QRadioButton具有丰富的功能和属性，可以设置文本标签、图标、默认选中状态，支持信号与槽机制，并可通过样式表进行自定义外观。

2. QRadioButton快速上手

使用QRadioButton的步骤大致分为以下三步：

1. 创建单选按钮（创建单选按钮并添加到窗口）。
2. 设置单选按钮的属性和样式（设置文本、图标、默认选中状态和样式）。
3. 响应选择事件（连接选中状态变化的信号到特定的槽函数）。

1、创建单选按钮并添加到窗口：

使用以下代码可以创建一个简单的单选按钮并将其添加到窗口中：

from PyQt5.QtWidgets import QApplication, QMainWindow, QRadioButton

# 创建应用程序和主窗口
app = QApplication([])
window = QMainWindow()

# 创建单选按钮并设置父窗口
radio_button = QRadioButton("Option 1", window)

# 显示主窗口和应用程序循环
window.show()
app.exec()

在上述代码中，我们创建了一个应用程序实例和一个主窗口实例。然后，创建了一个名为 “Option 1” 的单选按钮，并将其父窗口设置为主窗口。最后，通过调用 show() 方法显示主窗口，并通过 app.exec() 进入应用程序的事件循环。

运行后效果如下：

2、设置单选按钮的属性和样式：

我们可以使用 setText() 方法为单选按钮设置文本，使用 setIcon() 方法设置单选按钮的图标。此外，还可以使用 setChecked() 方法设置单选按钮的默认选中状态。例如：

# 设置单选按钮的属性和样式
radio_button.setText("Option 1")
radio_button.setIcon(QIcon("icon.png"))
radio_button.setChecked(True)
radio_button.setStyleSheet("QRadioButton { color: blue; }")

上述代码将单选按钮的文本设置为 “Option 1”，将单选按钮的图标设置为 “icon.png” 文件，并将单选按钮设为默认选中状态。同时，通过使用样式表，将单选按钮的文本颜色设置为蓝色。

运行后效果如下：

3、连接选中状态变化的信号到特定的槽函数：

单选按钮的常见用途是在选择状态变化时执行特定的操作。为了实现这一点，我们可以使用信号和槽机制来连接单选按钮的选中状态变化信号到一个特定的槽函数。例如：

# 响应选择事件的槽函数
def on_radio_button_clicked():
    if radio_button.isChecked():
        print("Option 1 selected")

# 将选中状态变化信号与槽函数连接
radio_button.clicked.connect(on_radio_button_clicked)

在上述代码中，我们定义了一个名为 on_radio_button_clicked() 的槽函数，它将在单选按钮的选中状态变化时被调用，并打印出一条消息。然后，通过 clicked 信号和 connect() 方法，将单选按钮的选中状态变化信号连接到该槽函数。

运行后效果如下：

总体代码如下：

from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import QApplication, QMainWindow, QRadioButton

# 创建应用程序和主窗口
app = QApplication([])
window = QMainWindow()

# 创建单选按钮并设置父窗口
radio_button = QRadioButton("Option 1", window)

# 设置单选按钮的属性和样式
radio_button.setText("Option 1")
radio_button.setIcon(QIcon("icon.png"))
radio_button.setChecked(True)
radio_button.setStyleSheet("QRadioButton { color: blue; }")

# 响应选择事件的槽函数
def on_radio_button_clicked():
    if radio_button.isChecked():
        print("Option 1 selected")

# 将选中状态变化信号与槽函数连接
radio_button.clicked.connect(on_radio_button_clicked)

# 显示主窗口和应用程序循环
window.show()
app.exec()

二、响应单选按钮点击事件

1、信号和槽机制：

PyQt 使用信号和槽机制来处理用户界面组件的交互。信号是一个事件，如单选按钮的选中状态变化事件，而槽是一个接收信号并执行特定操作的函数。我们可以使用 connect() 方法将信号连接到槽函数，以便在特定事件发生时执行操作。

radio_button.clicked.connect()

2、创建槽函数来响应单选按钮点击：

在创建单选按钮时，我们可以通过定义一个槽函数来响应单选按钮的点击事件。槽函数是一个普通的Python函数，它接受特定的参数（例如，单选按钮点击事件的参数），并在函数体内执行所需的操作（特别注意，槽函数不能带有括号，否则会自动执行而导致错误）。就像下面的代码一样。

from PyQt5.QtWidgets import QApplication, QMainWindow, QRadioButton

def on_radio_button_clicked():
    if radio_button.isChecked():
        print("Option 1 selected")

app = QApplication([])
window = QMainWindow()
radio_button = QRadioButton("Option 1", window)

# 将单选按钮的选中状态变化信号连接到槽函数
radio_button.clicked.connect(on_radio_button_clicked)

window.show()
app.exec()

在上述代码中，我们定义了一个名为 on_radio_button_clicked() 的槽函数，它在单选按钮的选中状态变化时将打印一条消息。然后，通过调用 clicked 信号和 connect() 方法，将单选按钮的选中状态变化信号连接到该槽函数。

3、示例：执行特定操作或显示相关内容：

单选按钮的点击事件可以用于执行各种操作，例如更新界面内容、控制其他组件的状态或显示相关信息。以下是一个示例，展示了如何在单选按钮选中时执行特定操作：

from PyQt5.QtWidgets import QApplication, QMainWindow, QRadioButton, QMessageBox

def on_radio_button_clicked():
    if radio_button.isChecked():
        QMessageBox.information(window, "Message", "Option 1 selected")

app = QApplication([])
window = QMainWindow()
radio_button = QRadioButton("Option 1", window)
radio_button.clicked.connect(on_radio_button_clicked)

window.show()
app.exec()

在上述代码中，我们导入了 QMessageBox 类来显示消息框。on_radio_button_clicked() 槽函数将在单选按钮选中时调用 QMessageBox.information() 方法来显示包含消息的消息框。

通过连接单选按钮的选中状态变化信号到槽函数，您可以实现单选按钮与特定操作之间的交互。您可以根据需要扩展槽函数的功能，以便执行各种任务，从而增强用户界面的交互性和实用性。

运行效果如下：

三、单选按钮的常用功能和属性

在前两部分中，我们介绍了如何创建单选按钮和响应其点击事件。在本部分，我们将深入了解单选按钮的常用功能和属性，以便更好地定制和管理单选按钮的外观和行为。

1、按钮状态的管理：

单选按钮可以具有不同的状态，例如选中状态和未选中状态。您可以使用 setChecked() 方法来设置单选按钮的选中状态。例如：

radio_button.setChecked(True)  # 将单选按钮设置为选中状态
radio_button.setChecked(False)  # 将单选按钮设置为未选中状态

设置单选按钮的选中状态后，它将显示为选中或未选中状态。

2、设置按钮的大小、位置和布局：

您可以使用单选按钮的几个方法来设置其大小和位置，以及在用户界面中的布局。以下是一些常用方法的示例：

radio_button.setGeometry(50, 50, 100, 30)  # 设置单选按钮的位置和大小
radio_button.move(50, 50)  # 移动单选按钮到指定位置
radio_button.resize(100, 30)  # 调整单选按钮的大小

这些方法允许您自定义单选按钮在窗口中的位置和大小，以便与其他组件进行布局和排列。

3、样式设置：

单选按钮的外观可以通过使用样式表来进行自定义。您可以使用 setStyleSheet() 方法来设置单选按钮的样式。样式表使用QSS语法，可以为单选按钮设置背景颜色、文本颜色、边框样式等。以下是一个示例：

radio_button.setStyleSheet("QRadioButton { background-color: blue; color: white; }")

上述代码将单选按钮的背景颜色设置为蓝色，文本颜色设置为白色。您可以根据需要修改样式表以实现所需的外观效果。

下面是我列出的一些常用 QRadioButton 可用的 QSS 属性：

背景颜色属性：

• background-color: 设置单选按钮的背景颜色。
• pressed-background-color: 设置单选按钮在按下状态时的背景颜色。
• hover-background-color: 设置鼠标悬停在单选按钮上时的背景颜色。

前景颜色属性：

• color: 设置单选按钮的前景（文本）颜色。
• pressed-color: 设置单选按钮在按下状态时的前景颜色。
• hover-color: 设置鼠标悬停在单选按钮上时的前景颜色。

边框属性：

• border: 设置单选按钮的边框样式。
• border-radius: 设置单选按钮的边框圆角半径。
• border-color: 设置单选按钮的边框颜色。

文本属性：

• font: 设置

单选按钮的字体样式：

• text-align: 设置单选按钮文本的对齐方式。

图标属性：

• icon: 设置单选按钮显示的图标。
• icon-size: 设置单选按钮图标的大小。

尺寸属性：

• min-width: 设置单选按钮的最小宽度。
• min-height: 设置单选按钮的最小高度。
• max-width: 设置单选按钮的最大宽度。
• max-height: 设置单选按钮的最大高度。

4、其他常用属性：

• text()：获取单选按钮的文本内容。
• setIcon()：设置单选按钮的图标。
• isChecked()：检查单选按钮是否处于选中状态。
• setDefault(True)：将单选按钮设置为默认按钮。
• setToolTip("Tooltip text")：设置单选按钮的工具提示文本，当鼠标悬停在单选按钮上时显示。

这些是单选按钮的常用功能和属性。通过使用这些功能和属性，您可以根据需要对单选按钮进行进一步定制，并管理其外观和行为。

四、继承 QRadioButton 的自定义单选按钮

PyQt 框架允许我们通过继承 QRadioButton 类来创建自定义单选按钮，以实现更复杂的功能和样式。在本部分，我们将学习如何创建自定义单选按钮，并重写其行为和外观。

1、继承 QRadioButton 类：

创建自定义单选按钮的第一步是创建一个新的类，继承自 QRadioButton 类。通过继承，我们可以访问父类的方法和属性，并根据需要添加自定义功能。

from PyQt5.QtWidgets import QRadioButton

class CustomRadioButton(QRadioButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent)

        # 添加自定义的初始化代码
        self.setCustomProperties()
        self.setCustomStyle()

    def setCustomProperties(self):
        # 添加自定义的属性设置
        pass

    def setCustomStyle(self):
        # 添加自定义的样式设置
        pass

2、重写按钮的行为：

通过在自定义单选按钮类中定义新的方法或重写父类的方法，我们可以实现单选按钮的自定义行为。例如，我们可以重写单选按钮的点击事件处理方法：

def mousePressEvent(self, event):
    if event.button() == Qt.LeftButton:
        print("Custom radio button clicked!")

    # 调用父类的方法以保留单选按钮的默认行为
    super().mousePressEvent(event)

在上述代码中，我们重写了 mousePressEvent() 方法，当左键点击单选按钮时，它将打印一条消息。我们还通过调用 super().mousePressEvent(event) 来保留单选按钮的默认行为。

3、重写按钮的外观：

您可以通过重写 paintEvent() 方法来自定义单选按钮的外观。该方法在单选按钮需要重新绘制时被调用。在方法体内，您可以使用 QPainter 类来绘制单选按钮的外观，例如绘制背景、文本和图标。以下是一个示例：

def paintEvent(self, event):
    painter = QPainter(self)
    painter.setRenderHint(QPainter.Antialiasing)

    # 自定义绘制代码
    # 绘制单选按钮的背景、文本和图标

    painter.end()

在上述代码中，我们创建了一个 QPainter 实例，并使用其方法来绘制单选按钮的外观。您可以使用各种绘图方法和属性来实现所需的外观效果。

4、使用自定义单选按钮：

创建自定义单选按钮后，您可以像使用普通单选按钮一样在应用程序中使用它。例如：

app = QApplication([])
window = QMainWindow()

custom_radio_button = CustomRadioButton("Custom Radio Button", window)
# 设置单选按钮的位置和大小、样式等

window.show()
app.exec()

上述代码提供了一个自定义 QRadioButton 的模板，您可以修改和填充代码来创建自

己的自定义单选按钮。通过创建自定义单选按钮，您可以实现更复杂的功能和更具个性化的外观。您可以根据需要重写单选按钮的其他方法和添加其他自定义功能，以实现特定的行为和交互。

通过这个模板，我们创建了一个自定义单选按钮 CustomRadioButton 的实例，并将其添加到主窗口中。代码及效果如下：

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPainter, QColor, QPen
from PyQt5.QtWidgets import QRadioButton, QApplication


class StylishRadioButton(QRadioButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent)

        # 添加自定义的初始化代码
        self.setCustomProperties()
        self.setCustomStyle()

    def setCustomProperties(self):
        # 添加自定义的属性设置
        self.setFixedSize(150, 50)

    def setCustomStyle(self):
        # 添加自定义的样式设置
        self.setStyleSheet(
            '''
            QRadioButton {
                background-color: #fca311;
                color: #ffffff;
                border: none;
                border-radius: 10px;
                font-size: 16px;
            }

            QRadioButton:hover {
                background-color: #e5a634;
            }

            QRadioButton:pressed {
                background-color: #d18925;
            }
            '''
        )

    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            print("Custom radio button clicked!")

        # 调用父类的方法以保留单选按钮的默认行为
        super().mousePressEvent(event)

    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)
        painter.setPen(QPen(QColor("#14213d"), 2))  # 设置边框颜色和宽度
        painter.setBrush(QColor("#fca311"))  # 设置背景颜色
        painter.drawEllipse(self.rect().center(), 15, 15)  # 绘制圆形
        painter.drawText(self.rect(), Qt.AlignCenter, self.text())

        painter.end()


if __name__ == '__main__':
    app = QApplication([])
    radio_button = StylishRadioButton("Choose Me")
    radio_button.show()
    app.exec()

五、简单总结

在使用 PyQt 框架开发应用程序时，掌握按钮的用法是至关重要的。按钮不仅仅是一个简单的界面元素，它承担着用户与应用程序交互的重要角色。通过充分利用按钮的功能和定制选项，我们可以创造出令用户满意的用户界面。

希望本博客能够帮助读者理解 PyQt 按钮的基本知识和用法，并激发他们进一步探索和实践的兴趣。祝愿读者在使用 PyQt 框架时能够灵活运用按钮，并开发出出色的用户界面。