QTimer Class

メンバ関数ドキュメント

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

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

context が指定された場合、インターバルが発生する前にcontext オブジェクトが破棄されていない場合にのみ、functor が呼び出されます。このファンクタは、context のスレッドで実行されます。 コンテキストのスレッドでは、Qtイベントループが実行されていなければなりません。

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

interval パラメータには、int （ミリ秒カウントとして解釈される）または、暗黙的にナノ秒に変換されるstd::chrono 型を指定できます。

注意：この関数はリエントラントである。

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()をオーバーロードする。

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

このメソッドは便宜上提供されている。を呼び出すのと同じです：

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()も参照 。

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

これはオーバーロードされた関数である。

この静的関数は、与えられた時間間隔の後にスロットを呼び出す。

この関数を使うと、わざわざtimerEvent 、ローカルのQTimer オブジェクトを作成する必要がないので非常に便利です。

receiver が受信オブジェクトで、member がスロットです。時間間隔は duration オブジェクトnsec で与えられます。

注意：この関数はリエントラントである。

start()も参照のこと 。

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

これはオーバーロードされた関数である。

この静的関数は、与えられた時間間隔の後にスロットを呼び出す。

この関数を使うと、わざわざtimerEvent 、ローカルのQTimer オブジェクトを作成する必要がないので非常に便利です。

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

注意：この関数はリエントラントである。

start()も参照のこと 。

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

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

タイマーがすでに実行されている場合は、stopped 、再起動される。また、id （）も変更される。

singleShot がtrueの場合、タイマーは一度だけ起動される。これと同じである：

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

[slot] void QTimer::start()

この関数は start()をオーバーロードする。

interval で指定されたタイムアウトでタイマーを開始または再起動する。

タイマーがすでに動作している場合は、stopped 、再起動される。また、id （）も変更される。

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

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

これはオーバーロードされた関数です。

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

タイマーがすでに動いている場合は、stopped 、再起動されます。また、id （）も変更されます。

singleShot がtrueの場合、タイマーは一度だけ起動される。これは以下と同じである：

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