Timer QML Type

以指定的间隔触发处理程序。更多...

• 所有成员的列表，包括继承的成员

属性

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

信号

• triggered()

方法

• void restart()
• void start()
• void stop()

详细说明

计时器可用于触发一次操作，或在给定间隔内重复触发操作。

以下是一个显示当前日期和时间，并每隔 500 毫秒更新文本的定时器。它使用 JavaScript 的 `Date ` 对象来获取当前时间。

import QtQuick 2.0

Item {
    Timer {
        interval: 500; running: true; repeat: true
        onTriggered: time.text = Date().toString()
    }

    Text { id: time }
}

该计时器的类型与动画计时器同步。由于动画计时器通常设置为 60fps，因此该计时器的分辨率最高为 16 毫秒。

如果计时器正在运行且其某个属性发生变化，则已用时间将被重置。 例如，如果一个间隔为1000毫秒的Timer在启动500毫秒后其repeat属性被修改，则已用时间将重置为0，且该Timer将在1000毫秒后被触发。

另请参阅 Qt Quick 演示 - 时钟。

属性文档

interval : int

设置触发器之间的interval （单位为毫秒）。

默认间隔为1000毫秒。

repeat : bool

如果repeat 为true，则定时器将按指定的间隔反复触发；否则，定时器将在指定的间隔内触发一次，然后停止（即running将被设置为false）。

repeat 默认值为 false。

另请参阅 running 。

running : bool

如果设置为 true，则启动计时器；否则停止计时器。对于非重复计时器，计时器触发后，running 将被设置为 false。

running 默认值为 false。

另请参阅 repeat 。

triggeredOnStart : bool

启动定时器时，通常会在指定的间隔时间过后才触发第一次事件。有时希望在定时器启动时立即触发事件；例如，用于建立初始状态。

如果triggeredOnStart 为true，计时器在启动时会立即触发，随后按指定的间隔继续触发。请注意，如果repeat设置为false，计时器将触发两次：一次在启动时，另一次在指定间隔时。

triggeredOnStart 默认值为 false。

另请参阅 running 。

信号文档

triggered()

当定时器超时时，会触发此信号。

方法文档

void restart()

重新启动计时器

如果计时器未运行，则将其启动；否则，将先停止计时器，重置为初始状态，然后重新启动。调用restart() 后，running 属性将变为 true。

void start()

启动计时器

如果计时器已经在运行，调用此方法将没有任何效果。在调用start() 后，running 属性将设为true。

void stop()

停止计时器

如果计时器未运行，调用此方法将不会产生任何效果。调用stop() 之后，running 属性将变为 false。