计时器 QML 类型

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

导入语句	import QtQml

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

属性

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

信号

triggered()

方法

restart()
start()
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，计时器的分辨率最好为16ms。

如果计时器正在运行并且其中一个属性被更改，则已过时间将重置。例如，如果一个计时器有1000ms的间隔，在启动后500ms更改其 repeat 属性，则已过时间将重置为0，计时器将在1000ms后再次触发。

另请参阅: Qt Quick 示例 - 时钟.

属性文档

interval : int

设置触发的 interval，单位为毫秒。

默认间隔为1000毫秒。

repeat : bool

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

repeat 默认为 false。

另请参阅: running.

running : bool

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

running 默认为 false。

另请参阅: repeat.

triggeredOnStart : bool

当计时器启动时，第一次触发通常在指定的间隔过去之后。有时候希望在计时器启动时立即触发；例如，以建立初始状态。

如果 triggeredOnStart 设置为 true，则定时器在启动时立即触发，并在指定间隔后再次触发。请注意，如果 repeat 设置为 false，定时器将触发两次；一次在启动时，一次在间隔后。

triggeredOnStart 默认为 false。

另请参阅: running.

信号文档

triggered()

当定时器超时时发出此信号。

注意：相应的处理器是 onTriggered。

方法文档

restart()

重新启动定时器

如果定时器没有运行，将启动它；如果已经在运行，则停止，重置到初始状态并启动。在调用 restart() 之后，running 属性将设置为 true。

start()

启动定时器

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

stop()

停止定时器

如果定时器没有运行，调用此方法没有效果。在调用 stop() 之后，running 属性将设置为 false。