《快速掌握PyQt5》第十章 定时器QTimer和进度条QProgressBar

2022-10-13 09:45:30

第十章 定时器QTimer和进度条QProgressBar

10.1 QTimer

10.2 QProgressBar

10.3 小结


当我们要让程序定期去执行某函数的时候,QTimer就派上用场了,比如一个游戏程序,它通常会定期去调用一个函数来进行更新操作。而进度条可以用来显示某项任务的进度,从而让用户界面更加友好。

我们通常将将QTimer和QProgressBar一起搭配使用,所以本章就一起介绍了。

10.1 QTimer

以下这个程序中,按钮被点击后,QLabel显示的数字会不断增加:

import sys
from PyQt5.QtCore import QTimer, Qt
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QLabel, QVBoxLayout


class Demo(QWidget):
    def __init__(self):
        super(Demo, self).__init__()
        self.label = QLabel('0', self)                          # 1
        self.label.setAlignment(Qt.AlignCenter)                 

        self.step = 0                                           # 2

        self.timer = QTimer(self)                               # 3
        self.timer.timeout.connect(self.update_func)

        self.ss_button = QPushButton('Start', self)             # 4
        self.ss_button.clicked.connect(self.start_stop_func)

        self.v_layout = QVBoxLayout()
        self.v_layout.addWidget(self.label)
        self.v_layout.addWidget(self.ss_button)

        self.setLayout(self.v_layout)

    def start_stop_func(self):                      
        if not self.timer.isActive():
            self.ss_button.setText('Stop')
            self.timer.start(100)
        else:
            self.ss_button.setText('Start')
            self.timer.stop()

    def update_func(self):
        self.step += 1
        self.label.setText(str(self.step))


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1.  首先实例化一个QLabel,并将文本设为0。setAlignment(Qt.AlignCenter)可以让QLabel控件在窗口中居中显示,而之前我们是通过addStretch(int)方法来让一个控件在布局中居中的,显然通过setAlignment(Qt.AlignCenter)方法更加方便:

self.h_layout.addStretch(1)
self.h_layout.addWidget(self.label)
self.h_layout.addStretch(1)

2. step变量用于计数,QLabel控件显示的就是这里的step,程序会通过QTimer来不断增加step的值;

3. 其次实例化一个QTimer,并将timeout信号连接到自定义的槽函数update_func()上:

def update_func(self):
    self.step += 1
    self.label.setText(str(self.step))

每次调用该槽函数就会将step值加1,并且用QLabel显示当前值;

4. 最后我们实例化一个QPushButton按钮来控制定时器的启动的停止,连接的自定义的槽函数如下:

def start_stop_func(self):                      
    if not self.timer.isActive():
        self.ss_button.setText('Stop')
        self.timer.start(100)
    else:
        self.ss_button.setText('Start')
        self.timer.stop()

在槽函数中通过isActive()方法来判断定时器是否处于激活状态,若没有激活,则将按钮文字变成Stop并通过start(100)方法来启动定时器,100表示100毫秒,也就是说每过0.1秒,定时器就会触发timeout信号,并执行update_func()槽函数;若已经处于激活状态,则将按钮文字变回Start并通过stop()方法停止定时器。

有些小伙伴可能想在触发timeout信号后只调用一次update_func(),那么我们可以通过setSingleShot(True)方法来设置。

运行截图如下:

10.2 QProgressBar

这里我们将10.1章节中的QLabel用QProgressBar来代替:

import sys
from PyQt5.QtCore import Qt, QTimer
from PyQt5.QtWidgets import QApplication, QWidget, QProgressBar, QPushButton, QHBoxLayout, QVBoxLayout


class Demo(QWidget):
    def __init__(self):
        super(Demo, self).__init__()
        self.progressbar = QProgressBar(self)                   # 1
        # self.progressbar.setOrientation(Qt.Vertical)          
        self.progressbar.setMinimum(0)                          # 2
        self.progressbar.setMaximum(100)
        # self.progressbar.setRange(0, 100)
        
        self.step = 0                                           # 3
        
        self.timer = QTimer(self)                               # 4
        self.timer.timeout.connect(self.update_func)

        self.ss_button = QPushButton('Start', self)             # 5
        self.ss_button.clicked.connect(self.start_stop_func)
        self.reset_button = QPushButton('Reset', self)          # 6
        self.reset_button.clicked.connect(self.reset_func)
        
        self.h_layout = QHBoxLayout()
        self.v_layout = QVBoxLayout()

        self.h_layout.addWidget(self.ss_button)
        self.h_layout.addWidget(self.reset_button)
        self.v_layout.addWidget(self.progressbar)
        self.v_layout.addLayout(self.h_layout)

        self.setLayout(self.v_layout)

    def start_stop_func(self):
        if self.ss_button.text() == 'Start':
            self.ss_button.setText('Stop')
            self.timer.start(100)
        else:
            self.ss_button.setText('Start')
            self.timer.stop()

    def update_func(self):
        self.step += 1
        self.progressbar.setValue(self.step)

        if self.step >= 100:
            self.ss_button.setText('Start')
            self.timer.stop()
            self.step = 0

    def reset_func(self):
        self.progressbar.reset()
        self.ss_button.setText('Start')
        self.timer.stop()
        self.step = 0


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1. 实例化一个QProgressBar,默认是水平的,但是我们可以通过setOrientation(Qt.Vertical)方法来让进度条垂直显示;

2. 通过setMinimum()和setMaximum()方法来设置范围,也可以单单用setRange()方法来实现,这里我们将范围设为0-100;

3. 这里的step变量用于计数,之后QProgressBar会将值设为step;

4. 实例化一个QTimer,并将timeout信号连接到update_func()槽函数上:

def update_func(self):
    self.step += 1
    self.progressbar.setValue(self.step)

    if self.step >= 100:
        self.ss_button.setText('Start')
        self.timer.stop()
        self.step = 0

每次触发timeout都会调用该槽函数,在这里我们将step值加1,并将progressbar的值设为step,当step值达到pregress的最大值时(也就是说进度条达到100%),将按钮文本重新设为Start,停止定时器并将step值重设为0;

5. 实例化一个QPushButton按钮来控制QTimer的启动与停止,这里将它的clicked信号和start_stop_func()槽函数连接起来:

def start_stop_func(self):
    if self.ss_button.text() == 'Start':
        self.ss_button.setText('Stop')
        self.timer.start(100)
    else:
        self.ss_button.setText('Start')
        self.timer.stop()

在槽函数中,我们通过按钮文字来进行判断,若为Start,则说明定时器没有启动,所以将按钮文字设为Stop,并且通过start(100)方法来启动,100表示100毫秒,即0.1秒。也就是说之后每隔0.1秒就会触发timeout信号并调用update_func()槽函数;若按钮文字为Stop,则将其设为Start并停止定时器(我们在10.1章节中时通过定时器isActive()方法来的,当然这里也可以使用);

6. 该实例化的按钮用于重置进度条:

def reset_func(self):
    self.progressbar.reset()
    self.ss_button.setText('Start')
    self.timer.stop()
    self.step = 0

其所连接的槽函数中通过reset()方法来进行重置,还有将按钮文字设为Start,停止定时器以及将step值设为0。

运行截图如下:

10.3 小结

1. QTimer定时器会根据设定的时间不断发出timeout信号并调用连接的槽函数,通过start(int)方法来设置时间并启动定时器,stop()方法用于停止定时器;

2. 通过isActive()方法来判断定时器是否被激活,setSingleShot()方法可以在触发timeout信号后只调用一次槽函数;

3. 通过setOrientation(Qt.Vertical)方法可以将进度条设为垂直显示;

4. setMinimum()和setMaximum()方法用来设置进度条范围(可以用setRange()替代),setValue()方法用于设置进度条的当前值,reset()方法用于重置进度条。

bug记录:在Mac上QPushButton的文字改变有点问题。

  • 作者:la_vie_est_belle
  • 原文链接:https://pyqt5.blog.csdn.net/article/details/82597562
    更新时间:2022-10-13 09:45:30