QTimer Class

Dokumentation zu den Member-Funktionen

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

Erstellt einen Timer mit der angegebenen „ parent “.

[virtual noexcept] QTimer::~QTimer()

Löscht den Timer.

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

Stellt eine Verbindung vom Signal „ timeout()“ des Timers zu „ slot “ her. Gibt ein Handle für die Verbindung zurück.

Diese Methode dient der Vereinfachung. Sie entspricht dem Aufruf von:

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

Siehe auch ` QObject::connect()` und ` timeout()`.

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

Stellt eine Verbindung vom Signal „ timeout()“ zu „ slot “ her, die in eine bestimmte Ereignisschleife von „ context “ eingefügt werden soll, und gibt ein Handle für die Verbindung zurück.

Diese Methode dient der Vereinfachung. Sie entspricht dem Aufruf von:

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

Siehe auch QObject::connect() und timeout().

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

Gibt einen ` Qt::TimerId ` zurück, der die Timer-ID darstellt, wenn der Timer läuft; andernfalls wird ` Qt::TimerId::Invalid` zurückgegeben.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ Qt::TimerId “.

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

Gibt das Intervall dieses Timers als „ std::chrono::milliseconds “-Objekt zurück.

Siehe auch „ interval “.

bool QTimer::isActive() const

Gibt „ true “ zurück, wenn der Timer läuft; andernfalls wird „ false “ zurückgegeben.

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

Gibt die verbleibende Zeit in diesem Timer-Objekt als „ std::chrono::milliseconds “-Objekt zurück. Ist dieser Timer abgelaufen oder überfällig, lautet der Rückgabewert „ std::chrono::milliseconds::zero() “. Konnte die verbleibende Zeit nicht ermittelt werden oder läuft der Timer nicht, gibt diese Funktion eine negative Dauer zurück.

Siehe auch ` remainingTime()`.

Diese statische Funktion ruft „ functor “ nach „ interval “ auf.

Die Verwendung dieser Funktion ist sehr praktisch, da Sie sich nicht um ein ` timerEvent ` kümmern oder ein lokales ` QTimer `-Objekt erstellen müssen.

Wenn „ context “ angegeben ist, wird „ functor “ nur dann aufgerufen, wenn das Objekt „ context “ vor Ablauf des Intervalls nicht zerstört wurde. Der Funktor wird dann im Thread von „ context “ ausgeführt. Der Thread des Kontexts muss über eine laufende Qt-Ereignisschleife verfügen.

Ist „ functor “ eine Mitgliedsfunktion von „ context “, wird die Funktion für das Objekt aufgerufen.

Der Parameter ` interval ` kann ein ` int ` (interpretiert als Millisekundenwert) oder ein Typ ` std::chrono ` sein, der implizit in Nanosekunden umgewandelt wird.

Ab Qt 6.10 führt die Festlegung eines negativen Intervalls zu einer Laufzeitwarnung, und der Wert wird auf 1 ms zurückgesetzt. Vor Qt 6.10 ließ sich bei einem Qt-Timer zwar ein negatives Intervall festlegen, das Verhalten war jedoch unvorhersehbar (beispielsweise wurde der Timer angehalten, wenn er lief, oder gar nicht erst gestartet).

Hinweis: Diese Funktion ist reentrant.

Siehe auch ` start()`.

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

Diese statische Funktion ruft nach Ablauf eines bestimmten Zeitintervalls einen Slot auf.

Die Verwendung dieser Funktion ist sehr praktisch, da Sie sich nicht um ein „ timerEvent “ kümmern oder ein lokales „ QTimer “-Objekt erstellen müssen.

Das „ receiver “ ist das Empfängerobjekt und „ member “ ist der Slot. Das Zeitintervall wird im Dauerobjekt „ nsec “ angegeben.

Ab Qt 6.10 führt die Festlegung eines negativen Intervalls zu einer Laufzeitwarnung und der Wert wird auf 1 ms zurückgesetzt. Vor Qt 6.10 ließ sich bei einem Qt-Timer zwar ein negatives Intervall festlegen, das Verhalten war jedoch unvorhersehbar (beispielsweise wurde der Timer angehalten, wenn er lief, oder gar nicht erst gestartet).

Hinweis: Diese Funktion ist reentrant.

Siehe auch ` start()`.

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

Diese statische Funktion ruft nach Ablauf eines bestimmten Zeitintervalls einen Slot auf.

Die Verwendung dieser Funktion ist sehr praktisch, da Sie sich nicht um ein „ timerEvent “ kümmern oder ein lokales „ QTimer “-Objekt erstellen müssen.

receiver ist das Empfängerobjekt und member ist der Slot. Das Zeitintervall wird im Dauerobjekt nsec angegeben. timerType beeinflusst die Genauigkeit des Timers.

Ab Qt 6.10 führt die Festlegung eines negativen Intervalls zu einer Laufzeitwarnung, und der Wert wird auf 1 ms zurückgesetzt. Vor Qt 6.10 ließ sich bei einem Qt-Timer zwar ein negatives Intervall festlegen, das Verhalten war jedoch unvorhersehbar (beispielsweise wurde der Timer angehalten, wenn er lief, oder gar nicht erst gestartet).

Hinweis: Diese Funktion ist reentrant.

Siehe auch ` start()`.

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

Startet oder setzt den Timer mit einer Zeitüberschreitungsdauer von msec Millisekunden zurück.

Dies entspricht:

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

Wenn der Timer bereits läuft, wird er nach Ablauf von stopped neu gestartet. Dadurch ändert sich auch der Wert von „ id()“.

Ist ` singleShot ` wahr, wird der Timer nur einmal aktiviert.

Ab Qt 6.10 führt die Angabe eines negativen Intervalls zu einer Laufzeitwarnung und der Wert wird auf 1 ms zurückgesetzt. Vor Qt 6.10 ließ sich bei einem Qt-Timer zwar ein negatives Intervall festlegen, das Verhalten war jedoch unvorhersehbar (beispielsweise wurde der Timer angehalten, wenn er lief, oder gar nicht erst gestartet).

// 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()

Startet oder setzt den Timer mit der in „ interval “ angegebenen Zeitüberschreitung zurück.

Wenn der Timer bereits läuft, wird er auf „ stopped “ gesetzt und neu gestartet. Dadurch ändert sich auch sein Wert für „ id()“.

Ist ` singleShot ` wahr, wird der Timer nur einmal aktiviert.

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

Startet oder startet den Timer erneut mit einer Zeitüberschreitung von interval Millisekunden.

Dies entspricht:

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

Wenn der Timer bereits läuft, wird er auf „ stopped “ gesetzt und neu gestartet. Dadurch ändert sich auch sein Wert „ id()“.

Ist ` singleShot ` wahr, wird der Timer nur einmal aktiviert.

Ab Qt 6.10 führt die Festlegung eines negativen Intervalls zu einer Laufzeitwarnung und der Wert wird auf 1 ms zurückgesetzt. Vor Qt 6.10 ließ sich bei einem Qt-Timer zwar ein negatives Intervall festlegen, das Verhalten war jedoch unvorhersehbar (beispielsweise wurde der Timer gestoppt, wenn er lief, oder gar nicht erst gestartet).

[slot] void QTimer::stop()

Hält den Timer an.

Siehe auch „ start()“.

[private signal] void QTimer::timeout()

Dieses Signal wird ausgesendet, wenn der Timer abgelaufen ist.

Siehe auch interval, start() und stop().

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

Implementiert: ` QObject::timerEvent(QTimerEvent *event)`.

int QTimer::timerId() const

Gibt die ID des Timers zurück, wenn dieser läuft; andernfalls wird -1 zurückgegeben.