Qt 之 QTimer

简述

QTimer类提供了重复和单次触发信号的定时器。

QTimer类为定时器提供了一个高级别的编程接口。很容易使用:首先,创建一个QTimer,连接timeout()信号到适当的槽函数,并调用start(),然后在恒定的时间间隔会发射timeout()信号。

注意:当QTimer的父对象被销毁时,它也会被自动销毁。

| 版权声明:一去、二三里,未经博主允许不得转载。

详细说明

Qt之模拟时钟中,1秒(1000毫秒)更新一次:

QTimer *timer = new QTimer(this);
connect(timer, SIGNAL(timeout()), this, SLOT(update()));
timer->start(1000);
  
  
  • 1
  • 2
  • 3

start()之后,每秒都会调用update()。

可以通过设置setSingleShot(true)来让定时器只执行一次。也可以使用静态函数QTimer::singleShot():

QTimer::singleShot(200, this, SLOT(updateCaption()));
  
  
  • 1

在多线程程序中,可以在一个有事件循环的任何线程中使用QTimer。使用QThread::exec(),从非GUI线程启动一个事件循环。 Qt使用定时器的线程关联,以确定哪个线程会发出timeout()信号。正因为如此,你必须在它的线程中启动和停止定时器,不可能从另一个线程启动定时器。

作为一个特例,一旦窗口系统事件队列中的所有事件都已经被处理完,一个定时为0的QTimer就会到时间了。当需要提供流畅的用户界面时,可以用这来做比较繁重的工作。

QTimer *timer = new QTimer(this);
connect(timer, SIGNAL(timeout()), this, SLOT(processOneThing()));
timer->start();
  
  
  • 1
  • 2
  • 3

这时,processOneThing()将会被重复调用并且应该很快返回(通常在处理一个数据项之后),这样Qt可以把事件传送给窗口部件,并且一旦它完成这个工作就停止这个定时器。这是在图形用户界面应用程序中实现繁重的工作的一个典型方法,现在多线程可以在越来越多的平台上使用,我们希望0-毫秒QTimer对象最终被线程替代。

精度

定时器的精度取决于底层操作系统和硬件。绝大多数平台支持精度为1毫秒,尽管定时器的准确性在许多现实世界的情况下和这不相符。

准确性也取决于定时器类型(Qt::TimerType)。对于Qt::PreciseTimer来说,QTimer将试图保持精确度在1毫秒。精确的定时器也从来不会比预计的还要早超时。

对于Qt::CoarseTimer和Qt::VeryCoarseTimer类型,QTimer可能早于预期,在间隔之内被唤醒:Qt::CoarseTimer为间隔的5%,Qt::VeryCoarseTimer为500毫秒。

枚举Qt::TimerType:

常量 描述
Qt::PreciseTimer 0 精确的定时器,尽量保持毫秒精度。
Qt::CoarseTimer 1 粗略的定时器,尽量保持精度在所需的时间间隔5%范围内。
Qt::VeryCoarseTimer 2 很粗略的定时器,只保留完整的第二精度。

在UNIX (包括: Linux、OS X、iOS)中,Qt将为Qt::PreciseTimer保持毫秒精度,对于Qt::CoarseTimer,间隔将调整到5%,使定时器与其他定时器匹配或在差不多在同一时间,目标是让大多数定时器在同一时间醒来,从而减少CPU唤醒和功耗。

在Windows上,Qt将为Qt::PreciseTimer使用Windows的多媒体定时器工具(如果可用),为Qt::CoarseTimer和Qt::VeryCoarseTimer使用正常的Windows定时器。

所有平台上,Qt::VeryCoarseTimer的间隔被四舍五入到最接近完整的第二位(例如:23500ms的时间间隔将被舍入到24000ms,20300ms舍入至20000)。

替代QTimer

另一个使用QTimer的方法:为你的对象调用QObject::startTimer(),在你的类中(必须继承QObject)重新实现QObject::timerEvent()事件处理器。缺点是timerEvent()不支持像单次触发定时器或信号那样的高级特性。

另一个选择是QBasicTimer。它通常比使用QObject::startTimer() 直接。可以查看助手中Timers描述的三种方法。

一些操作系统限制可能会限制定时器的数量,Qt会尽力在限制范围内工作。

可参考:QBasicTimer、QTimerEvent、QObject::timerEvent()、Timers、Analog Clock Example、Wiggly Example。

成员函数

  • bool isActive() const
    如果定时器正在运行,返回true,否则返回false。

  • int remainingTime() const
    返回定时器的剩余时间(毫秒为单位),直到超时。

    如果定时器不活跃,返回值是-1。如果定时器过期,返回值为0。

  • void setInterval(int msec)
    设置超时间隔(毫秒为单位)。

    默认值是0,这时,一旦窗口系统事件队列中的所有事件都已经被处理完,一个时间间隔为0的QTimer就会触发。

  • void setSingleShot(bool singleShot)
    设置定时器是否为单次触发。

    单次触发定时器只触发一次,非单次的话,则每过一个时间间隔都会触发。

  • void setTimerType(Qt::TimerType atype)
    设置定时器的准确性。默认值是Qt::CoarseTimer。

  • int timerId() const
    如果定时器正在运行,返回定时器的ID,否则返回-1。

  • void start(int msec)
    启动或重新启动一个超时时间间隔为毫秒的定时器。

    如果定时器正在运行,它将被停止和重新启动。如果singleShot为true,定时器将只激活一次。

  • void start()
    同上,重载了start()。

  • void stop()
    停止定时器。

信号

  • void timeout()
    定时器超时后,这个信号被发射。

    注意:这是一个私有的信号。它可以在信号连接使用,但不能由用户发出。

示例

下面,我们以QTimer为例,利用开始和停止按钮来操作一个进度条的更新。

效果

Qt 之 QTimer

源码

QPushButton *pStartButton = new QPushButton(this);
QPushButton *pStopButton = new QPushButton(this);
m_pProgressBar = new QProgressBar(this);
m_pTimer = new QTimer();

pStartButton->setText(QString::fromLocal8Bit(“开始”));
pStopButton->setText(QString::fromLocal8Bit(“停止”));

m_pProgressBar->setRange(0, 100);
m_pProgressBar->setValue(50);

// 设置超时间隔
m_pTimer->setInterval(1000);

// 连接信号槽
connect(pStartButton, SIGNAL(clicked(bool)), m_pTimer, SLOT(start()));
connect(pStopButton, SIGNAL(clicked(bool)), m_pTimer, SLOT(stop()));
connect(m_pTimer, SIGNAL(timeout()), this, SLOT(updateProgress()));

// 槽函数
void MainWindow::updateProgress()
{
// 获取当前进度值,+1
int nCurrentValue = m_pProgressBar->value();
nCurrentValue++;
if (nCurrentValue >= 100)
m_pTimer->stop();

<span class="hljs-comment">// 设置新的进度值</span>
m_pProgressBar<span class="hljs-subst">-&gt;</span>setValue(nCurrentValue);

}

  • 1
  • 31

在槽函数updateProgress()中,首先通过m_pProgressBar->value()来获取当前进度值,然后加1,当进度大于等于100时停止定时器(再继续执行已经没任何意义了,因为进度已经达到了100,而且不停止还消耗资源),然后设置进度条的值。

更多参考

上一篇:QTimer计时器和QTimerEvent的应用


下一篇:QTimer::singleShot的作用