定时器类QTimer的简单使用

定时器类QTimer

使用流程：

1. 创建一个QTimer类对象后，设置定时器的周期时间间隔setInterval()

2. 然后调用其 start() 函数开启定时器

3. 此后QTimer对象就会周期性的发出 timeout() 信号。

   //[1]创建定时器
   QTimer timer = new QTimer(this);
   //[2]绑定信号槽函数
   connect(timer, &QTimer::timeout, this, &CountdownTimer::updateTimer);
   //[3]运行定时器
   timer->start(1000);
   //[4]停止定时器
   timer->stop();
   

常用API

// 如果指定了父对象, 创建的堆内存可以自动析构
QTimer::QTimer(QObject *parent = nullptr);

// 设置定时器时间间隔为 msec 毫秒
// 默认值是0，一旦窗口系统事件队列中的所有事件都已经被处理完，一个时间间隔为0的QTimer就会触发
void QTimer::setInterval(int msec);
// 获取定时器的时间间隔, 返回值单位: 毫秒
int QTimer::interval() const;

// 根据指定的时间间隔启动或者重启定时器, 需要调用 setInterval() 设置时间间隔
[slot] void QTimer::start();
// 启动或重新启动定时器，超时间隔为msec毫秒。
[slot] void QTimer::start(int msec);

// 停止定时器。
[slot] void QTimer::stop();

//设置定时器精度
/*
参数: 
    - Qt::PreciseTimer -> 精确的精度, 毫秒级
    - Qt::CoarseTimer  -> 粗糙的精度, 和1毫秒的误差在5%的范围内, 默认精度
    - Qt::VeryCoarseTimer -> 非常粗糙的精度, 精度在1秒左右
*/
void QTimer::setTimerType(Qt::TimerType atype);

// 设置定时器只触发一次, 参数为true定时器只触发一次, 为false定时器重复触发, 默认为false
void QTimer::setSingleShot(bool singleShot);
/*功能: 静态方法，用于创建一个只触发一次的定时器。在msec毫秒后发射一次信号, 并且只发射一次
  参数:
	- msec:     在msec毫秒后发射信号
	- receiver: 接收信号的对象地址
	- method:   槽函数地址*/
[static] void QTimer::singleShot(
        	int msec, const QObject *receiver, 
			PointerToMemberFunction method);

信号 signals

[signal] void QTimer::timeout();

代码示例

• 周期性定时器

  // 创建定时器对象
  QTimer* timer = new QTimer(this);
  // 修改定时器对象的精度
  timer->setTimerType(Qt::PreciseTimer);
  // 按钮 loopBtn 的点击按钮启动或者关闭定时器
  connect(ui->loopBtn, &QPushButton::clicked, this, [=](){
      // 启动定时器
      if(timer->isActive()){
          timer->stop();  // 关闭定时器
          ui->loopBtn->setText("开始");
      }
      else{
          ui->loopBtn->setText("关闭");
          timer->start(1000); // 1000ms == 1s
      }
  });
  connect(timer, &QTimer::timeout, this, [=](){
      QTime tm = QTime::currentTime();
      // 格式化当前得到的系统时间
      QString tmstr = tm.toString("hh:mm:ss.zzz");
      // 设置要显示的时间
      ui->curTime->setText(tmstr);
  });
  

• 一次性定时器

  // 点击按钮 onceBtn 只发射一次信号
  // 点击按钮一次, 发射一个信号, 得到某一个时间点的时间
  connect(ui->onceBtn, &QPushButton::clicked, this, [=]()
  {
       // 获取2s以后的系统时间, 不创建定时器对象, 直接使用类的静态方法
      QTimer::singleShot(2000, this, [=](){
          QTime tm = QTime::currentTime();
          // 格式化当前得到的系统时间
          QString tmstr = tm.toString("hh:mm:ss.zzz");
          // 设置要显示的时间
          ui->onceTime->setText(tmstr);
      });
  });