---

前言

QTimer 是 Qt 中用于定时操作的类，可以用来在特定时间间隔触发事件。它在实现周期性任务、延时操作和动画等场景中非常有用。本文将详细介绍 QTimer 的使用方法、函数原型及其作用，并通过一个实例代码展示如何使用 QTimer 每秒生成一次随机数并显示在 LCDNumber 控件中。

---

QTimer 是什么

QTimer 是 Qt 提供的定时器类，用于在一定时间间隔后触发特定的操作。定时器可以设置为单次触发或周期性触发。在 GUI 应用程序中，QTimer 通常用于定时刷新界面、执行后台任务等。

什么时候使用 QTimer

QTimer 适用于以下场景：

• 周期性任务：如每隔一段时间刷新界面或获取数据。
• 延时操作：如延迟执行某个操作。
• 动画：如在固定时间间隔内更新动画帧。

定时器时间到了调用什么函数

当定时器时间到了，QTimer 会发出 timeout() 信号。可以通过连接这个信号到一个槽函数，来定义定时器超时后需要执行的操作。

void QTimer::timeout();

QTimer 的所有函数

构造函数与析构函数

QTimer(QObject *parent = nullptr)

QTimer(QObject *parent = nullptr);

• 作用：创建一个新的 QTimer 对象。
• 参数：
  • QObject *parent：定时器的父对象（可选）。
• 返回值：无。

基本操作

void start(int msec)

void start(int msec);

• 作用：以指定的时间间隔（毫秒）启动定时器。
• 参数：
  • int msec：时间间隔（毫秒）。
• 返回值：无。

void start()

void start();

• 作用：以上一次设置的时间间隔启动定时器。
• 参数：无。
• 返回值：无。

void stop()

void stop();

• 作用：停止定时器。
• 参数：无。
• 返回值：无。

bool isActive() const

bool isActive() const;

• 作用：判断定时器是否正在运行。
• 参数：无。
• 返回值：返回布尔值 true 表示定时器正在运行，false 表示未运行。

定时器属性

void setInterval(int msec)

void setInterval(int msec);

• 作用：设置定时器的时间间隔。
• 参数：
  • int msec：时间间隔（毫秒）。
• 返回值：无。

int interval() const

int interval() const;

• 作用：获取定时器的时间间隔。
• 参数：无。
• 返回值：返回定时器的时间间隔（毫秒）。

void setSingleShot(bool singleShot)

void setSingleShot(bool singleShot);

• 作用：设置定时器是否为单次触发。
• 参数：
  • bool singleShot：布尔值，true 表示单次触发，false 表示周期性触发。
• 返回值：无。

bool isSingleShot() const

bool isSingleShot() const;

• 作用：判断定时器是否为单次触发。
• 参数：无。
• 返回值：返回布尔值 true 表示单次触发，false 表示周期性触发。

静态函数

static void singleShot(int msec, const QObject *receiver, const char *member)

static void singleShot(int msec, const QObject *receiver, const char *member);

• 作用：创建一个单次触发的定时器。
• 参数：
  • int msec：时间间隔（毫秒）。
  • const QObject *receiver：接收定时器超时信号的对象。
  • const char *member：槽函数的字符串表示，格式为 "slot()"。
• 返回值：无。

static void singleShot(int msec, Qt::TimerType timerType, const QObject *receiver, const char *member)

static void singleShot(int msec, Qt::TimerType timerType, const QObject *receiver, const char *member);

• 作用：创建一个带定时器类型的单次触发定时器。
• 参数：
  • int msec：时间间隔（毫秒）。
  • Qt::TimerType timerType：定时器类型。
  • const QObject *receiver：接收定时器超时信号的对象。
  • const char *member：槽函数的字符串表示，格式为 "slot()"。
• 返回值：无。

定时器类型

void setTimerType(Qt::TimerType type)

void setTimerType(Qt::TimerType type);

• 作用：设置定时器类型。
• 参数：
  • Qt::TimerType type：定时器类型。
• 返回值：无。

Qt::TimerType timerType() const

Qt::TimerType timerType() const;

• 作用：获取定时器类型。
• 参数：无。
• 返回值：返回定时器的类型。

示例代码：QTimer 每 1 秒生成一次随机数并显示在 LCDNumber 上

以下是一个使用 QTimer 每秒生成一个随机数并显示在 LCDNumber 控件上的示例代码：

头文件

#include <QApplication>
#include <QWidget>
#include <QTimer>
#include <QLCDNumber>
#include <QVBoxLayout>
#include <cstdlib>
#include <ctime>

class RandomNumberWidget : public QWidget {
    Q_OBJECT
public:
    RandomNumberWidget(QWidget *parent = nullptr) : QWidget(parent) {
        lcdNumber = new QLCDNumber(this);
        lcdNumber->setDigitCount(5);

        QVBoxLayout *layout = new QVBoxLayout(this);
        layout->addWidget(lcdNumber);
        setLayout(layout);

        timer = new QTimer(this);
        connect(timer, &QTimer::timeout, this, &RandomNumberWidget::updateRandomNumber);
        timer->start(1000);

        std::srand(std::time(nullptr)); // Seed the random number generator
    }

public slots:
    void updateRandomNumber() {
        int randomNumber = std::rand() % 100000; // Generate a random number between 0 and 99999
        lcdNumber->display(randomNumber);
    }

private:
    QLCDNumber *lcdNumber;
    QTimer *timer;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    RandomNumberWidget widget;
    widget.resize(200, 100);
    widget.show();
    return app.exec();
}

#include "main.moc"

代码详解

1. 创建 RandomNumberWidget 类：这是一个继承自 QWidget 的类，用于显示随机数。
2. 初始化 QLCDNumber：创建 QLCDNumber 对象并设置显示的位数。
3. 布局管理：使用 QVBoxLayout 将 QLCDNumber 添加到布局中。
4. 初始化 QTimer：创建 QTimer 对象，并将其 timeout() 信号连接到自定义槽函数 updateRandomNumber()。
5. 启动定时器：设置定时器每隔 1000 毫秒（1 秒）触发一次。
6. 生成随机数：在槽函数 updateRandomNumber() 中生成一个随机数，并显示在 QLCDNumber 上。
7. 随机数生成种子：使用 std::srand(std::time(nullptr)) 为随机数生成器设定种子。

---

总结

QTimer 是 Qt 提供的强大定时器类，适用于各种定时操作场景。通过 QTimer 可以轻松实现周期性任务、延时操作和动画等功能。本文详细介绍了 QTimer 的用法及其常用函数，并通过一个实例代码展示了如何使用 QTimer 每秒生成一次随机数并显示在 LCDNumber 控件上。掌握 QTimer 的使用方法，可以极大提升 Qt 应用程序的功能性和交互性。