QTimer Class

メンバ関数のドキュメント

[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)

timeout() シグナルからslot への接続を作成し、これをcontext の特定のイベントループに配置するとともに、その接続へのハンドルを返します。

このメソッドは利便性のために提供されています。これは、以下の呼び出しと同等です：

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

QObject::connect() およびtimeout()も参照してください 。

[since 6.8] Qt::TimerId QTimer::id() const

タイマーが実行中の場合は、タイマーIDを表すQt::TimerId を返します。そうでない場合は、Qt::TimerId::Invalid を返します。

この関数は Qt 6.8 で導入されました。

Qt::TimerIdも参照してください 。

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()も参照してください 。

この静的関数は、interval の後にfunctor を呼び出します。

この関数を使用すると、timerEvent を気にかけたり、ローカルのQTimer オブジェクトを作成したりする必要がないため、非常に便利です。

context が指定されている場合、functor は、インターバルが発生する前にcontext オブジェクトが破棄されていない場合にのみ呼び出されます。その後、ファンクタはcontext のスレッドで実行されます。コンテキストのスレッドには、実行中の Qt イベントループが存在している必要があります。

functor がcontext のメンバ関数である場合、その関数はオブジェクトに対して呼び出されます。

interval パラメータは、int （ミリ秒数として解釈される）または、暗黙的にナノ秒に変換されるstd::chrono 型であることができます。

Qt 6.10 以降、負のインターバルを設定すると、実行時の警告が表示され、値は 1ms にリセットされます。 Qt 6.10 以前は、Qt Timer で負の間隔を設定することは可能でしたが、予期しない動作（例えば、タイマーが実行中であれば停止したり、まったく開始されなかったりすること）が発生していました。

注：この関数は再入可能です。

start()も参照してください 。

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, const QObject *receiver, const char *member)

この静的関数は、指定された時間間隔が経過した後にスロットを呼び出します。

timerEvent を気にかける必要も、ローカルのQTimer オブジェクトを作成する必要もないため、この関数を使用するのは非常に便利です。

receiver は受信オブジェクト、member はスロットです。時間間隔は、nsec オブジェクトで指定されます。

Qt 6.10 以降、負の間隔を設定すると、実行時の警告が表示され、値は 1ms にリセットされます。 Qt 6.10 以前では、Qt Timer で負の間隔を設定することは可能でしたが、予期しない動作（例えば、タイマーが実行中であれば停止したり、まったく開始されなかったりすること）が発生していました。

注：この関数は再入可能です。

start()も参照してください 。

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, Qt::TimerType timerType, const QObject *receiver, const char *member)

この静的関数は、指定された時間間隔が経過した後にスロットを呼び出します。

timerEvent を気にかけたり、ローカルのQTimer オブジェクトを作成したりする必要がないため、この関数を使用するのは非常に便利です。

receiver は受信オブジェクト、member はスロットです。時間間隔は、nsec オブジェクトで指定されます。timerType は、タイマーの精度に影響します。

Qt 6.10以降、負の間隔を設定すると、実行時の警告が表示され、値は1msにリセットされます。 Qt 6.10 以前では、Qt Timer で負の間隔を設定することは可能でしたが、予期しない動作（例えば、タイマーが実行中であれば停止したり、まったく開始されなかったりすること）が生じることがありました。

注：この関数は再入可能です。

start()も参照してください 。

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

msec ミリ秒のタイムアウト間隔でタイマーを開始または再開します。

これは、以下の処理と同等です：

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

タイマーがすでに実行中の場合は、stopped となり、再起動されます。これにより、id() も変更されます。

singleShot がtrueの場合、タイマーは1回だけ起動されます。

Qt 6.10 以降、負の間隔を設定すると、実行時警告が発生し、値は 1ms にリセットされます。 Qt 6.10 以前は、Qt Timer で負の間隔を設定することは可能でしたが、予期せぬ動作（たとえば、実行中のタイマーが停止したり、まったく開始されなかったり）が発生していました。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer](int msec) { receiver->start(msec); });

[slot] void QTimer::start()

interval で指定されたタイムアウト時間に基づいて、タイマーを開始または再起動します。

タイマーがすでに実行中の場合は、stopped となり、再起動されます。これにより、id() の値も変更されます。

singleShot が true の場合、タイマーは 1 回だけ起動されます。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload<>(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer]() { receiver->start(); });

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

interval ミリ秒のタイムアウトを設定して、タイマーを開始または再開します。

これは以下と同等です:

timer.setInterval(interval);
timer.start();

タイマーがすでに実行中の場合、stopped となり、再起動されます。これにより、id() の値も変更されます。

singleShot がtrueの場合、タイマーは1回のみ起動されます。

Qt 6.10 以降、負の間隔を設定すると、実行時警告が発生し、値が 1ms にリセットされます。 Qt 6.10 以前では、Qt Timer で負の間隔を設定することは可能でしたが、予期せぬ動作（例えば、実行中のタイマーが停止したり、まったく開始されなかったりすること）が発生していました。

[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を返します。