QTimer 类

成员函数文档

此静态函数在 msec 毫秒后调用 functor。

使用此函数非常方便，因为它不需要处理 timerEvent 或创建本地 QTimer 对象。

如果指定了 context，则只有当 context 对象在间隔发生之前未被销毁时，才会调用 functor。然后，会在 context 的线程中运行此函数。context的线程必须有一个正在运行的Qt事件循环。

如果 functor 是 context 的成员函数，则该函数将在对象上调用。

msec 参数可以是 int 或 std::chrono::milliseconds 值。

注意： 此函数是 可重入的。

另请参阅 start()。

[explicit] QTimer::QTimer(QObject *parent = nullptr)

使用给定的 parent 构建定时器。

[virtual noexcept] QTimer::~QTimer()

销毁定时器。

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(Functor &&slot)

从定时器的 timeout() 信号创建到 slot 的连接。返回连接的句柄。

提供此方法是为了方便。它与调用

QObject::connect(timer, &QTimer::timeout, timer, slot, Qt::DirectConnection);

另请参阅 QObject::connect() 和 timeout。

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(const QObject *context, Functor &&slot, Qt::ConnectionType connectionType = Qt::AutoConnection)

此函数重载 callOnTimeout()。

从timeout()信号创建到将在context的特定事件循环中放置的slot的连接，并返回连接句柄。

提供此方法是为了方便。它与调用

QObject::connect(timer, &QTimer::timeout, context, slot, connectionType);

另请参阅 QObject::connect() 和 timeout。

std::chrono::milliseconds QTimer::intervalAsDuration() const

返回计时器间隔作为std::chrono::milliseconds对象。

另请参阅：interval。

bool QTimer::isActive() const

如果计时器正在运行（挂起），则返回true；否则返回false。

std::chrono::milliseconds QTimer::remainingTimeAsDuration() const

以std::chrono::milliseconds对象返回此计时器对象剩余的时间。如果此计时器到时或逾期，则返回值是std::chrono::milliseconds::zero()。如果无法找到剩余时间或计时器未处于活动状态，则此函数返回一个负的持续时间。

另请参阅：remainingTime。

[静态] void QTimer::singleShot(int msec, const QObject *receiver, const char *member)

此静态函数在给定的时间间隔后调用槽。

使用此函数非常方便，因为它不需要处理 timerEvent 或创建本地 QTimer 对象。

示例

#include <QApplication>
#include <QTimer>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QTimer::singleShot(600000, &app, QCoreApplication::quit);
    ...
    return app.exec();
}

此示例程序将在10分钟后（600,000毫秒）自动终止。

receiver是接收对象，member是槽。时间间隔是msec毫秒。

注意： 此函数是 可重入的。

另请参阅：setSingleShot()和start。

[静态] void QTimer::singleShot(int msec, Qt::TimerType timerType, const QObject *receiver, const char *member)

这是一个重载函数。

此静态函数在给定的时间间隔后调用槽。

使用此函数非常方便，因为它不需要处理 timerEvent 或创建本地 QTimer 对象。

receiver是接收对象，member是槽。时间间隔为msec毫秒。计时器类型timerType影响计时器的精度。

注意： 此函数是 可重入的。

另请参阅 start()。

[静态] void QTimer::singleShot(std::chrono::milliseconds msec, const QObject *receiver, const char *member)

这是一个重载函数。

此静态函数在给定的时间间隔后调用槽。

使用此函数非常方便，因为它不需要处理 timerEvent 或创建本地 QTimer 对象。

receiver是接收对象，member是槽。时间间隔在持续时间对象msec中给出。

注意： 此函数是 可重入的。

另请参阅 start()。

[静态] void QTimer::singleShot(std::chrono::milliseconds msec, Qt::TimerType timerType, const QObject *receiver, const char *member)

这是一个重载函数。

此静态函数在给定的时间间隔后调用槽。

使用此函数非常方便，因为它不需要处理 timerEvent 或创建本地 QTimer 对象。

receiver是接收对象，member是槽。时间间隔在持续时间对象msec中给出。计时器类型timerType影响计时器的精度。

注意： 此函数是 可重入的。

另请参阅 start()。

[槽] void QTimer::start(int msec)

使用msec毫秒的超时间隔启动或重新启动计时器。

如果计时器已经在运行，它将被停止并重新启动。

如果 singleShot 为真，计时器只会激活一次。这相当于

timer.setInterval(msec);
timer.start();

[slot] void QTimer::start()

此函数重载了 start()。

使用在 interval 中指定的超时时间启动或重新启动计时器。

如果计时器已经在运行，它将被停止并重新启动。

如果 singleShot 为真，计时器只会激活一次。

void QTimer::start(std::chrono::milliseconds msec)

这是一个重载函数。

使用 msec 毫秒的超时时间启动或重新启动计时器。

如果计时器已经在运行，它将被停止并重新启动。

如果 singleShot 为真，计时器只会激活一次。这相当于

timer.setInterval(msec);
timer.start();

[slot] void QTimer::stop()

停止计时器。

另请参阅 start()。

[private signal] void QTimer::timeout()

当计时器超时时，将发出此信号。

另请参见 interval、start() 和 stop()。

[override virtual protected] void QTimer::timerEvent(QTimerEvent *e)

重新实现了：QObject::timerEvent(QTimerEvent *event).

int QTimer::timerId() const

如果计时器正在运行，则返回计时器的ID；否则返回 -1。