| Package | mx.effects |
| Class | public class TweenEffect |
| Inheritance | TweenEffect Effect EventDispatcher Object |
| Subclasses | AnimateProperty , Blur , Dissolve , Fade , Glow , Move , Pause , Resize , Rotate , SeriesEffect , Zoom |
TweenEffect 클래스의 서브 클래스를 작성해, 애니메이션을 장시간 재생하는 effect를 정의할 수 있습니다. 예를 들어, Resize effect를 사용하면, 타겟의 크기 변경이 지정한 시간분만큼 유효하게 됩니다.
MXML 문장구조법
MXML 문장구조법의 비표시
<mx:TweenEffect> 태그는 Super 클래스의 모든 태그 속성을 Inheritance해, 다음의 태그를 추가합니다.
<mx:TagName property easingFunction="이징 함수명, 디폴트치 없음"
event tweenEnd="디폴트치 없음" />
See also
| property | 정의 | ||
|---|---|---|---|
![]() | className : String
"Fade" 등, effect 클래스의 이름입니다. | Effect | |
![]() | constructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor 함수에의 참조입니다.
| Object | |
![]() | customFilter : EffectTargetFilter
effect를 재생하는 타겟을 특정하기 위해서, effect에 의해 사용되는 타입 EffectTargetFilter 의 custom 필터 object를 지정합니다.
| Effect | |
![]() | duration : Number
effect의 계속 시간을 나타냅니다 (밀리 세컨드 단위).
| Effect | |
| easingFunction : Function = null
애니메이션의 이징 함수를 나타냅니다.
| TweenEffect | ||
![]() | filter : String
effect의 타겟을 필터링 하는 알고리즘을 지정합니다.
| Effect | |
![]() | instanceClass : Class
이 effect 클래스의 effect 인스턴스 클래스를 지정하는 Class 형의 object를 나타냅니다.
| Effect | |
![]() | isPlaying : Boolean
effect의 인스턴스중 한쪽이 현재 재생중의 경우에 true, 그렇지 않은 경우에 false 가 되는 읽기 전용(read-only) 플래그입니다.
| Effect | |
![]() | prototype : Object
[static]
클래스 또는 함수 object의 prototype object에의 참조입니다.
| Object | |
![]() | relevantProperties : Array
필터링 실행시에 사용하는 property명의 배열을 나타냅니다.
| Effect | |
![]() | relevantStyles : Array
필터링 실행시에 사용하는 스타일명의 배열을 나타냅니다.
| Effect | |
![]() | repeatCount : int = 1
effect를 반복하는 회수를 나타냅니다.
| Effect | |
![]() | repeatDelay : int = 0
effect를 반복하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위).
| Effect | |
![]() | startDelay : int = 0
effect를 개시하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위).
| Effect | |
![]() | suspendBackgroundProcessing : Boolean = falsetrue 의 경우, effect의 재생중에 모든 백그라운드 처리를 블록 합니다. | Effect | |
![]() | target : Object
이 effect가 적용되는 UIComponent object를 나타냅니다.
| Effect | |
![]() | targets : Array
effect의 타겟인 UIComponent object의 배열을 나타냅니다.
| Effect | |
| Methods | 정의 | ||
|---|---|---|---|
| TweenEffect (target:Object = null)
constructor .
| TweenEffect | ||
![]() | addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
| EventDispatcher | |
![]() | captureStartValues ():void
effect의 타겟으로 두어 관련하는 property의 현재가를 capther 합니다.
| Effect | |
![]() | createInstance (target:Object = null):EffectInstance
1 개의 effect 인스턴스를 작성해, 그것을 초기화합니다.
| Effect | |
![]() | createInstances (targets:Array = null):Array
타겟 object의 배열을 취득해, 각 타겟으로
createInstance() Methods를 호출합니다. | Effect | |
![]() | dispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
| EventDispatcher | |
![]() | end (effectInstance:EffectInstance = null):void
현재 재생중의 effect를 모두 중단해, 즉시 effect의 끝나에 점프 합니다.
| Effect | |
![]() | getAffectedProperties ():Array
string의 배열을 돌려줍니다. 각 string는, 이 effect에 의해 변경되는 property의 이름입니다.
| Effect | |
![]() | hasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
| EventDispatcher | |
![]() | hasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
| Object | |
![]() | isPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
| Object | |
![]() | pause ():void
resume() Methods를 호출할 때까지, effect를 일시정지합니다. | Effect | |
![]() | play (targets:Array = null, playReversedFromEnd:Boolean = false):Array
effect의 재생을 개시합니다.
| Effect | |
![]() | propertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
| Object | |
![]() | removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
| EventDispatcher | |
![]() | resume ():void
pause() Methods를 호출해, effect를 일시정지한 후, 재개시킵니다. | Effect | |
![]() | reverse ():void
effect가 현재 재생중의 경우에, effect의 현재 위치로부터 개시해, 역순서로 effect를 재생합니다.
| Effect | |
![]() | setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
| Object | |
![]() | toString ():String
지정된 object의 string 표현을 돌려줍니다.
| Object | |
![]() | valueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
| Object | |
![]() | willTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
| EventDispatcher | |
| Methods | 정의 | ||
|---|---|---|---|
![]() | applyValueToTarget (target:Object , property:String , value:* , props:Object ):void
effect 인프라스트럭쳐에 의해 내부적으로 사용됩니다.
| Effect | |
![]() | effectEndHandler (event:EffectEvent ):void
effect 인스턴스의 재생 종료시에 불려 갑니다.
| Effect | |
![]() | effectStartHandler (event:EffectEvent ):void
이 Methods는, effect 인스턴스의 재생 개시시에 불려 갑니다.
| Effect | |
![]() | filterInstance (propChanges:Array , targ:Object ):Boolean
effect 인스턴스의 필터링에 필요한 논리를 결정합니다.
| Effect | |
![]() | getValueFromTarget (target:Object , property:String ):*
타겟으로부터 property의 값을 취득하기 위해서
captureStartValues() 에 의해 불려 갑니다. | Effect | |
![]() | initInstance (instance:EffectInstance ):void
effect 인스턴스에 effect의 property를 복사합니다.
| Effect | |
| tweenEventHandler (event:TweenEvent ):void
TweenEffect 로부터 TweenEvent 가 dispatch되었을 때에 불려 갑니다.
| TweenEffect | ||
| 이벤트 | 일람 | 정의 | ||
|---|---|---|---|---|
![]() | effectEnd |
effect의 재생 정지시 (effect의 재생 완료시, 또는 effect가 end() Methods의 호출에 의해 중단되었을 때)에 dispatch됩니다. | Effect | |
![]() | effectStart | effect의 재생 개시시에 dispatch됩니다. | Effect | |
| tweenEnd | tween effects 의 종료시에 dispatch됩니다. | TweenEffect | ||
| tweenStart |
onTweenUpdate() Methods의 최초의 호출해에 대응하는, tween effects 의 개시시에 dispatch됩니다. | TweenEffect | ||
| tweenUpdate | tween effects 에 의해 타겟이 갱신될 때마다 dispatch됩니다. | TweenEffect | ||
| easingFunction | property |
public var easingFunction:Function = null애니메이션의 이징 함수를 나타냅니다. 이징 함수는 초기치와 종료치의 사이의 보간에 사용됩니다. 일반의 이징 함수는 선형 보간을 실행할 뿐입니다만, 보다 확장된 이징 함수에서는 가속과 감속의 효과를 생성해, 애니메이션이 보다 자연스럽게 되도록(듯이) 합니다.
이징 함수를 지정하지 않는 경우는,Math.sin() Methods에 근거하는 이징 함수가 사용됩니다.
이징 함수는, Robert Penner 씨가 보급에 진력한 함수 서명에 따르고 있습니다. 이 함수에서는, 4 개의 인수를 사용할 수 있습니다. 1 번째의 인수는, 애니메이션의 개시시각을 0 으로 한 "현재의 시각" 입니다. 2 번째의 인수는, 애니메이션 개시시의 초기치 (수치)입니다. 3 번째의 인수는, 종료치로부터 초기값을 깎은 값입니다. 4 번째의 인수는, 애니메이션의 재생 시간입니다. 반환값은, 현재의 시각에 대한 보간치가 됩니다. 통상, 이 값은 초기치와 종료치의 사이의 값이 됩니다.
이 property의 값은, 반드시 함수 object가 됩니다.
Flex 는, mx.effects.easing 패키지에 이징 함수를 일식 포함하고 있습니다.
상세한 것에 대하여는, http://www.ericd.net/chapter7.pdf 를 참조해 주세요.
| TweenEffect | () | constructor |
public 함수 TweenEffect(target:Object = null)constructor .
Parameterstarget:Object (default = null) — 이 effect로 애니메이션화하는 object를 나타냅니다.
|
| tweenEventHandler | () | Methods |
protected function tweenEventHandler(event:TweenEvent ):void TweenEffect 로부터 TweenEvent 가 dispatch되었을 때에 불려 갑니다. 이 Methods를 재정의(override) 하는 경우, 반드시 super Methods를 호출하도록 해 주세요.
Parametersevent:TweenEvent — TweenEvent 형의 event object를 나타냅니다.
|
| tweenEnd | event |
mx.events.TweenEvent
mx.events.TweenEvent.TWEEN_END
tween effects 의 종료시에 dispatch됩니다. 이 이벤트는,TweenEffectInstance.onTweenEnd() Methods의 호출에 대응하고 있습니다.
tween effects 가 1 번만 재생되었을 경우, 이 이벤트는 effectEnd 이벤트와 동시에 발생합니다. tween effects 를 반복해 재생시키는 경우, 이 이벤트는 effect가 반복해질 때마다 발생해, 마지막 effect의 재생 후에 endEffect 이벤트가 발생합니다.
TweenEvent.TWEEN_END 정수에 의해,tweenEnd 이벤트의 event object의 type property치가 정의됩니다.
event object의 각 property에는 다음의 값이 설정됩니다.
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다. |
target | 이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요. |
value | onTweenEnd() Methods에게 건네진 값입니다. |
| tweenStart | event |
mx.events.TweenEvent
mx.events.TweenEvent.TWEEN_START
onTweenUpdate() Methods의 최초의 호출해에 대응하는, tween effects 의 개시시에 dispatch됩니다. 동시에 Flex 에 의해, effect의 최초의 tweenUpdate 이벤트도 dispatch됩니다.
Effect.effectStart 이벤트는 tweenStart 이벤트의 전에 dispatch됩니다.
TweenEvent.TWEEN_START 정수에 의해,tweenStart 이벤트의 event object의 type property치가 정의됩니다.
event object의 각 property에는 다음의 값이 설정됩니다.
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다. |
target | 이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요. |
value | onTweenUpdate() Methods에게 건네지는 값입니다. |
| tweenUpdate | event |
mx.events.TweenEvent
mx.events.TweenEvent.TWEEN_UPDATE
tween effects 에 의해 타겟이 갱신될 때마다 dispatch됩니다. 이 이벤트는,TweenEffectInstance.onTweenUpdate() Methods의 호출에 대응하고 있습니다.
TweenEvent.TWEEN_UPDATE 정수에 의해,tweenUpdate 이벤트의 event object의 type property치가 정의됩니다.
event object의 각 property에는 다음의 값이 설정됩니다.
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다. |
target | 이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요. |
value | onTweenUpdate() Methods에게 건네지는 값입니다. |
<? xml version="1.0"? >
<! -- Simple example to demonstrate the TweenEffect class. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<! [CDATA[
import mx.events.TweenEvent;
// Event handler for the tweenUpdate and tweenEnd effects.
private function tweenUpdateHandler(event:TweenEvent) :void {
// Access current width of the image.
currentWidth.text="Current width (in pixels): " + String(event.value[0]);
}
// Event handler for the reset button.
private function resetHandler() :void {
expand.end();
img.width=30;
currentWidth.text="Current width (in pixels): 30";
img.height=60;
button1.enabled=true;
}
]]>
</mx:Script>
<mx:Resize id="expand" target="{img}" widthTo="100" heightTo="200"
duration="10000"
tweenUpdate="tweenUpdateHandler(event);"
tweenEnd="tweenUpdateHandler(event);"/>
<mx:Panel title="Resize Effect Example" width="100%" height="100%"
paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
<mx:Text width="100%" color="blue"
text="Use the Button controls to resize the image. "/>
<mx:HBox width="100%">
<mx:Image id="img" width="30" height="60"
source="@Embed(source='assets/Nokia_6630.png')"/>
<mx:Text id="currentWidth" height="20" width="100%"/>
</mx:HBox>
<mx:ControlBar>
<mx:Button id="button1" label="Start" click="expand.play(); button1.enabled=false;"/>
<mx:Button label="Pause" click="expand.pause();"/>
<mx:Button label="Resume" click="expand.resume();"/>
<mx:Button label="Reverse" click="expand.reverse();"/>
<mx:Button label="End" click="expand.end();"/>
<mx:Button label="Reset" click="resetHandler();"/>
</mx:ControlBar>
</mx:Panel>
</mx:Application>
코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트
현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/effects/TweenEffect.html