Animation

套件	spark.effects.animation
類別	public final class Animation
繼承	Animation Object

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The Animation class defines an animation that happens between the start and end values of a property over a specified period of time. The animation can be a change in position, such as performed by the Move effect; a change in size, as performed by the Resize effect; a change in visibility, as performed by the Fade effect; or other types of animations used by effects or run directly with the Animation class.

This class defines the timing and value parts of the animation. Other code, either in effects or in application code, associates the animation with target objects and properties, such that the animated values produced by Animation class can then be applied to target objects and properties to actually cause these objects to animate.

When defining animation effects, you typically create an instance of the Animate class, or of a subclass of Animate. This creates an Animation instance in the play() method. The Animation instance accepts start and end values, a duration, and optional parameters such as easer and interpolator objects.

The Animation object calls event listeners at the start and end of the animation, when the animation repeats, and at regular update intervals during the animation. These calls pass values which the Animation instance calculated from the start and end values and the easer and interpolator objects. These values can then be used to set property values on target objects.

預設 MXML 屬性motionPaths

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		animationTarget : spark.effects.animation:IAnimationTarget The IAnimationTarget object notified with all start, end, repeat, and update events for this animation.	Animation
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentValue : Object An Object containing the calculated values as of the current frame of the Animation.	Animation
		cycleFraction : Number [唯讀] The current fraction elapsed in the animation, after easing has been applied.	Animation
		cycleTime : Number [唯讀] The current millisecond position in the current cycle animation.	Animation
		duration : Number = 500 The length of time, in milliseconds, of the animation, not counting any repetitions defined by the repeatCount property.	Animation
		easer : IEaser The easing behavior for this effect.	Animation
		interpolator : IInterpolator = null The interpolator used by the Animation instance to calculate values between the start and end values of the property.	Animation
		isPlaying : Boolean [唯讀] If true, the animation is currently playing.	Animation
		motionPaths : Vector.<MotionPath> The set of MotionPath objects that define the properties and values that the Animation will animate over time.	Animation
		playheadTime : Number The total elapsed time of the animation, including any start delay and repetitions.	Animation
		playReversed : Boolean If true, play the animation in reverse.	Animation
		repeatBehavior : String Sets the behavior of a repeating animation.	Animation
		repeatCount : int The number of times that this animation repeats.	Animation
		repeatDelay : Number The amount of time, in milliseconds, to delay before each repetition cycle begins.	Animation
		startDelay : Number The amount of time spent waiting before the animation begins.	Animation

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null) Constructor.	Animation
		end():void Interrupts the animation, jumps immediately to the end of the animation, and calls the animationEnd() function on the animationTarget.	Animation
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		pause():void Pauses the effect until the resume() method is called.	Animation
		play():void Start the animation.	Animation
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		resume():void Resumes the effect after it has been paused by a call to the pause() method.	Animation
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stop():void Stops the animation, ending it without calling the end() method.	Animation
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

屬性詳細資訊

animationTarget

屬性

animationTarget:spark.effects.animation:IAnimationTarget

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The IAnimationTarget object notified with all start, end, repeat, and update events for this animation. A value of null indicates that there is no target to notify.

預設值為 null。

實作
public function get animationTarget():spark.effects.animation:IAnimationTarget
public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void

currentValue

屬性

public var currentValue:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

An Object containing the calculated values as of the current frame of the Animation. The values are stored as map values, using property names as the key.

cycleFraction

屬性

cycleFraction:Number [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The current fraction elapsed in the animation, after easing has been applied. This value is between 0 and 1. An animation 'cycle' is defined as a single repetition of the animation, where the repeatCount property defines the number of cycles that will be played.

實作
public function get cycleFraction():Number

cycleTime

屬性

cycleTime:Number [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The current millisecond position in the current cycle animation. This value is between 0 and duration. An animation 'cycle' is defined as a single repetition of the animation, where the repeatCount property defines the number of cycles that will be played. Use the seek() method to change the position of the animation.

實作
public function get cycleTime():Number

duration

屬性

public var duration:Number = 500

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The length of time, in milliseconds, of the animation, not counting any repetitions defined by the repeatCount property.

預設值為 500。

easer

屬性

easer:IEaser

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The easing behavior for this effect. This IEaser object is used to convert the elapsed fraction of the animation into an eased fraction, which is then used to calculate the value at that eased elapsed fraction.

A value of null means no easing is used, which is equivalent to using a Linear ease, or animation.easer = Linear.getInstance();.

預設值為 Sine(.5)。

實作
public function get easer():IEaser
public function set easer(value:IEaser):void

interpolator

屬性

public var interpolator:IInterpolator = null

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The interpolator used by the Animation instance to calculate values between the start and end values of the property. By default, the class uses the NumberInterpolator class or, in the case of the start and end values being arrays or Vectors, by the MultiValueInterpolator class. Interpolation of other data types, or of Numbers that should be interpolated differently, such as uint values that hold color channel information, can be handled by supplying a different interpolator.

isPlaying

屬性

isPlaying:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

If true, the animation is currently playing. The value is false unless the animation has been played and not yet stopped (either programmatically or automatically) or paused.

預設值為 false。

實作
public function get isPlaying():Boolean

motionPaths

屬性

public var motionPaths:Vector.<MotionPath>

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The set of MotionPath objects that define the properties and values that the Animation will animate over time.

相關 API 元素

spark.effects.animation.MotionPath

playheadTime

屬性

playheadTime:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The total elapsed time of the animation, including any start delay and repetitions. For an animation playing through its first cycle, this value will equal that of cycleTime.

實作
public function get playheadTime():Number
public function set playheadTime(value:Number):void

playReversed

屬性

playReversed:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

If true, play the animation in reverse. If the animation is currently playing in the opposite direction to the specified value of playReversed, the animation will change direction dynamically.

預設值為 false。

實作
public function get playReversed():Boolean
public function set playReversed(value:Boolean):void

repeatBehavior

屬性

repeatBehavior:String

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Sets the behavior of a repeating animation. A repeating animation has the repeatCount property set to 0 or to a value greater than 1. This value should be either RepeatBehavior.LOOP, meaning the animation repeats in the same order each time, or RepeatBehavior.REVERSE, meaning the animation reverses direction for each iteration.

預設值為 RepeatBehavior.LOOP。

實作
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void

相關 API 元素

spark.effects.animation.RepeatBehavior

repeatCount

屬性

repeatCount:int

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The number of times that this animation repeats. A value of 0 means that it repeats indefinitely.

預設值為 1。

實作
public function get repeatCount():int
public function set repeatCount(value:int):void

repeatDelay

屬性

repeatDelay:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The amount of time, in milliseconds, to delay before each repetition cycle begins. Setting this value to a non-zero number ends previous animation cycle exactly at its end value However, non-delayed repetitions may skip over that value completely as the animation transitions smoothly from being near the end of one cycle to being past the beginning of the next. This property must be a value >= 0.

This property is used for the first repetition after the first animation cycle. To delay the first cycle of the animation, use the startDelay property.

預設值為 0。

實作
public function get repeatDelay():Number
public function set repeatDelay(value:Number):void

相關 API 元素

startDelay

屬性

startDelay:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The amount of time spent waiting before the animation begins. This property must be a value >= 0.

預設值為 0。

實作
public function get startDelay():Number
public function set startDelay(value:Number):void

建構函式詳細資料

()

建構函式

public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Constructor. The optional property, startValue, and endValue parameters define a simple animation with a single MotionPath object with two Keyframes. If either value is non-null, startValue becomes the value of the first keyframe, at time=0, and endValue becomes the value of the second keyframe, at the end of the animation.

參數

	`duration:Number` (default = `500`) — The length of the animation, in milliseconds.

	`property:String` (default = `null`) — The property to animate.

	`startValue:Object` (default = `null`) — The initial value of the property.

	`endValue:Object` (default = `null`) — The final value of the property.

方法詳細資訊

end

()

方法

public function end():void

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Interrupts the animation, jumps immediately to the end of the animation, and calls the animationEnd() function on the animationTarget.

pause

()

方法

public function pause():void

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Pauses the effect until the resume() method is called. If stop() is called before resume(), then the animation cannot be resumed.

play

()

方法

public function play():void

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Start the animation. If the animation is already playing, it is stopped first, then played.

resume

()

方法

public function resume():void

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Resumes the effect after it has been paused by a call to the pause() method.

stop

()

方法

public function stop():void

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Stops the animation, ending it without calling the end() method. The animationStop() function on the animationTarget will be called.

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

Animation - AS3 Flex

套件x

語言元素

附錄

套件 spark.effects.animation

animationTarget

currentValue

cycleFraction

cycleTime

duration

easer

interpolator

isPlaying

motionPaths

playheadTime

playReversed

repeatBehavior

repeatCount

repeatDelay

startDelay

Animation

end

pause

play

resume

stop