| 패키지 | mx.effects |
| 클래스 | public class Tween |
| 상속 | Tween  EventDispatcher Object |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
 | Flex 4.0(으)로 시작하는 경우 이 클래스 대신 spark.effects.animation.Animation 클래스를 사용하는 것이 좋습니다. Tween is the underlying animation class for the effects in Flex 3. As of Flex 4, the Spark effects use the spark.effects.animation.Animation class to provide similar functionality. |
The Tween class defines a tween, a property animation performed on a target object over a period of time. That animation can be a change in position, such as performed by the Move effect; a change in size, as performed by the Resize or Zoom effects; a change in visibility, as performed by the Fade or Dissolve effects; or other types of animations.
When defining tween effects, you typically create an instance
of the Tween class within your override of the
EffectInstance.play() method.
A Tween instance accepts the startValue,
endValue, and duration properties,
and an optional easing function to define the animation.
The Tween object invokes the
mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()
callback function on a regular interval on the effect instance
for the duration of the effect, passing to the
onTweenUpdate() method an interpolated value
between the startValue and endValue.
Typically, the callback function updates some property of the target object,
causing that object to animate over the duration of the effect.
When the effect ends, the Tween objects invokes the
mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()
callback function, if you defined one.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| duration : Number = 3000
Duration of the animation, in milliseconds. | Tween | ||
| easingFunction : Function [쓰기 전용]
Sets the easing function for the animation. | Tween | ||
| listener : Object
Object that is notified at each interval of the animation. | Tween | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Constructor. | Tween | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
Interrupt the tween, jump immediately to the end of the tween,
and invoke the onTweenEnd() callback function. | Tween | ||
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
Pauses the effect until you call the resume() method. | Tween | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
Resumes the effect after it has been paused
by a call to the pause() method. | Tween | ||
Plays the effect in reverse,
starting from the current position of the effect. | Tween | ||
Advances the tween effect to the specified position. | Tween | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
By default, the Tween class invokes the
mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()
callback function on a regular interval on the effect instance
for the duration of the effect, and the optional
mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()
callback function at the end of the effect duration. | Tween | ||
Stops the tween, ending it without dispatching an event or calling
the Tween's endFunction or onTweenEnd(). | Tween | ||
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
duration | 속성 |
public var duration:Number = 3000| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Duration of the animation, in milliseconds.
easingFunction | 속성 |
easingFunction:Function [쓰기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Sets the easing function for the animation.
The easing function is used to interpolate between
the startValue value and the endValue.
A trivial easing function does linear interpolation,
but more sophisticated easing functions create the illusion of
acceleration and deceleration, which makes the animation seem
more natural.
If no easing function is specified, an easing function based
on the Math.sin() method is used.
The easing function follows the function signature popularized by Robert Penner. The function accepts four arguments. The first argument is the "current time", where the animation start time is 0. The second argument is a the initial value at the beginning of the animation (a Number). The third argument is the ending value minus the initial value. The fourth argument is the duration of the animation. The return value is the interpolated value for the current time (usually a value between the initial value and the ending value).
Flex includes a set of easing functions in the mx.effects.easing package.
구현
public function set easingFunction(value:Function):voidlistener | 속성 |
public var listener:Object| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Object that is notified at each interval of the animation.
Tween | () | 생성자 |
public function Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Constructor.
When the constructor is called, the animation automatically starts playing.
매개 변수listener:Object — Object that is notified at each interval
of the animation. You typically pass the this
keyword as the value.
The listener must define the
onTweenUpdate() method and optionally the
onTweenEnd() method.
The former method is invoked for each interval of the animation,
and the latter is invoked just after the animation finishes.
| |
startValue:Object — Initial value(s) of the animation.
Either a number or an array of numbers.
If a number is passed, the Tween interpolates
between this number and the number passed
in the endValue parameter.
If an array of numbers is passed,
each number in the array is interpolated.
| |
endValue:Object — Final value(s) of the animation.
The type of this argument must match the startValue
parameter.
| |
duration:Number (default = -1) | |
minFps:Number (default = -1)onTweenUpdate() method should be called every second.
The tween code tries to call the onTweenUpdate()
method as frequently as possible (up to 100 times per second).
However, if the frequency falls below minFps,
the duration of the animation automatically increases.
As a result, an animation that temporarily freezes
(because it is not getting any CPU cycles) begins again
where it left off, instead of suddenly jumping ahead.
| |
updateFunction:Function (default = null)listener.OnTweenUpdate()
| |
endFunction:Function (default = null)listener.OnTweenEnd()
|
endTween | () | 메서드 |
public function endTween():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Interrupt the tween, jump immediately to the end of the tween,
and invoke the onTweenEnd() callback function.
pause | () | 메서드 |
public function pause():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Pauses the effect until you call the resume() method.
resume | () | 메서드 |
public function resume():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Resumes the effect after it has been paused
by a call to the pause() method.
reverse | () | 메서드 |
public function reverse():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Plays the effect in reverse, starting from the current position of the effect.
seek | () | 메서드 |
setTweenHandlers | () | 메서드 |
public function setTweenHandlers(updateFunction:Function, endFunction:Function):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
By default, the Tween class invokes the
mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()
callback function on a regular interval on the effect instance
for the duration of the effect, and the optional
mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()
callback function at the end of the effect duration.
This method lets you specify different methods as the update and the end callback functions.
매개 변수
updateFunction:Function — Specifies the update callback function.
| |
endFunction:Function — Specifies the end callback function.
|
stop | () | 메서드 |
public function stop():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Stops the tween, ending it without dispatching an event or calling
the Tween's endFunction or onTweenEnd().
Tue Jun 12 2018, 03:17 PM Z