Timer QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

• triggered()

Methoden

• void restart()
• void start()
• void 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 das Intervall interval zwischen den Triggern 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 Zeitgeber gestartet, andernfalls wird er angehalten. Bei einem sich nicht wiederholenden 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 in der Regel 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.

Dokumentation der Methode

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 wird nach einem Aufruf von restart() auf true gesetzt.

void start()

Startet die Zeitschaltuhr

Wenn die Zeitschaltuhr bereits läuft, hat der Aufruf dieser Methode keine Auswirkungen. Die Eigenschaft running ist nach einem Aufruf von start() wahr.

void stop()

Stoppt den Timer

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