window.runtime 属性window.runtime.flash.utils.Timer
继承Timer Inheritance EventDispatcher Inheritance Object

Timer 类是计时器的接口,它使您能按指定的时间序列运行代码。使用 start() 方法来启动计时器。为 timer 事件添加事件侦听器,以便将代码设置为按计时器间隔运行。

可以创建 Timer 对象以运行一次或按指定间隔重复运行,从而按计划执行代码。 根据 SWF 文件的帧速率或 Flash Player 的环境(可用内存及其他因素),Flash Player 或 Adobe AIR 调度事件的间隔可能稍有不同。例如,如果某个 SWF 文件设置为以每秒 10 帧 (fps)(也就是 100 毫秒的间隔)的速度播放,但计时器设置为在 80 毫秒时触发事件,则将按接近于 100 毫秒的间隔触发事件。 根据应用程序的内部帧速率,应用程序调度事件的间隔可能稍有不同。大量耗费内存的脚本也可能使事件发生偏差。

另请参见

Working with dates and times
Controlling time intervals


属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  currentCount : int
[只读 (read-only)] 计时器从 0 开始后触发的总次数。
Timer
  delay : Number
计时器事件间的延迟(以毫秒为单位)。
Timer
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  repeatCount : int
设置的计时器运行总次数。
Timer
  running : Boolean
[只读 (read-only)] 计时器的当前状态;如果计时器正在运行,则为 true,否则为 false。
Timer
公共方法
 方法定义方
  
Timer(delay:Number, repeatCount:int = 0)
使用指定的 delay 和 repeatCount 状态构造新的 Timer 对象。
Timer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
  
如果计时器正在运行,则停止计时器,并将 currentCount 属性设回为 0,这类似于秒表的重置按钮。
Timer
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
  
如果计时器尚未运行,则启动计时器。
Timer
  
停止计时器。
Timer
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 InheritedFlash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。EventDispatcher
 InheritedFlash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。EventDispatcher
  每当 Timer 对象达到根据 Timer.delay 属性指定的间隔时调度。Timer
  每当它完成 Timer.repeatCount 设置的请求数后调度。Timer
属性详细信息
currentCount属性
currentCount:int  [只读 (read-only)]

计时器从 0 开始后触发的总次数。如果已重置了计时器,则只会计入重置后的触发次数。

delay属性 
delay:Number  [读写]

计时器事件间的延迟(以毫秒为单位)。如果在计时器正在运行时设置延迟间隔,则计时器将按相同的 repeatCount 迭代重新启动。


引发
Error — 如果指定的延迟为负数或不是有限数,则将引发异常。
repeatCount属性 
repeatCount:int  [读写]

设置的计时器运行总次数。如果重复计数设置为 0,则计时器将持续不断运行,直至调用了 stop() 方法或程序停止。如果重复计数不为 0,则将运行计时器,运行次数为指定的次数。如果设置的 repeatCount 总数等于或小于 currentCount,则计时器将停止并且不会再次触发。

running属性 
running:Boolean  [只读 (read-only)]

计时器的当前状态;如果计时器正在运行,则为 true,否则为 false

构造函数详细信息
Timer()构造函数
function Timer(delay:Number, repeatCount:int = 0)

使用指定的 delayrepeatCount 状态构造新的 Timer 对象。

计时器不会自动启动;必须调用 start() 方法来启动它。

参数
delay:Number — 计时器事件间的延迟(以毫秒为单位)。
 
repeatCount:int (default = 0) — 指定重复次数。如果为 0,则计时器重复无限次数。如果不为 0,则将运行计时器,运行次数为指定的次数,然后停止。

引发
Error — 如果指定的延迟为负数或不是有限数
方法详细信息
reset()方法
function reset():void

如果计时器正在运行,则停止计时器,并将 currentCount 属性设回为 0,这类似于秒表的重置按钮。然后,在调用 start() 后,将运行计时器实例,运行次数为指定的重复次数(由 repeatCount 值设置)。

另请参见

start()方法 
function start():void

如果计时器尚未运行,则启动计时器。

stop()方法 
function stop():void

停止计时器。如果在调用 stop() 后调用 start(),则将继续运行计时器实例,运行次数为剩余的 重复次数(由 repeatCount 属性设置)。

另请参见

事件详细信息
timer 事件
事件对象类型: flash.events.TimerEvent
属性 TimerEvent.type = flash.events.TimerEvent.TIMER

每当 Timer 对象达到根据 Timer.delay 属性指定的间隔时调度。

定义 timer 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已达到其间隔的 Timer 对象。
timerComplete 事件  
事件对象类型: flash.events.TimerEvent
属性 TimerEvent.type = flash.events.TimerEvent.TIMER_COMPLETE

每当它完成 Timer.repeatCount 设置的请求数后调度。

定义 timerComplete 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已完成其请求的 Timer 对象。