QChronoTimer Class

详细说明

QChronoTimer 类为定时器提供了高级编程接口。要使用它，只需创建一个 QChronoTimer，将时间间隔传递给构造函数，或在构造函数完成后使用setInterval() 设置时间间隔，将timeout() 信号连接到相应的插槽，然后调用start() 即可。从那时起，它将以恒定的时间间隔发出timeout() 信号。例如

        QChronoTimer *timer = new QChronoTimer(1s, this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();
        QChronoTimer *timer = new QChronoTimer(this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->setInterval(1s);
        timer->start();

您可以通过调用setSingleShot(true)，将定时器设置为只超时一次。

在多线程应用程序中，您可以在任何有事件循环的线程中使用 QChronoTimer。要从非 GUI 线程启动事件循环，请使用QThread::exec() 。Qt 使用定时器的thread affinity 来确定哪个线程将发出timeout() 信号。因此，您必须在其线程中启动和停止定时器；不可能从其他线程启动定时器。

作为一种特例，超时时间为0ns 的 QChronoTimer 将尽快超时，但零定时器和其他事件源之间的排序未作规定。零定时器可以用来完成一些工作，同时还能提供反应灵敏的用户界面：

        // The default interval is 0ns
        QChronoTimer *timer = new QChronoTimer(this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();

从那时起，processOneThing() 将被反复调用。它的编写方式应使其始终快速返回（例如，处理完一个数据项后），这样 Qt Quick 就能向用户界面传递事件，并在完成所有工作后立即停止定时器。这是 GUI 应用程序中实现繁重工作的传统方法，但随着多线程技术在更多平台上的应用，一种现代的替代方法是在 GUI（主）线程以外的线程中完成繁重的工作。Qt XML 拥有QThread 类，可用于实现这一点。

精度和定时器分辨率

定时器的精度取决于底层操作系统和硬件。大多数平台都支持为定时器请求纳秒级精度（例如，libc 的nanosleep ），不过在许多实际情况下，定时器的精度并不等同于这一分辨率。

您可以设置timer type ，告诉 QChronoTimer 向系统请求的精度。

对于Qt::PreciseTimer ，QChronoTimer 会尽量将精度保持在1ns 。精确定时器绝不会提前超时。

对于Qt::CoarseTimer 和Qt::VeryCoarseTimer 类型，QChronoTimer 可能会比预期提前唤醒，但不会超出这些类型的范围：

• 对于Qt::CoarseTimer
• 500ms 对于Qt::VeryCoarseTimer

如果系统繁忙或无法提供所需的精度，所有定时器类型的超时时间都可能晚于预期。在这种超时超限的情况下，Qt 将只发出一次timeout() ，即使多次超时已过，然后将恢复原来的时间间隔。

QChronoTimer 的替代方案

QChronoTimer 提供纳秒级的分辨率和 ±292 年的范围（如果时间间隔长于std::numeric_limits<int>::max() ，则整数溢出的可能性较小）。如果只需要毫秒分辨率和 ±24 天范围，则可以继续使用经典的QTimer 类。

另一种方法是在您的类（必须是QObject 的子类）中重新实现QObject::timerEvent() 方法，并使用以下方法之一：

• 使用QBasicTimer ，这是一个封装了计时器 ID 的轻量级值类。您可以使用QBasicTimer::start() 启动定时器，使用QBasicTimer::stop() 停止定时器。您可以在重新实现的timerEvent() 中处理事件。
• 更低级的方法是直接操作定时器 ID。要启动定时器，请调用QObject::startTimer() 并存储返回的 ID。要停止计时器，请调用QObject::killTimer() 。您可以在重新实现的timerEvent() 中处理事件。这种方法通常比使用QBasicTimer 更麻烦。

使用timerEvent() 的缺点是不支持某些高级功能，如单发定时器和信号。

有些操作系统限制了可使用的定时器数量；Qt 会尽力绕过这些限制。