TimerEvent

套件	flash.events
類別	public class TimerEvent
繼承	TimerEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

每當 Timer 物件到達 Timer.delay 屬性所指定的間隔時，此 Timer 物件就會傳送 TimerEvent 事件。

相關 API 元素

公用屬性

	屬性		定義自
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		TimerEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) 以與 timer 事件相關的特定資訊建立 Event 物件。	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
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] 傳回包含 TimerEvent 物件所有屬性的字串。	TimerEvent
		updateAfterEvent():void 如果已經修改顯示清單，則指示 Flash Player 或 AIR 執行階段在此事件處理完畢後再顯示。	TimerEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		TIMER : String = "timer" [靜態] 定義 timer 事件物件的 type 屬性值。	TimerEvent
		TIMER_COMPLETE : String = "timerComplete" [靜態] 定義 timerComplete 事件物件的 type 屬性值。	TimerEvent

建構函式詳細資料

()

建構函式

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

指定與 timer 事件相關的特定資訊來建立 Event 物件。 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, Flash Lite 4

建立 TimerEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。

傳回值

Event — 新的 TimerEvent 物件，其屬性值符合原始物件的屬性值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

傳回包含 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 Lite 4

如果已經修改顯示清單，則指示 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, Flash Lite 4

定義 timer 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已經達到其間隔的 Timer 物件。

相關 API 元素

flash.utils.Timer.timer

TIMER_COMPLETE

常數

public static const TIMER_COMPLETE:String = "timerComplete"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

定義 timerComplete 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已經完成其要求的 Timer 物件。

相關 API 元素

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);
        }
    }
}

法律聲明 | 線上隱私權政策

TimerEvent - AS3

類別 x

TimerEvent

clone

toString

updateAfterEvent

TIMER

TIMER_COMPLETE