This page was saved using jaction on 2006-09-04 8:33:39.
Address: http://flexdocs.kr/docs/flex2/langref/mx/effects/EffectInstance.html
Title: mx.effects.EffectInstance (Flex™ 2 레퍼런스 가이드)  •  Size: 49778
Packagemx.effects
Classpublic class EffectInstance
InheritanceEffectInstance Inheritance EventDispatcher Inheritance Object
SubclassesActionEffectInstance , CompositeEffectInstance , MaskEffectInstance , SoundEffectInstance , TweenEffectInstance

EffectInstance 클래스는 타겟으로 재생되는 effect의 인스턴스를 나타냅니다. 각 타겟으로는 개별의 effect 인스턴스를 관련지을 수 있고 있습니다. effect 인스턴스는 일시적으로 유효하게 되는 인스턴스입니다. 인스턴스는 effect가 타겟으로 재생되는 경우에 작성되어 재생이 종료하면 그 인스턴스는 파기됩니다. 타겟으로 복수의 effect가 동시에 재생되고 있는 경우 (예를 들어, Parallel effect)는, effect 마다 다른 effect 인스턴스가 작성됩니다.

effect의 개발시에는, custom effect용의 인스턴스 클래스를 작성할 필요가 있습니다.

See also

mx.effects.Effect custom effect의 작성에 대해
예 :단순한 effect의 정의


Public property
 property정의
  className : String
[read-only] 이 effect 클래스의 이름입니다. 예를 들어,"FadeInstance" 등이 있습니다.
EffectInstance
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  duration : Number
effect의 계속 시간을 나타냅니다 (밀리 세컨드 단위).
EffectInstance
  effect : Effect
이 EffectInstance object를 작성한 Effect object를 나타냅니다.
EffectInstance
  playheadTime : Number
[read-only] effect 재생중의 현재 위치를 나타냅니다.
EffectInstance
  propertyChanges : PropertyChanges
effect의 타겟으로 관련하는 property세트에 대해서, 개시치 및 종료치를 포함한 PropertyChanges object를 지정합니다.
EffectInstance
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  repeatCount : int = 1
effect를 반복하는 회수를 나타냅니다.
EffectInstance
  repeatDelay : int = 0
effect를 반복하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위).
EffectInstance
  startDelay : int = 0
effect를 개시하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위).
EffectInstance
  suspendBackgroundProcessing : Boolean = false
true 의 경우, effect의 재생중에 모든 백그라운드 처리를 블록 합니다.
EffectInstance
  target : Object
이 effect가 적용되는 UIComponent object를 나타냅니다.
EffectInstance
  triggerEvent : Event
effect의 재생을 방아쇠 한 이벤트를 나타냅니다 (존재하는 경우).
EffectInstance
Public Methods
 Methods정의
  EffectInstance (target:Object )
constructor   .
EffectInstance
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
  end ():void
현재 재생중의 effect 인스턴스를 중단해, 즉시 effect의 끝나에 점프 합니다.
EffectInstance
  finishEffect ():void
effect의 재생이 완료하면,end() Methods에 의해 불려 갑니다.
EffectInstance
  finishRepeat ():void
반복해지는 effect의 각 반복에 의해 재생이 종료하면, 불려 갑니다.
EffectInstance
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
  initEffect (event:Event ):void
이 Methods는, effect가 EffectManager 에 의해 방아쇠 되면, 불려 갑니다.
EffectInstance
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  pause ():void
resume() Methods를 호출할 때까지, effect를 일시정지합니다.
EffectInstance
  play ():void
타겟으로 effect 인스턴스를 재생합니다.
EffectInstance
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
  resume ():void
pause() Methods를 호출해, effect를 일시정지한 후, 재개시킵니다.
EffectInstance
  reverse ():void
effect의 현재 위치로부터 개시해, 역순서로 effect를 재생합니다.
EffectInstance
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
  startEffect ():void
startDelay 시간의 경과후, 타겟으로 effect 인스턴스를 재생합니다.
EffectInstance
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
property의 상세
classNameproperty
className:String   [read-only]

이 effect 클래스의 이름입니다. 예를 들어,"FadeInstance" 등이 있습니다.

이것은 짧은 형식 또는 무수식의 이름으로, 패키지명은 포함되지 않습니다. 수식명이 필요한 경우는, flash.utils 패키지에 포함되는 getQualifiedClassName() Methods를 사용합니다.

Implements
    public function get className():String
durationproperty 
duration:Number   [read-write]

effect의 계속 시간을 나타냅니다 (밀리 세컨드 단위).

디폴트치500.

Implements
    public function get duration():Number
    public function set duration(value:Number ):void
effectproperty 
public var effect:Effect

이 EffectInstance object를 작성한 Effect object를 나타냅니다.

playheadTimeproperty 
playheadTime:Number   [read-only]

effect 재생중의 현재 위치를 나타냅니다. 이 property의 값의 범위는, 0 으로부터 실제의 계속 시간 (startDelay,repeatCount, 및 repeatDelay property치를 포함한다)입니다.

Implements
    public function get playheadTime():Number
propertyChangesproperty 
public var propertyChanges:PropertyChanges

effect의 타겟으로 관련하는 property세트에 대해서, 개시치 및 종료치를 포함한 PropertyChanges object를 지정합니다. 이 property는, 이 effect 인스턴스를 작성한 effect로 captureStartValues() Methods가 불려 갔을 경우에게만 설정됩니다.

propertyChanges property는, 트란지션의 일부로서 사용되는 effect를 작성할 때에 빈번하게 사용됩니다. captureStartValues() Methods는, 트란지션이 개시되면, 자동적으로 Flex 로부터 불려 갑니다. Effectinstance.play() Methods의 재정의(override)의 범위에서,propertyChanges() Methods내의 정보를 조사해, effect의 개시치 및 종료치를 초기화할 수 있습니다.

See also

repeatCountproperty 
public var repeatCount:int = 1

effect를 반복하는 회수를 나타냅니다. 유효한 값은 0 이상의 정수입니다.

디폴트치1.

See also

repeatDelayproperty 
public var repeatDelay:int = 0

effect를 반복하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위).

디폴트치0.

See also

startDelayproperty 
public var startDelay:int = 0

effect를 개시하기 전의 대기 시간을 나타냅니다 (밀리 세컨드 단위). 유효한 값은 0 이상의 정수입니다. repeatCount property를 사용하는 것에 의해 effect가 반복해지는 경우는, effect의 첫회 재생시에게만 startDelay property가 적용됩니다.

디폴트치0.

suspendBackgroundProcessingproperty 
public var suspendBackgroundProcessing:Boolean = false

true 의 경우, effect의 재생중에 모든 백그라운드 처리를 블록 합니다. 백그라운드 처리에서는, 측정, 레이아웃, 및, 서버로부터 수신한 응답의 처리를 합니다.

디폴트치false.

See also

targetproperty 
public var target:Object

이 effect가 적용되는 UIComponent object를 나타냅니다.

See also

triggerEventproperty 
public var triggerEvent:Event

effect의 재생을 방아쇠 한 이벤트를 나타냅니다 (존재하는 경우). 이 property는, effect가 복수의 방아쇠 이벤트에 할당할 수 있고 있는 경우에 편리합니다.

effect가 이벤트에 의해 방아쇠 되므로 없고 play() Methods를 호출하는 것에 의해 프로그램으로 재생되는 경우, 이 property는 null 가 됩니다.

constructor    의 상세
EffectInstance()constructor   
public 함수 EffectInstance(target:Object )

constructor   .

Parameters
target:Object — 이 effect로 애니메이션화하는 UIComponent object를 나타냅니다.
Methods의 상세
end()Methods
public function end():void

현재 재생중의 effect 인스턴스를 중단해, 즉시 effect의 끝나에 점프 합니다. 이 Methods는,Effect.end() Methods의 호출에 의해, 불려 갑니다. Implements시에,finishEffect() Methods가 불려 갑니다.

effect의 종료 처리의 일환으로서 이 Methods가 불려 가면, effect 인스턴스에 의해 effectEnd 이벤트가 dispatch됩니다.

EffectInstance 의 서브 클래스에서는, 이 Methods를 임의로 재정의(override) 할 수 있습니다. 재정의(override)의 일환으로서 논리 후, 재정의(override)의 마지막으로부터 super.end() Methods를 호출할 필요가 있습니다.

See also

finishEffect()Methods 
public function finishEffect():void

effect의 재생이 완료하면,end() Methods에 의해 불려 갑니다. 이 함수에 의해, effect 타겟의 endEffect 이벤트가 dispatch됩니다.

서브 클래스에서 이 Methods를 재정의(override) 할 필요는 없습니다. effect의 사용시에 이 Methods를 호출할 필요는 없습니다. 다만, effect의 서브 클래스를 작성하는 경우는, 호출할 필요가 있습니다.

See also

finishRepeat()Methods 
public function finishRepeat():void

반복해지는 effect의 각 반복에 의해 재생이 종료하면, 불려 갑니다.

서브 클래스에서 이 Methods를 재정의(override) 할 필요는 없습니다. effect의 사용시에 이 Methods를 호출할 필요는 없습니다.

initEffect()Methods 
public function initEffect(event:Event ):void

이 Methods는, effect가 EffectManager 에 의해 방아쇠 되면, 불려 갑니다. 이 기본 클래스의 버젼에 의해, effect를 방아쇠 한 이벤트가 triggerEvent property에 보존됩니다. 각 서브 클래스에 의해 이 Methods가 재정의(override) 됩니다.

Parameters
event:Event — effect를 방아쇠 하기 위해서 dispatch된 event object를 나타냅니다. 예를 들어, 방아쇠가 mouseDownEffect 의 경우, 이벤트는 MouseEvent 가 되어, 타입은 MouseEvent.MOUSEDOWN 와 같게 됩니다.
pause()Methods 
public function pause():void

resume() Methods를 호출할 때까지, effect를 일시정지합니다.

play()Methods 
public function play():void

타겟으로 effect 인스턴스를 재생합니다. EffectInstance 로 effect의 재생을 개시하는 경우는, 대신에 startEffect() Methods를 호출합니다.

EffectInstance 의 서브 클래스에서는, 이 Methods를 재정의(override) 할 필요가 있습니다. 재정의(override)에 의해 super.play() Methods가 반드시 불려 가 타겟으로부터 effectStart 이벤트가 dispatch됩니다.

See also

resume()Methods 
public function resume():void

pause() Methods를 호출해, effect를 일시정지한 후, 재개시킵니다.

reverse()Methods 
public function reverse():void

effect의 현재 위치로부터 개시해, 역순서로 effect를 재생합니다.

startEffect()Methods 
public function startEffect():void

startDelay 시간의 경과후, 타겟으로 effect 인스턴스를 재생합니다. Effect 클래스에 의해 불려 갑니다. EffectInstance 의 개시시는,play() Methods 대신에 이 함수를 사용합니다.







 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/effects/EffectInstance.html