パッケージmx.effects
public class EffectInstance
継承EffectInstance Inheritance EventDispatcher Inheritance Object
SubclassesActionEffectInstance, CompositeEffectInstance, MaskEffectInstance, SoundEffectInstance, TweenEffectInstance

EffectInstance クラスはターゲットで再生されるエフェクトのインスタンスを表します。各ターゲットには個別のエフェクトインスタンスが関連付けられています。エフェクトインスタンスは一時的に有効になるインスタンスです。インスタンスはエフェクトがターゲットで再生される場合に作成され、再生が終了するとそのインスタンスは破棄されます。ターゲットで複数のエフェクトが同時に再生されている場合 (たとえば、Parallel エフェクト) は、エフェクトごとに別々のエフェクトインスタンスが作成されます。

エフェクトの開発時には、カスタムエフェクト用のインスタンスクラスを作成する必要があります。

関連項目

mx.effects.Effect
ファクトリクラスとインスタンスクラスについて
カスタムエフェクトの作成について
例: 単純なエフェクトの定義


パブリックプロパティ
 プロパティ定義
  className : String
[read-only] このエフェクトクラスの名前です。たとえば、"FadeInstance" などがあります。
EffectInstance
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  duration : Number
エフェクトの継続時間を表します (ミリ秒単位)。
EffectInstance
  effect : Effect
EffectInstance
  playheadTime : Number
[read-only] エフェクト再生中の現在位置を表します。
EffectInstance
  propertyChanges : PropertyChanges
EffectInstance
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  repeatCount : int
EffectInstance
  repeatDelay : int
EffectInstance
  startDelay : int
EffectInstance
  suspendBackgroundProcessing : Boolean
EffectInstance
  target : Object
EffectInstance
  triggerEvent : Event
EffectInstance
パブリック Methods
 メソッド定義
  
コンストラクタです。
EffectInstance
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。
EventDispatcher
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
  
end():void
現在再生中のエフェクトインスタンスを中断し、直ちにエフェクトの終わりにジャンプします。
EffectInstance
  
エフェクトの再生が完了すると、end() メソッドによって呼び出されます。
EffectInstance
  
繰り返されるエフェクトの各反復により再生が終了すると、呼び出されます。
EffectInstance
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
  
このメソッドは、エフェクトが EffectManager によってトリガされると、呼び出されます。
EffectInstance
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
resume() メソッドを呼び出すまで、エフェクトを一時停止します。
EffectInstance
  
ターゲットでエフェクトインスタンスを再生します。
EffectInstance
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。
EffectInstance
  
エフェクトの現在位置から開始して、逆順でエフェクトを再生します。
EffectInstance
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
startDelay 時間の経過後、ターゲットでエフェクトインスタンスを再生します。
EffectInstance
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント一覧定義
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
プロパティの詳細
classNameプロパティ
className:String  [read-only]

このエフェクトクラスの名前です。たとえば、"FadeInstance" などがあります。

これは短い形式または無修飾の名前で、パッケージ名は含まれません。修飾名が必要な場合は、flash.utils パッケージに含まれる getQualifiedClassName() メソッドを使用します。

実装
    public function get className():String
durationプロパティ 
duration:Number  [read-write]

エフェクトの継続時間を表します (ミリ秒単位)。

デフォルト値500.

実装
    public function get duration():Number
    public function set duration(value:Number):void
effectプロパティ 
effect:Effect  [read-write]実装
    public function get effect():Effect
    public function set effect(value:Effect):void
playheadTimeプロパティ 
playheadTime:Number  [read-only]

エフェクト再生中の現在位置を表します。このプロパティの値の範囲は、0 から実際の継続時間 (startDelayrepeatCount、および repeatDelay プロパティ値を含む) です。

実装
    public function get playheadTime():Number
propertyChangesプロパティ 
propertyChanges:PropertyChanges  [read-write]実装
    public function get propertyChanges():PropertyChanges
    public function set propertyChanges(value:PropertyChanges):void

関連項目

repeatCountプロパティ 
repeatCount:int  [read-write]実装
    public function get repeatCount():int
    public function set repeatCount(value:int):void
repeatDelayプロパティ 
repeatDelay:int  [read-write]実装
    public function get repeatDelay():int
    public function set repeatDelay(value:int):void
startDelayプロパティ 
startDelay:int  [read-write]実装
    public function get startDelay():int
    public function set startDelay(value:int):void
suspendBackgroundProcessingプロパティ 
suspendBackgroundProcessing:Boolean  [read-write]実装
    public function get suspendBackgroundProcessing():Boolean
    public function set suspendBackgroundProcessing(value:Boolean):void
targetプロパティ 
target:Object  [read-write]実装
    public function get target():Object
    public function set target(value:Object):void
triggerEventプロパティ 
triggerEvent:Event  [read-write]実装
    public function get triggerEvent():Event
    public function set triggerEvent(value:Event):void
コンストラクタの詳細
EffectInstance()コンストラクタ
public 関数 EffectInstance(target:Object)

コンストラクタです。

パラメータ
target:Object — このエフェクトでアニメーション化する UIComponent オブジェクトを表します。
メソッドの詳細
end()メソッド
public function end():void

現在再生中のエフェクトインスタンスを中断し、直ちにエフェクトの終わりにジャンプします。このメソッドは、Effect.end() メソッドの呼び出しにより、呼び出されます。実装時に、finishEffect() メソッドが呼び出されます。

エフェクトの終了処理の一環としてこのメソッドが呼び出されると、エフェクトインスタンスにより effectEnd イベントが送出されます。

EffectInstance のサブクラスでは、このメソッドを任意でオーバーライドできます。オーバーライドの一環として、ロジック後、オーバーライドの終わりから super.end() メソッドを呼び出す必要があります。

関連項目

finishEffect()メソッド 
public function finishEffect():void

エフェクトの再生が完了すると、end() メソッドによって呼び出されます。この関数によって、エフェクトターゲットの endEffect イベントが送出されます。

サブクラスでこのメソッドをオーバーライドする必要はありません。エフェクトの使用時にこのメソッドを呼び出す必要はありません。ただし、エフェクトのサブクラスを作成する場合は、呼び出す必要があります。

関連項目

finishRepeat()メソッド 
public function finishRepeat():void

繰り返されるエフェクトの各反復により再生が終了すると、呼び出されます。

サブクラスでこのメソッドをオーバーライドする必要はありません。エフェクトの使用時にこのメソッドを呼び出す必要はありません。

initEffect()メソッド 
public function initEffect(event:Event):void

このメソッドは、エフェクトが EffectManager によってトリガされると、呼び出されます。この基本クラスのバージョンによって、エフェクトをトリガしたイベントが triggerEvent プロパティに保存されます。各サブクラスによってこのメソッドがオーバーライドされます。

パラメータ
event:Event — エフェクトをトリガするために送出されたイベントオブジェクトを表します。たとえば、トリガが mouseDownEffect の場合、イベントは MouseEvent となり、タイプは MouseEvent.MOUSEDOWN と同じになります。
pause()メソッド 
public function pause():void

resume() メソッドを呼び出すまで、エフェクトを一時停止します。

play()メソッド 
public function play():void

ターゲットでエフェクトインスタンスを再生します。EffectInstance でエフェクトの再生を開始する場合は、代わりに startEffect() メソッドを呼び出します。

EffectInstance のサブクラスでは、このメソッドをオーバーライドする必要があります。オーバーライドによって super.play() メソッドが必ず呼び出され、ターゲットから effectStart イベントが送出されます。

関連項目

resume()メソッド 
public function resume():void

pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。

reverse()メソッド 
public function reverse():void

エフェクトの現在位置から開始して、逆順でエフェクトを再生します。

startEffect()メソッド 
public function startEffect():void

startDelay 時間の経過後、ターゲットでエフェクトインスタンスを再生します。Effect クラスによって呼び出されます。EffectInstance の開始時は、play() メソッドの代わりにこの関数を使用します。