flash.utils.Timer (ActionScript 3.0)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentCount : int [read-only] 计时器从 0 开始后触发的总次数。	Timer
		delay : Number 计时器事件间的延迟（以毫秒为单位）。	Timer
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object
		repeatCount : int 设置的计时器运行总次数。	Timer
		running : Boolean [read-only] 计时器的当前状态；如果计时器正在运行，则为 true，否则为 false。	Timer

	方法	定义方
		Timer(delay:Number, repeatCount:int = 0) 使用指定的 delay 和 repeatCount 状态构造新的 Timer 对象。	Timer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		reset():void 如果计时器正在运行，则停止计时器，并将 currentCount 属性设回为 0，这类似于秒表的重置按钮。	Timer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		start():void 如果计时器尚未运行，则启动计时器。	Timer
		stop():void 停止计时器。	Timer
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	Flash Player 获得操作系统焦点并变为活动状态时调度。	EventDispatcher
deactivate	Flash Player 失去操作系统焦点并变为非活动状态时调度。	EventDispatcher
timer	每当 Timer 对象达到根据 Timer.delay 属性指定的间隔时调度。	Timer
timerComplete	每当它完成 Timer.repeatCount 设置的请求数后调度。	Timer

属性详细信息

currentCount

属性

currentCount:int [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

实现
public function get currentCount():int

delay

属性

delay:Number [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

实现
public function get delay():Number
public function set delay(value:Number):void

引发

Error — 如果指定的延迟为负数或不是有限数，则将引发异常。

repeatCount

属性

repeatCount:int [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

实现
public function get repeatCount():int
public function set repeatCount(value:int):void

running

属性

running:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

计时器的当前状态；如果计时器正在运行，则为 true，否则为 false。

实现
public function get running():Boolean

构造函数详细信息

Timer

()

构造函数

public function Timer(delay:Number, repeatCount:int = 0)

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

使用指定的 delay 和 repeatCount 状态构造新的 Timer 对象。

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

参数

	`delay:Number` — 计时器事件间的延迟（以毫秒为单位）。

	`repeatCount:int` (default = `0`) — 指定重复次数。如果为 0，则计时器重复无限次数。如果不为 0，则将运行计时器，运行次数为指定的次数，然后停止。

引发

Error — 如果指定的延迟为负数或不是有限数

方法详细信息

reset

()

方法

public function reset():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

另请参见

Timer.stop()

start

()

方法

public function start():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

stop

()

方法

public function stop():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

另请参见

Timer.reset()

事件详细信息

timer

事件

事件对象类型: flash.events.TimerEvent
TimerEvent.type property = flash.events.TimerEvent.TIMER

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

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

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已达到其间隔的 Timer 对象。

timerComplete

事件

事件对象类型: flash.events.TimerEvent
TimerEvent.type property = flash.events.TimerEvent.TIMER_COMPLETE

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

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

此事件具有以下属性：

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

示例如何使用示例

以下示例使用 TimerExample 类来说明如何将侦听器方法 timerHandler() 设置为侦听要调度的新 TimerEvent。计时器将在调用 start() 时启动，并且之后将调度计时器事件。

package {
    import flash.utils.Timer;
    import flash.events.TimerEvent;
    import flash.display.Sprite;

    public class TimerExample extends Sprite {

        public function TimerExample() {
            var myTimer:Timer = new Timer(1000, 2);
            myTimer.addEventListener("timer", timerHandler);
            myTimer.start();
        }

        public function timerHandler(event:TimerEvent):void {
            trace("timerHandler: " + event);
        }
    }
}

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/utils/Timer.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
Timer	属性 \| 方法 \| 事件 \| 示例

包	flash.utils
类	public class Timer
继承	Timer EventDispatcher Object