QChronoTimer Class

详细说明

QChronoTimer 类为定时器提供了一个高级编程接口。要使用它，请创建一个 QChronoTimer 对象——既可以通过在构造函数中传入间隔来创建，也可以在创建后使用setInterval() 方法设置间隔，然后将其timeout() 信号连接到相应的槽函数，并调用start() 方法。 此后，它将以恒定的间隔发出timeout()信号。例如：

        auto *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
        QTimer *timer = new QTimer(this);
        connect(timer, &QTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();

此后，processOneThing() 将被反复调用。应将其编写为始终快速返回（例如，在处理完一个数据项后），以便 Qt 能向用户界面传递事件，并在完成所有工作后立即停止计时器。 这是在 GUI 应用程序中处理繁重任务的传统方法，但随着多线程技术在更多平台上变得可用，一种现代的替代方案是在 GUI（主）线程之外的另一个线程中执行繁重任务。Qt 提供了QThread 类，可用于实现这一目的。

精度与定时器分辨率

计时器的精度取决于底层操作系统和硬件。大多数平台支持为计时器请求纳秒级精度（例如，libc 的 `nanosleep`），尽管在许多实际应用场景中，计时器的精度并不会达到这一分辨率。

您可以设置 `timer type ` 参数，以告知 QChronoTimer 应向系统请求何种精度。

对于Qt::PreciseTimer ，QChronoTimer将尝试将精度保持在1ns 。精确计时器绝不会比预期更早超时。

对于Qt::CoarseTimer 和Qt::VeryCoarseTimer 类型，QChronoTimer可能会在预期时间之前唤醒，但仍在这些类型的容差范围内：

• 间隔的 5% 对于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 会尽力绕过这些限制。