Timer QML Type
Löst in einem festgelegten Intervall einen Handler aus. Mehr...
| Import Statement: | import QtQml |
Eigenschaften
- interval : int
- repeat : bool
- running : bool
- triggeredOnStart : bool
Signale
Methoden
Ausführliche Beschreibung
Ein Timer kann verwendet werden, um eine Aktion entweder einmalig oder wiederholt in einem bestimmten Intervall auszulösen.
Hier ist ein Timer, der das aktuelle Datum und die aktuelle Uhrzeit anzeigt und den Text alle 500 Millisekunden aktualisiert. Er nutzt das JavaScript- Date -Objekt, um auf die aktuelle Uhrzeit zuzugreifen.
import QtQuick 2.0
Item {
Timer {
interval: 500; running: true; repeat: true
onTriggered: time.text = Date().toString()
}
Text { id: time }
}Der Timer-Typ ist mit dem Animationstimer synchronisiert. Da der Animationstimer in der Regel auf 60 fps eingestellt ist, beträgt die Auflösung des Timers bestenfalls 16 ms.
Wenn der Timer läuft und eine seiner Eigenschaften geändert wird, wird die verstrichene Zeit zurückgesetzt. Wird beispielsweise bei einem Timer mit einem Intervall von 1000 ms die Eigenschaft „repeat“ 500 ms nach dem Start geändert, wird die verstrichene Zeit auf 0 zurückgesetzt, und der Timer wird 1000 ms später ausgelöst.
Siehe auch „Qt Quick “-Demo – Uhren.
Dokumentation zu den Eigenschaften
interval : int
Legt die interval e zwischen den Auslösern in Millisekunden fest.
Das Standardintervall beträgt 1000 Millisekunden.
repeat : bool
Wenn „ repeat “ auf „true“ gesetzt ist, wird der Timer im angegebenen Intervall wiederholt ausgelöst; andernfalls wird der Timer einmal im angegebenen Intervall ausgelöst und stoppt anschließend (d. h., „running“ wird auf „false“ gesetzt).
repeat Standardwert ist „false“.
Siehe auch „ running “.
running : bool
Wird auf „true“ gesetzt, wird der Timer gestartet; andernfalls wird er gestoppt. Bei einem einmaligen Timer wird „ running “ nach dem Auslösen des Timers auf „false“ gesetzt.
running Standardwert ist „false“.
Siehe auch „ repeat “.
triggeredOnStart : bool
Wenn ein Timer gestartet wird, erfolgt die erste Auslösung in der Regel erst nach Ablauf des festgelegten Intervalls. Manchmal ist es jedoch wünschenswert, dass der Timer sofort nach dem Start ausgelöst wird, beispielsweise um einen Anfangszustand herzustellen.
Ist „ triggeredOnStart “ auf „true“ gesetzt, wird der Timer sofort nach dem Start ausgelöst und anschließend im festgelegten Intervall. Beachten Sie, dass der Timer bei einer Einstellung von „repeat“ auf „false“ zweimal ausgelöst wird: einmal beim Start und erneut nach Ablauf des Intervalls.
triggeredOnStart Die Standardeinstellung ist „false“.
Siehe auch „ running “.
Signal-Dokumentation
triggered()
Dieses Signal wird ausgelöst, wenn der Timer abgelaufen ist.
Hinweis: Der entsprechende Handler lautet „ onTriggered “.
Methodendokumentation
void restart()
Startet den Timer neu
Wenn der Timer nicht läuft, wird er gestartet; andernfalls wird er angehalten, in den Ausgangszustand zurückgesetzt und gestartet. Die Eigenschaft „ running “ ist nach einem Aufruf von „ restart() “ auf „true“ gesetzt.
void start()
Startet den Timer
Wenn der Timer bereits läuft, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft „ running “ ist nach einem Aufruf von „ start() “ auf „true“ gesetzt.
void stop()
Hält den Timer an
Wenn der Timer nicht läuft, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft „ running “ ist nach einem Aufruf von „ stop() “ auf „false“ gesetzt.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.