PyQt 中的繁忙指示 – 使用 PyQt 进度条

在本文中，我们将介绍如何在 PyQt 应用程序中使用进度条来显示繁忙指示。进度条是一个常用的用户界面元素，它可以向用户展示任务的进度情况。无论是处理大量数据、加载文件还是执行复杂的计算，使用进度条可以提高用户体验，让用户知道任务的进展状态。

阅读更多：PyQt 教程

PyQt 进度条简介

PyQt 是一个流行的用于创建桌面应用程序的 Python GUI 框架。它提供了丰富的功能和组件，其中包括进度条。进度条是 PyQt 中的一个小部件，可以用于显示任务的进度情况。在 PyQt 中，我们可以根据任务的进度更新进度条，使用户了解任务的执行状态。

在 PyQt 中创建进度条

要在 PyQt 中创建进度条，我们需要使用 QProgressBar 控件。首先，我们需要导入 PyQt 的相关模块：

from PyQt5.QtWidgets import QApplication, QMainWindow, QProgressBar
from PyQt5.QtCore import QThread, pyqtSignal

然后，在我们的主窗口类中创建进度条对象，并将其添加到窗口布局中：

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.progress_bar = QProgressBar(self)
        self.setCentralWidget(self.progress_bar)

        self.setWindowTitle('PyQt Progress Bar')
        self.show()

在上面的代码中，我们创建了一个 QProgressBar 对象，并将其设置为中央窗口部件。然后，我们设置了窗口标题并显示窗口。

现在，让我们来看看如何在后台线程中更新进度条。

在后台线程中更新进度条

为了不阻塞 PyQt 主线程，更新进度条的操作应该在后台线程中进行。我们可以使用 QThread 类来创建一个后台线程，并通过信号-槽机制来更新进度条。

首先，我们需要定义一个任务类，该类继承自 QThread：

class Task(QThread):
    progress_updated = pyqtSignal(int)

    def __init__(self):
        super().__init__()

    def run(self):
        for i in range(101):
            self.progress_updated.emit(i)
            self.msleep(50)

在上述代码中，我们创建了一个自定义的 QThread 子类 Task，并定义了一个 progress_updated 信号。在 run() 方法中，我们使用 for 循环模拟一个任务，循环中通过 emit 语句发送当前进度的信号，并通过 msleep() 方法将线程休眠一段时间以模拟任务的执行。

接下来，在我们的主窗口类中创建 Task 对象，并连接 progress_updated 信号到更新进度条的槽函数：

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.progress_bar = QProgressBar(self)
        self.setCentralWidget(self.progress_bar)

        self.setWindowTitle('PyQt Progress Bar')

        self.task = Task()
        self.task.progress_updated.connect(self.update_progress_bar)

        self.show()

    def update_progress_bar(self, value):
        self.progress_bar.setValue(value)

在上述代码中，我们创建了一个 Task 对象，并将其 progress_updated 信号连接到 update_progress_bar 槽函数。在槽函数中，我们使用 setValue() 方法更新进度条的值。

现在，让我们启动任务并看到进度条的更新效果。

启动任务并更新进度条

要启动任务并更新进度条，我们只需要在主窗口类中调用 task 对象的 start() 方法即可：

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.progress_bar = QProgressBar(self)
        self.setCentralWidget(self.progress_bar)

        self.setWindowTitle('PyQt Progress Bar')

        self.task = Task()
        self.task.progress_updated.connect(self.update_progress_bar)
        self.task.start()

        self.show()

在上述代码中，我们创建了一个 Task 对象，并将其 progress_updated 信号连接到 update_progress_bar 槽函数。然后，我们调用了 task 对象的 start() 方法，启动了任务。

现在，当我们运行应用程序时，将会看到进度条进行动态更新，显示任务的进度状态。

完整代码示例

下面是一个完整的示例代码，展示了如何在 PyQt 中使用进度条来显示繁忙指示：

from PyQt5.QtWidgets import QApplication, QMainWindow, QProgressBar
from PyQt5.QtCore import QThread, pyqtSignal

class Task(QThread):
    progress_updated = pyqtSignal(int)

    def __init__(self):
        super().__init__()

    def run(self):
        for i in range(101):
            self.progress_updated.emit(i)
            self.msleep(50)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.progress_bar = QProgressBar(self)
        self.setCentralWidget(self.progress_bar)

        self.setWindowTitle('PyQt Progress Bar')

        self.task = Task()
        self.task.progress_updated.connect(self.update_progress_bar)
        self.task.start()

        self.show()

    def update_progress_bar(self, value):
        self.progress_bar.setValue(value)

if __name__ == '__main__':
    app = QApplication([])
    window = MainWindow()
    app.exec_()