| 패키지 | mx.effects |
| 클래스 | public class EffectInstance |
| 상속 | EffectInstance  EventDispatcher Object |
| 구현 | IEffectInstance |
| 하위 클래스 | ActionEffectInstance, AnimateInstance, CompositeEffectInstance, MaskEffectInstance, SoundEffectInstance, TweenEffectInstance |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Effect developers must create an instance class for their custom effects.
기타 예제
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| className : String [읽기 전용]
The name of the effect class, such as "FadeInstance". | EffectInstance | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| duration : Number
The duration of the effect, in milliseconds. | EffectInstance | ||
| effect : IEffect
The IEffect object that created this IEffectInstance object. | EffectInstance | ||
| effectTargetHost : mx.effects:IEffectTargetHost
A property that lets you access the target
list-based control of a data effect. | EffectInstance | ||
| hideFocusRing : Boolean
Determines whether the effect should hide
the focus ring when starting the effect. | EffectInstance | ||
| playheadTime : Number
Current time position of the effect. | EffectInstance | ||
| propertyChanges : PropertyChanges
Specifies the PropertyChanges object containing
the start and end values for the set of properties
relevant to the effect's targets. | EffectInstance | ||
| repeatCount : int
Number of times to repeat the effect. | EffectInstance | ||
| repeatDelay : int
Amount of time, in milliseconds,
to wait before repeating the effect. | EffectInstance | ||
| startDelay : int
Amount of time, in milliseconds,
to wait before starting the effect. | EffectInstance | ||
| suspendBackgroundProcessing : Boolean
If true, blocks all background processing
while the effect is playing. | EffectInstance | ||
| target : Object
The UIComponent object to which this effect is applied. | EffectInstance | ||
| triggerEvent : Event
The event, if any, which triggered the playing of the effect. | EffectInstance | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
EffectInstance(target:Object)
Constructor. | EffectInstance | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
Interrupts an effect instance that is currently playing,
and jumps immediately to the end of the effect. | EffectInstance | ||
Called by the end() method when the effect
finishes playing. | EffectInstance | ||
Called after each iteration of a repeated effect finishes playing. | EffectInstance | ||
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
This method is called if the effect was triggered by the EffectManager. | EffectInstance | ||
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
Pauses the effect until you call the resume() method. | EffectInstance | ||
Plays the effect instance on the target. | EffectInstance | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
Resumes the effect after it has been paused
by a call to the pause() method. | EffectInstance | ||
Plays the effect in reverse, starting from
the current position of the effect. | EffectInstance | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
Plays the effect instance on the target after the
startDelay period has elapsed. | EffectInstance | ||
Stops the effect, leaving the target in its current state. | EffectInstance | ||
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
className | 속성 |
className:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
The name of the effect class, such as "FadeInstance".
This is a short or "unqualified" class name
that does not include the package name.
If you need the qualified name, use the
getQualifiedClassName() method
in the flash.utils package.
구현
public function get className():Stringduration | 속성 |
effect | 속성 |
effectTargetHost | 속성 |
effectTargetHost:mx.effects:IEffectTargetHost| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
A property that lets you access the target list-based control of a data effect. This property enables an instance of an effect class to communicate with the list-based control on which the effect is playing.
구현
public function get effectTargetHost():mx.effects:IEffectTargetHost public function set effectTargetHost(value:mx.effects:IEffectTargetHost):voidhideFocusRing | 속성 |
hideFocusRing:Boolean| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Determines whether the effect should hide the focus ring when starting the effect. The effect target is responsible for the hiding the focus ring. Subclasses of the UIComponent class hide the focus ring automatically. If the effect target is not a subclass of the UIComponent class, you must add functionality to it to hide the focus ring.
Set this property to true
to hide the focus ring during the effect.
For subclasses of Effect, the default value is false.
For subclasses of MaskEffect, the default value is true.
구현
public function get hideFocusRing():Boolean public function set hideFocusRing(value:Boolean):voidplayCount | 속성 |
protected var playCount:int = 0| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Number of times that the instance has been played.
playheadTime | 속성 |
playheadTime:Number| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Current time position of the effect.
This property has a value between 0 and the total duration,
which includes the Effect's startDelay,
repeatCount, and repeatDelay.
구현
public function get playheadTime():Number public function set playheadTime(value:Number):voidpropertyChanges | 속성 |
propertyChanges:PropertyChanges| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Specifies the PropertyChanges object containing
the start and end values for the set of properties
relevant to the effect's targets.
This property is only set if the
captureStartValues() method was called
on the effect that created this effect instance.
You often use the propertyChanges property
to create an effect that is used as part of a transition.
Flex automatically calls the captureStartValues()
method when it starts a transition.
Within your override of the Effectinstance.play()
method, you can examine the information within the
propertyChanges() method to initialize
the start and end values of the effect.
구현
public function get propertyChanges():PropertyChanges public function set propertyChanges(value:PropertyChanges):void기타 예제
repeatCount | 속성 |
repeatDelay | 속성 |
startDelay | 속성 |
startDelay:int| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Amount of time, in milliseconds,
to wait before starting the effect.
Possible values are any int greater than or equal to 0.
If the effect is repeated by using the repeatCount
property, the startDelay property is applied
only the first time the effect is played.
구현
public function get startDelay():int public function set startDelay(value:int):voidsuspendBackgroundProcessing | 속성 |
suspendBackgroundProcessing:Boolean| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
If true, blocks all background processing
while the effect is playing.
Background processing includes measurement, layout,
and processing responses that have arrived from the server.
구현
public function get suspendBackgroundProcessing():Boolean public function set suspendBackgroundProcessing(value:Boolean):voidtarget | 속성 |
triggerEvent | 속성 |
triggerEvent:Event| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
The event, if any, which triggered the playing of the effect. This property is useful when an effect is assigned to multiple triggering events.
If the effect was played programmatically by a call to the
play() method, rather than being triggered by an event,
this property is null.
구현
public function get triggerEvent():Event public function set triggerEvent(value:Event):voidEffectInstance | () | 생성자 |
end | () | 메서드 |
public function end():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Interrupts an effect instance that is currently playing,
and jumps immediately to the end of the effect.
This method is invoked by a call
to the Effect.end() method.
As part of its implementation, it calls
the finishEffect() method.
The effect instance dispatches an effectEnd event
when you call this method as part of ending the effect.
In a subclass of EffectInstance,
you can optionally override this method
As part of your override, you should call
the super.end() method
from the end of your override, after your logic.
기타 예제
finishEffect | () | 메서드 |
public function finishEffect():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Called by the end() method when the effect
finishes playing.
This function dispatches an endEffect event
for the effect target.
You do not have to override this method in a subclass. You do not need to call this method when using effects, but you may need to call it if you create an effect subclass.
finishRepeat | () | 메서드 |
public function finishRepeat():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Called after each iteration of a repeated effect finishes playing.
You do not have to override this method in a subclass. You do not need to call this method when using effects.
initEffect | () | 메서드 |
public function initEffect(event:Event):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
This method is called if the effect was triggered by the EffectManager.
This base class version saves the event that triggered the effect
in the triggerEvent property.
Each subclass should override this method.
매개 변수
event:Event — The Event object that was dispatched
to trigger the effect.
For example, if the trigger was a mouseDownEffect, the event
would be a MouseEvent with type equal to MouseEvent.MOUSEDOWN.
|
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.
play | () | 메서드 |
public function play():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Plays the effect instance on the target.
Call the startEffect() method instead
to make an effect start playing on an EffectInstance.
In a subclass of EffectInstance, you must override this method.
The override must call the super.play() method
so that an effectStart event is dispatched
from the target.
기타 예제
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.
startEffect | () | 메서드 |
public function startEffect():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Plays the effect instance on the target after the
startDelay period has elapsed.
Called by the Effect class.
Use this function instead of the play() method
when starting an EffectInstance.
stop | () | 메서드 |
public function stop():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 3 |
| 런타임 버전: | Flash Player 9, AIR 1.1 |
Stops the effect, leaving the target in its current state.
This method is invoked by a call
to the Effect.stop() method.
As part of its implementation, it calls
the finishEffect() method.
The effect instance dispatches an effectEnd event
when you call this method as part of ending the effect.
Tue Jun 12 2018, 03:17 PM Z