Qt定时器(QObject 和 QTimer、QTime、QDateTime)应用技术详解

Qt定时器应用详解

一、定时器概述

在软件开发中，定时器（Timer）是实现周期性任务、延时操作和时间敏感功能的核心组件。Qt框架提供了两种主要定时器实现方式：

1. QObject基础定时器：通过QObject::startTimer()实现

2. QTimer类：封装好的高级定时器组件
   两者都基于操作系统的事件循环机制，具有跨平台特性。

---

二、基础定时器实现（QObject接口）

1. 关键方法

• startTimer(int interval): 启动定时器返回ID

• timerEvent(QTimerEvent*): 重写事件处理函数

• killTimer(int id): 停止指定定时器

2. 实现步骤

头文件

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE

#define TIMEOUT 1 * 1000 //间隔时间

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void on_btnStart_clicked();

    void on_btnStop_clicked();
    //重写QObject类的timerEvent方法
    virtual void timerEvent(QTimerEvent *event);
    void on_btnOperQTimeForm_clicked();

private:
    Ui::MainWindow *ui;
    int myTimeId;//定时器编号
    int picId;
};
#endif // MAINWINDOW_H

CPP

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include "qtimewindow.h"
#include <QDebug>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    //显示第一张图片
    QPixmap pix(":/image/1.jpg");
    ui->lbImage->setPixmap(pix);

    picId = 1;
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::on_btnStart_clicked()
{
    //QObject 提供的定时器
    //开启定时器 ，返回定时器编号
    myTimeId = this->startTimer(TIMEOUT);
    ui->btnStart->setEnabled(false);
}


void MainWindow::on_btnStop_clicked()
{
    //杀掉定时器
    this->killTimer(myTimeId);
    ui->btnStart->setEnabled(true);
}
//定时器时间到触发的回调方法
void MainWindow::timerEvent(QTimerEvent *event)
{
    //qDebug()<< "timeEvent() "<<event->timerId();
    if(event->timerId() != myTimeId)
        return;

    picId++;
    //qDebug()<< "timeEvent() "<<event->timerId()<<",picId:"<<picId;
    if(picId > 8)
    {
        picId=1;
    }
    //显示图片
    QPixmap pix(":/image/"+QString::number(picId)+".jpg");
    ui->lbImage->setPixmap(pix);
}


void MainWindow::on_btnOperQTimeForm_clicked()
{
    QTimeWindow *wid = new QTimeWindow();
    wid->show();
}

用定时器切换图片的示例

UI效果

UI设计

项目结构

---

三、QTimer类（推荐方式）

1. 基本使用

//导入引用
#include <QTimer>

头文件

#ifndef QTIMEWINDOW_H
#define QTIMEWINDOW_H

#include <QMainWindow>
//导入引用
#include <QTimer>

namespace Ui {
class QTimeWindow;
}

class QTimeWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit QTimeWindow(QWidget *parent = nullptr);
    ~QTimeWindow();

private slots:
    //定时器时间到时触发的方法
    void timeoutSlot();

    void on_btnStart_clicked();

    void on_btnStop_clicked();

    void on_btnSing_clicked();

private:
    Ui::QTimeWindow *ui;
    int picId;
    QTimer *m_time;//声明定时器
};

#endif // QTIMEWINDOW_H

cpp

#include "qtimewindow.h"
#include "mainwindow.h"
#include "ui_qtimewindow.h"
#include <QDateTime>

QTimeWindow::QTimeWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::QTimeWindow)
{
    ui->setupUi(this);

    //显示第一张图片
    QImage image;
    image.load(":/image/1.jpg");
    ui->lbImage->setPixmap(QPixmap::fromImage(image));

    picId = 1;

    m_time = new QTimer;
    //定时器时间到，发出timeout信号
    connect(m_time,&QTimer::timeout,this,&QTimeWindow::timeoutSlot);
}

QTimeWindow::~QTimeWindow()
{
    delete ui;
}

void QTimeWindow::timeoutSlot()
{
    picId++;
    //qDebug()<< "timeEvent() "<<event->timerId()<<",picId:"<<picId;
    if(picId > 8)
    {
        picId=1;
    }
    //显示图片
    QImage image;
    image.load(":/image/"+QString::number(picId)+".jpg");
    ui->lbImage->setPixmap(QPixmap::fromImage(image));

    //显示系统日期时间
    auto dateTimeStr = QDateTime::currentDateTime().toString("yyyy-MM-dd HH:mm:ss");
    ui->lbShowDataTime->setText(dateTimeStr);

    // 更新当前时间
    QTime currentTime = QTime::currentTime();
}

//开始
void QTimeWindow::on_btnStart_clicked()
{
    //m_time->setInterval(TIMEOUT);//设置间隔
    //启动定时器，并设置间隔时间
    m_time->start(TIMEOUT);
    ui->btnStart->setEnabled(false);
}


void QTimeWindow::on_btnStop_clicked()
{
    //停止定时器
    m_time->stop();
    ui->btnStart->setEnabled(true);
}

//单次调用，在确定要延时多长时间后执行一次
void QTimeWindow::on_btnSing_clicked()
{
    //TIMEOUT 延时时间
    //&QTimeWindow::timeoutSlot 调用方法
    QTimer::singleShot(TIMEOUT,this,&QTimeWindow::timeoutSlot);
}

剩余时间查询：

int remaining = timer->remainingTime();

四、定时器类型对比

特性	QObject定时器	QTimer类
实现方式	继承+事件重写	组合+信号槽
多定时器支持	需要手动管理ID	自动管理
单次触发	需手动停止	支持单次模式
线程安全	需在主线程使用	支持跨线程
易用性	较低	较高

---

五、实际应用案例

1. 任务调度系统

2. 界面动画

3. 数据采集系统

4. 游戏主循环

5. 设备主流程循环

六、注意事项

1. 精度问题

• Windows默认精度约15ms

• 使用Qt::PreciseTimer可提升精度

• 实时性要求高应考虑专用计时器

2. 事件循环依赖

• 定时器需在有效事件循环中运行

• 在子线程中使用需执行exec()

3. 资源管理

// 正确释放资源
void cleanup() {
    timer->stop();
    delete timer;
}

4. 性能优化

• 避免在超时处理中执行耗时操作

• 多个定时器尽量合并处理

• 使用QTimer::singleShot替代多个独立定时器

5. 线程安全

// 跨线程使用示例
QThread *workerThread = new QThread;
QTimer *threadTimer = new QTimer;
threadTimer->moveToThread(workerThread);
connect(workerThread, &QThread::started, [=](){
    threadTimer->start(1000);
});

七、调试技巧

1. 使用qDebug() << QTime::currentTime();跟踪实际触发时间

2. 通过QTimer::remainingTime()检测定时器状态

3. 在事件循环阻塞时使用QCoreApplication::processEvents()

八、总结

Qt定时器系统为开发者提供了灵活的时间管理方案：

• 简单任务使用QTimer::singleShot

• 周期任务首选QTimer类

• 需要精细控制时使用QObject定时器

• 高精度需求考虑QElapsedTimer组合使用

正确使用定时器可以创建响应灵敏、性能优良的应用程序，但需注意避免过度使用导致资源浪费。

---

本文涵盖了Qt定时器的主要使用场景和关键技术细节，可根据具体需求选择最适合的实现方案。建议结合Qt文档中的QTimer、QTimerEvent和QObject类参考进行深入理解。