PyQt5 是一个基于 Python 的跨平台图形用户界面(GUI)开发框架,它通过将 Python 与 C++ 开发的 Qt 库绑定,为开发者提供了构建桌面应用程序的强大工具。在一些应用程序开发过程中我们经常会遇到一些进度条显示的需求,比如说程序下载进度、任务执行进度等。
在PyQt5中显示进度条主要通过QProgressBar控件实现,结合不同的任务处理机制(如定时器或线程)来动态更新进度。
-
定时器模拟进度
适用于简单任务或进度模拟,使用QTimer定期更新进度条值:
python
import sys
from PyQt5.QtWidgets import QApplication, QWidget, QProgressBar, QPushButton
from PyQt5.QtCore import QTimer
class ProgressBarDemo(QWidget):
def __init__(self):
super().__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 300, 150) # 窗口位置和大小
self.progress_bar = QProgressBar(self)
self.progress_bar.setGeometry(50, 40, 200, 25) # 进度条位置和尺寸[3](@ref)
self.progress_bar.setValue(0) # 初始值
self.btn = QPushButton("开始", self)
self.btn.move(110, 80)
self.btn.clicked.connect(self.start_progress)
self.timer = QTimer()
self.timer.timeout.connect(self.update_progress)
self.current_value = 0
def start_progress(self):
if not self.timer.isActive():
self.timer.start(100) # 每100ms触发一次更新[1](@ref)
def update_progress(self):
self.current_value += 1
if self.current_value > 100:
self.timer.stop()
return
self.progress_bar.setValue(self.current_value) # 更新进度值[5](@ref)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = ProgressBarDemo()
window.show()
sys.exit(app.exec_())
-
-
使用QTimer定时触发update_progress方法逐步增加进度值
-
setValue()更新进度条显示,范围默认0-100(可通过setRange()自定义)
-
-
使用多线程来更新任务
当执行耗时任务(如文件处理、网络请求)时,需用QThread避免阻塞主线程
python
import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QProgressBar, QPushButton
from PyQt5.QtCore import QThread, pyqtSignal
class WorkerThread(QThread):
progress_signal = pyqtSignal(int) # 自定义信号传递进度值[4](@ref)
def run(self):
for i in range(1, 101):
self.progress_signal.emit(i) # 发送当前进度
self.msleep(50) # 模拟耗时操作
class MainWindow(QMainWindow):
def __init__(self):
super().__init__()
self.progress_bar = QProgressBar(self)
self.progress_bar.setGeometry(50, 40, 200, 25)
self.btn = QPushButton("开始任务", self)
self.btn.move(100, 80)
self.btn.clicked.connect(self.start_task)
def start_task(self):
self.thread = WorkerThread()
self.thread.progress_signal.connect(self.update_progress)
self.thread.start() # 启动子线程[4](@ref)
self.btn.setEnabled(False)
def update_progress(self, value):
self.progress_bar.setValue(value) # 主线程更新UI
if value == 100:
self.btn.setEnabled(True)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = MainWindow()
window.resize(300, 150)
window.show()
sys.exit(app.exec_())
-
子线程WorkerThread执行任务并发射信号progress_signal
-
主线程通过信号槽机制安全更新UI(避免跨线程操作崩溃)