QTimer::singleShot

原创已于 2025-01-02 13:57:00 修改 · 2.9k 阅读

CC 4.0 BY-SA版权

文章标签：

于 2025-01-02 08:37:50 首次发布

QTimer::singleShot 是 Qt 框架中的一个静态函数，用于在指定的时间间隔后执行一个函数或槽（slot）。这个函数非常有用，当你需要在未来某个时刻执行一次性任务时，比如延迟执行某个操作、在一段时间后关闭窗口或者更新界面元素等。

使用方法

QTimer::singleShot 的基本用法很简单，它接受两个参数：

毫秒数（ms）：指定延迟的时间，以毫秒为单位。
接收者（receiver） 和 成员函数（member function）（或者一个函数对象、lambda 表达式）：指定延迟后要执行的操作。

示例

假设你有一个按钮点击后，想要在 2 秒（2000 毫秒）后显示一个消息框，你可以这样写：

#include <QApplication>
#include <QPushButton>
#include <QMessageBox>
#include <QTimer>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QPushButton button("点击我");
    QObject::connect(&button, &QPushButton::clicked, [&]() {
        QTimer::singleShot(2000, []() {
            QMessageBox::information(nullptr, "延迟消息", "2秒后显示的消息！");
        });
    });

    button.show();
    return app.exec();
}

在这个例子中，当按钮被点击时，QTimer::singleShot 被调用，设置了一个 2000 毫秒（2秒）的延迟。延迟结束后，执行了一个 lambda 函数，该函数显示了一个消息框。

注意事项

如果指定的接收者在执行前被删除，那么传递给 singleShot 的成员函数将不会被调用。
singleShot 是一个静态函数，因此你不需要创建 QTimer 的实例来使用它。
在多线程环境中使用时，确保接收者和它所在的线程是活跃的，因为 singleShot 会在接收者所在的线程中执行指定的函数。

QTimer::singleShot 是一个方便且强大的工具，适用于需要在未来某个时刻执行一次性任务的场景。

1.QTimer::singleShot有多少种重载

QTimer::singleShot 是 Qt 框架中用于创建单次定时器的静态方法。在 Qt 5 和 Qt 6 中，QTimer::singleShot 提供了多种重载形式，以便满足不同的使用需求。以下是常见的几种重载形式：

基于毫秒和回调函数的重载：
- 函数原型：void QTimer::singleShot(int msec, const QObject *receiver, const char *member);
- 参数说明：
  - msec：定时器超时之前的毫秒数。
  - receiver：接收定时器信号的对象。
  - member：接收对象中要调用的成员函数（槽）。
- 示例：
```
class MyClass : public QObject {
    Q_OBJECT
public slots:
    void mySlot() {
        qDebug() << "Slot executed!";
    }
};

MyClass obj;
QTimer::singleShot(1000, &obj, SLOT(mySlot()));
```
基于毫秒和 Lambda 表达式的重载（Qt 5.7 及更高版本）：
- 函数原型：template<typename Func> void QTimer::singleShot(int msec, Func func);
- 参数说明：
  - msec：定时器超时之前的毫秒数。
  - func：要调用的可调用对象（如 lambda 表达式）。
- 示例：
```
QTimer::singleShot(1000, []() {
    qDebug() << "Lambda executed!";
});
```
基于毫秒、Qt 信号和槽机制的重载：
- 函数原型：QTimer *QTimer::singleShot(int msec, QObject *receiver, const char *signal);
- 参数说明：
  - msec：定时器超时之前的毫秒数。
  - receiver：接收信号的对象。
  - signal：要发送的信号（通常是某个对象的信号成员函数）。
- 注意：虽然这种重载形式在 Qt 5 和 Qt 6 中存在，但在 Qt 6 中，QTimer::singleShot 返回的是 void 而不是 QTimer *，因此这种用法在 Qt 6 中已不适用。
基于时间点和回调函数的重载（Qt 5.14 及更高版本）：
- 函数原型：void QTimer::singleShot(const QTime &time, const QObject *receiver, const char *member);
- 参数说明：
  - time：定时器超时的具体时间点（QTime 对象）。
  - receiver：接收定时器信号的对象。
  - member：接收对象中要调用的成员函数（槽）。
基于时间点和 Lambda 表达式的重载（Qt 5.14 及更高版本）：
- 函数原型：template<typename Func> void QTimer::singleShot(const QTime &time, Func func);
- 参数说明：
  - time：定时器超时的具体时间点（QTime 对象）。
  - func：要调用的可调用对象（如 lambda 表达式）。

这些重载提供了灵活的方式来设置单次定时器，使得开发者可以根据具体需求选择最适合的方法。例如，使用 lambda 表达式可以简化代码，而使用信号和槽机制可以更好地与 Qt 的信号槽系统集成。

需要注意的是，Qt 官方文档可能没有直接列出所有可能的重载形式，但上述方式基本涵盖了 QTimer::singleShot 在不同场景下的使用方式。在实际开发中，应根据具体需求和 Qt 版本选择合适的方式。

2.qt 200毫秒后执行一段代码

在 Qt 中，如果你想在 200 毫秒后执行一段代码，可以使用 QTimer 类。QTimer 允许你设置一个时间间隔，在时间间隔结束时触发一个信号，你可以连接这个信号到你想要执行的槽函数。

以下是一个简单的示例，展示如何在 200 毫秒后执行一段代码：

#include <QCoreApplication>
#include <QTimer>
#include <QDebug>

class MyClass : public QObject {
    Q_OBJECT

public slots:
    void executeCode() {
        qDebug() << "Code executed after 200 milliseconds";
    }
};

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    MyClass myObject;

    QTimer timer;
    QObject::connect(&timer, &QTimer::timeout, &myObject, &MyClass::executeCode);

    // Set the timer to timeout after 200 milliseconds
    timer.start(200);

    return a.exec();
}

#include "main.moc"

解释

包含必要的头文件：
- #include <QCoreApplication>：用于控制台应用程序。
- #include <QTimer>：用于定时器功能。
- #include <QDebug>：用于调试输出。
定义槽函数：
- class MyClass : public QObject：定义一个继承自 QObject 的类。
- public slots：声明一个槽函数 executeCode()，将在定时器超时时调用。
在 main 函数中：
- 创建 QCoreApplication 对象。
- 创建 MyClass 的实例。
- 创建 QTimer 对象。
- 使用 QObject::connect 将定时器的 timeout 信号连接到 MyClass 的 executeCode 槽函数。
- 调用 timer.start(200) 设置定时器在 200 毫秒后超时。
- 进入事件循环 a.exec()。

注意事项

如果你在 GUI 应用程序中使用，可以将 QCoreApplication 替换为 QApplication。
#include "main.moc" 是为了包含由 qmake 或 cmake 自动生成的 MOC（Meta-Object Compiler）文件。如果你手动编译，确保 MOC 文件被正确生成和包含。

这样，程序将在启动 200 毫秒后执行 executeCode 函数，输出 "Code executed after 200 milliseconds"。

3.qt 200毫秒后执行一段代码，用表达式，传入this

在 Qt 中，如果你想在 200 毫秒后执行一段代码，并且希望使用表达式的方式，同时传入 this 指针（通常意味着在当前对象中执行某些操作），你可以使用 QTimer::singleShot 静态方法。这是一个非常方便的方法，因为它不需要显式地创建和管理 QTimer 对象。

以下是一个示例，展示如何使用 QTimer::singleShot 在 200 毫秒后执行一个成员函数：

#include <QCoreApplication>
#include <QTimer>
#include <QDebug>

class MyClass : public QObject {
    Q_OBJECT

public:
    MyClass() {
        // 使用 QTimer::singleShot 在 200 毫秒后调用 executeCode
        QTimer::singleShot(200, this, &MyClass::executeCode);
    }

public slots:
    void executeCode() {
        qDebug() << "Code executed after 200 milliseconds";
    }
};

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    MyClass myObject;

    return a.exec();
}

#include "main.moc"

解释

QTimer::singleShot:
- QTimer::singleShot(200, this, &MyClass::executeCode); 是一个静态方法调用。
- 第一个参数 200 是延迟时间，以毫秒为单位。
- 第二个参数 this 是指向当前对象的指针。
- 第三个参数 &MyClass::executeCode 是指向成员函数的指针。
槽函数:
- executeCode() 是一个槽函数，它将在 200 毫秒后被调用。
- 该函数使用 qDebug() 输出一条消息，表示代码已被执行。
在 main 函数中:
- 创建 QCoreApplication 对象。
- 创建 MyClass 的实例，构造函数中设置了 singleShot。
- 进入事件循环 a.exec()。