Animator

套件	fl.motion
類別	public class Animator
繼承	Animator AnimatorBase EventDispatcher Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Animator 類別會將移動補間動畫的 XML 說明套用至顯示物件。 Animator 類別的屬性和方法會控制移動的播放，而 Flash Player 會廣播事件，以便回應移動狀態的變更。如果沒有任何三維內容，Flash CS4 的「將移動複製為 ActionScript」命令會使用 Animator 類別。如果有三維內容，則會改用 Animator3D 類別，它與 Animator 類別共享相同的基底類別，但特別適用於三維內容。然後，您就可以使用應用程式設計介面 (API) 來編輯 ActionScript，或建構自己的自訂動畫。

如果您想要在函數內呼叫 Animator 類別的方法，請在函數外面宣告 Animator 實體，如此物件的範圍就不會局限於函數本身。如果您在函數內宣告 Animator 實體，Flash Player 便會在函數結尾刪除此實體 (這是 Flash Player 自動執行的一部分「記憶體回收」例行工作)，目標物件也將無法產生動畫效果。

注意：在 Flash CS3 中，此類別支援的部分屬性和方法是此類別的專屬成員。Flash CS4 為此類別的這些屬性和方法引進了基礎類別 AnimatorBase，現在這些屬性和方法會透過繼承鏈結來與其他類別共用。如果您正在使用 Flash CS3，請注意這些屬性和方法仍然受到 Animator 類別的支援，不過在 Flash CS3 之後的 Flash Professional 版本中會變成 AnimatorBase 的成員。針對此參考中的其他類別，請選取「顯示繼承公用屬性」和「顯示繼承公用方法」，查看此類別支援的所有屬性和方法。

預設 MXML 屬性motion

相關 API 元素

移動 XML 元素

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		autoRewind : Boolean = false 將動畫設定為完成之後重新啟動。	AnimatorBase
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		frameEvent : String Event.ENTER_FRAME 事件建立之事件物件的名稱。	AnimatorBase
		initialPosition : Array [唯寫] 一個座標陣列，定義動畫的開始位置。	AnimatorBase
		instanceFactoryClass : Class 使用 ActionScript 建立實體時，這就是建立實體所使用的類別。	AnimatorBase
		isPlaying : Boolean [唯讀] 指出目前是否正在播放動畫。	AnimatorBase
		motion : MotionBase 包含動畫之移動補間動畫屬性的物件。	AnimatorBase
		motionArray : Array 包含動畫之移動補間動畫屬性的物件陣列。	AnimatorBase
		orientToPath : Boolean = false 沿著移動路徑設定顯示物件的位置。	AnimatorBase
		placeholderName : String 使用 ActionScript 建立實體時，這會是顯示在舞台上且會被我們取代的實體。	AnimatorBase
		positionMatrix : Matrix 將整體變形套用至移動路徑的 Matrix 物件。	AnimatorBase
		repeatCount : int = 1 重複播放動畫的次數。	AnimatorBase
		sceneName : String 為 3D 動作匯出之場景的參考，可讓場景載入父時間軸。	AnimatorBase
		spanEnd : int [唯讀] 傳回目標父輩的影格 (也就是目標動畫結束的地方)。	AnimatorBase
		spanStart : int [唯讀] 傳回目標父輩的影格 (也就是目標動畫開始的地方)。	AnimatorBase
		target : DisplayObject 製作成動畫的顯示物件。	AnimatorBase
		targetName : String 目標物件的名稱 (透過父輩 DisplayObjectContainer 來檢視)。	AnimatorBase
		targetParent : DisplayObjectContainer 加上動畫效果的目標父輩 DisplayObjectContainer，可與 targetName 搭配使用以擷取時間軸上遭到移除與取代的目標物件。	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array 目標物件的初始方向。	AnimatorBase
		time : int 從零開始的整數，指出並控制目前動畫的時間。	AnimatorBase
		transformationPoint : Point 旋轉或縮放顯示物件的參照點。	AnimatorBase
		transformationPointZ : int 旋轉或縮放顯示物件的參照 z 座標點。	AnimatorBase
		usingCurrentFrame : Boolean [唯讀] 指出每當進入新影格時，是否要檢查 currentFrame 屬性、目標的動畫是否要與其父輩時間軸中的影格同步，或是不管父輩的目前影格為何，一律前進至下一個影格。	AnimatorBase

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Animator(xml:XML = null, target:DisplayObject = null) 建立 Animator 物件，以便將 XML 架構的移動補間動畫說明套用至顯示物件。	Animator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void 停止播放動畫，而且 Flash Player 會立即移至連續動畫的最後一個影格。	AnimatorBase
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [靜態] 從 XML 字串建立 Animator 物件。	Animator
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		matricesEqual(a:Matrix, b:Matrix):Boolean [靜態] 比較兩個指定為參數的矩陣，如果它們彼此相等，就傳回 true。	Animator
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void 將 Flash Player 前進至連續動畫的下一個影格。	AnimatorBase
		pause():void 暫停播放動畫，直到您呼叫 resume() 方法為止。	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void 開始播放動畫。	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [靜態]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [靜態] 針對該 MovieClip 的子系註冊指定的 MovieClip 以及 AnimatorBase 實體。	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		resume():void 會在動畫已經由 pause() 方法暫停之後，繼續播放動畫。	AnimatorBase
		rewind():void 將 Flash Player 設定至動畫的第一個影格。	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		startFrameEvents():void 起始影格事件。	AnimatorBase
		stop():void 停止播放動畫，而且 Flash Player 會返回連續動畫的第一個影格。	AnimatorBase
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void 每次進入新影格時，設定 currentFrame 屬性，以及設定目標的動畫是否與其父輩 MovieClips 的時間軸中的影格同步。	AnimatorBase
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
motionEnd	當移動完成播放時傳送 (當它到達結尾，或移動已經遭到 stop() 或 end() 方法的呼叫中斷時)。	AnimatorBase
motionStart	當移動開始播放時傳送。	AnimatorBase
motionUpdate	當移動已變更而且螢幕已更新時傳送。	AnimatorBase
timeChange	當 Animator 的 time 值已變更，但是螢幕尚未更新 (亦即未傳送 motionUpdate 事件) 時傳送。	AnimatorBase

建構函式詳細資料

()

建構函式

public function Animator(xml:XML = null, target:DisplayObject = null)

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

建立 Animator 物件，以便將 XML 架構的移動補間動畫說明套用至顯示物件。

參數

	`xml:XML` (default = `null`) — E4X 物件，其中包含 XML 架構的移動補間動畫說明。

	`target:DisplayObject` (default = `null`) — 使用移動補間動畫的顯示物件。

相關 API 元素

移動 XML 元素

方法詳細資訊

fromXMLString

()

方法

public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

從 XML 字串建立 Animator 物件。這個方法是使用 Animator 建構函式的替代方式，可改為接受 E4X 物件。

參數

	`xmlString:String` — 描述移動補間動畫的 XML 字串。

	`target:DisplayObject` (default = `null`) — 使用移動補間動畫的顯示物件。

傳回值

Animator — 將指定的 xmlString 套用到指定之 target 的Animator 實體。

相關 API 元素

移動 XML 元素

matricesEqual

()

方法

public static function matricesEqual(a:Matrix, b:Matrix):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flash CS5

執行階段版本:

Flash Player 10.1, AIR 2

比較兩個指定為參數的矩陣，如果它們彼此相等，就傳回 true。

參數

	`a:Matrix` — 比較的第一個 Matrix 物件實體。

	`b:Matrix` — 比較的第二個 Matrix 物件實體。

傳回值

Boolean — 布林值；如果兩個矩陣彼此相等，就是 true，否則就是 false。

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

Animator - AS3 Flash

套件x

語言元素

附錄

套件 fl.motion

Animator

fromXMLString

matricesEqual