Qt之QTimer
简述
QTimer类提供了重复和单次触发信号的定时器。
QTimer类为定时器提供了一个高级别的编程接口。很容易使用：首先，创建一个QTimer，连接timeout()信号到适当的槽函数，并调用start()，然后在恒定的时间间隔会发射timeout()信号。
注意：当QTimer的父对象被销毁时，它也会被自动销毁。
- 简述
- 详细说明
- 精度
- 替代QTimer
- 成员函数
- 信号
- 示例
- 效果
- 源码
详细说明
模拟时钟的例子，1秒（1000毫秒）更新一次：
QTimer *timer = new QTimer(this);
connect(timer, SIGNAL(timeout()), this, SLOT(update()));
timer->start(1000);start()之后，每秒都会调用update()。
可以通过设置setSingleShot(true)来让定时器只执行一次。也可以使用静态函数QTimer::singleShot()：
QTimer::singleShot(200, this, SLOT(updateCaption()));在多线程程序中，可以在一个有事件循环的任何线程中使用QTimer。使用QThread::exec()，从非GUI线程启动一个事件循环。 Qt使用定时器的线程关联，以确定哪个线程会发出timeout()信号。正因为如此，你必须在它的线程中启动和停止定时器，不可能从另一个线程启动定时器。
作为一个特例，一旦窗口系统事件队列中的所有事件都已经被处理完，一个定时为0的QTimer就会到时间了。当需要提供流畅的用户界面时，可以用这来做比较繁重的工作。
QTimer *timer = new QTimer(this);
connect(timer, SIGNAL(timeout()), this, SLOT(processOneThing()));
timer->start();这时，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为例，利用开始和停止按钮来操作一个进度条的更新。
效果
源码
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();
// 设置新的进度值
m_pProgressBar->setValue(nCurrentValue);
}在槽函数updateProgress()中，首先通过m_pProgressBar->value()来获取当前进度值，然后加1，当进度大于等于100时停止定时器（再继续执行已经没任何意义了，因为进度已经达到了100，而且不停止还消耗资源），然后设置进度条的值。