Timer QML Type

Löst einen Handler in einem bestimmten Intervall aus. Mehr...

Import Statement: import QtQml

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

interval : int
repeat : bool
running : bool
triggeredOnStart : bool

Signale

triggered()

Methoden

restart()
start()
stop()

Ausführliche Beschreibung

Ein Timer kann verwendet werden, um eine Aktion entweder einmal oder wiederholt in einem bestimmten Intervall auszulösen.

Hier ist ein Timer, der das aktuelle Datum und die Uhrzeit anzeigt und den Text alle 500 Millisekunden aktualisiert. Er verwendet das JavaScript-Objekt Date, um auf die aktuelle Zeit 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 Animations-Timer synchronisiert. Da der Animationstimer in der Regel auf 60fps eingestellt ist, beträgt die Auflösung von Timer bestenfalls 16ms.

Wenn der Timer läuft und eine seiner Eigenschaften geändert wird, wird die verstrichene Zeit zurückgesetzt. Wenn z.B. bei einem Timer mit einem Intervall von 1000ms die Wiederholungseigenschaft 500ms nach dem Start geändert wird, wird die verstrichene Zeit auf 0 zurückgesetzt, und der Timer wird 1000ms später ausgelöst.

Siehe auch Qt Quick Demo - Clocks.

Eigenschaft Dokumentation

interval : int

Legt den interval zwischen den Auslösungen in Millisekunden fest.

Das Standardintervall beträgt 1000 Millisekunden.

repeat : bool

Wenn repeat true ist, wird der Timer wiederholt im angegebenen Intervall ausgelöst; andernfalls wird der Timer einmal im angegebenen Intervall ausgelöst und dann angehalten (d. h. running wird auf false gesetzt).

repeat Der Standardwert ist false.

Siehe auch running.

running : bool

Bei true wird der Timer gestartet, andernfalls wird er gestoppt. Bei einem nicht-wiederkehrenden Timer wird running auf false gesetzt, nachdem der Timer ausgelöst wurde.

running ist standardmäßig auf false gesetzt.

Siehe auch repeat.

triggeredOnStart : bool

Wenn ein Zeitgeber gestartet wird, erfolgt die erste Auslösung normalerweise nach Ablauf des angegebenen Intervalls. Manchmal ist es wünschenswert, sofort nach dem Start des Zeitgebers auszulösen, z. B. um einen Anfangszustand herzustellen.

Wenn triggeredOnStart auf true gesetzt ist, wird der Timer sofort nach dem Start und anschließend in dem angegebenen Intervall ausgelöst. Wenn repeat auf false gesetzt ist, wird der Timer zweimal ausgelöst: einmal beim Start und dann noch einmal nach dem Intervall.

triggeredOnStart Der Standardwert ist false.

Siehe auch running.

Signal Dokumentation

triggered()

Dieses Signal wird ausgegeben, wenn der Timer das Zeitlimit überschreitet.

Hinweis: Der entsprechende Handler ist onTriggered.

Methode Dokumentation

restart()

Startet den Timer neu

Wenn der Timer nicht läuft, wird er gestartet, andernfalls wird er angehalten, in den Anfangszustand zurückgesetzt und gestartet. Die Eigenschaft running wird nach einem Aufruf von restart() auf true gesetzt.

start()

Startet den Timer

Wenn der Timer bereits läuft, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft running wird nach einem Aufruf von start() auf true gesetzt.

stop()

Stoppt den Timer

Wenn der Timer nicht läuft, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft running wird nach einem Aufruf von stop() auf false gesetzt.

© 2025 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.