flex程序设计--事件和事件处理机制--时间事件

时间事件TimerEvent

公共属性

	属性		定义方
		bubbles : Boolean [只读 (read-only)] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读 (read-only)] 事件流中的当前阶段。	Event
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		target : Object [只读 (read-only)] 事件目标。	Event
		type : String [只读 (read-only)] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		TimerEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) 创建一个 Event 对象，其中包含有关 timer 事件的特定信息。	TimerEvent
		clone():Event 创建 TimerEvent 对象的副本，并设置每个属性的值以匹配原始属性值。	TimerEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toString():String 返回一个字符串，其中包含 TimerEvent 对象的所有属性。	TimerEvent
		updateAfterEvent():void 如果已修改显示列表，则将指示 Flash Player 或 AIR 运行时在此事件处理完成后呈现结果。	TimerEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		定义方
		ACTIVATE : String = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。	Event
		ADDED : String = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。	Event
		CANCEL : String = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。	Event
		CHANGE : String = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。	Event
		CLEAR : String = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。	Event
		CLOSE : String = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COMPLETE : String = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		COPY : String = "copy" [静态] 定义 copy 事件对象的 type 属性值。	Event
		CUT : String = "cut" [静态] 定义 cut 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXIT_FRAME : String = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。	Event
		EXITING : String = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。	Event
		FULLSCREEN : String = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。	Event
		HTML_RENDER : String = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。	Event
		ID3 : String = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。	Event
		INIT : String = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。	Event
		LOCATION_CHANGE : String = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。	Event
		NETWORK_CHANGE : String = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。	Event
		OPEN : String = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。	Event
		PASTE : String = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。	Event
		REMOVED : String = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。	Event
		RENDER : String = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。	Event
		RESIZE : String = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。	Event
		SCROLL : String = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。	Event
		SELECT : String = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。	Event
		SELECT_ALL : String = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。	Event
		SOUND_COMPLETE : String = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。	Event
		TIMER : String = "timer" [静态] 定义 timer 事件对象的 type 属性值。	TimerEvent
		TIMER_COMPLETE : String = "timerComplete" [静态] 定义 timerComplete 事件对象的 type 属性值。	TimerEvent
		UNLOAD : String = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。	Event
		USER_IDLE : String = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。	Event
		USER_PRESENT : String = "userPresent" [静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。	Event

构造函数详细信息

TimerEvent

()

构造函数

public function TimerEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

创建一个 Event 对象，其中包含有关 timer 事件的特定信息。将 Event 对象作为参数传递给事件侦听器。

参数

	type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。
	bubbles:Boolean (default = false) — 确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。
	cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。

方法详细信息

clone

()

方法

override public function clone():Event

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

 

创建 TimerEvent 对象的副本，并设置每个属性的值以匹配原始属性值。

 

返回

Event — 其属性值与原始属性值匹配的新 TimerEvent 对象。

toString

()

方法

override public function toString():String

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

 

返回一个字符串，其中包含 TimerEvent 对象的所有属性。字符串的格式如下：

[TimerEvent type=value bubbles=value cancelable=value ]

 

 

返回

String — 一个字符串，其中包含 TimerEvent 对象的所有属性。

updateAfterEvent

()

方法

public function updateAfterEvent():void

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

 

如果已修改显示列表，则将指示 Flash Player 或 AIR 运行时在此事件处理完成后呈现结果。

示例

下面是 TimerEvent.updateAfterEvent() 方法的示例。

function onTimer(event:TimerEvent):void {
    if (40 < my_mc.x && my_mc.x < 375) {
        my_mc.x-= 50;
    } else {
        my_mc.x=374;
    }
    event.updateAfterEvent();
}

var moveTimer:Timer=new Timer(50,250);
moveTimer.addEventListener(TimerEvent.TIMER,onTimer);
moveTimer.start();

常量详细信息

TIMER

常量

public static const TIMER:String = "timer"

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

 

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

此事件具有以下属性：

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

 

另请参见

flash.utils.Timer.timer

TIMER_COMPLETE

常量

public static const TIMER_COMPLETE:String = "timerComplete"

 

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

 

 

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

此事件具有以下属性：

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

 

另请参见

flash.utils.Timer.timerComplete

示例 如何使用示例

TimerEventExample.as

以下示例使用 TimerExample 类来说明如何能将侦听器方法 timerHandler() 实例化并设置为侦听要调度的新 TimerEvent（在调用 Timer 的 start() 方法时发生）。

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

    public class TimerEventExample extends Sprite {

        public function TimerEventExample() {
            var myTimer:Timer = new Timer(1000, 2);
            myTimer.addEventListener(TimerEvent.TIMER, timerHandler);
            myTimer.start();
        }

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