| パッケージ | mx.effects |
| インターフェイス | public interface IEffectInstance |
| 実装者 | EffectInstance |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトの開発時には、カスタムエフェクト用のインスタンスクラスを作成する必要があります。
関連する API エレメント
| プロパティ | 定義元 | ||
|---|---|---|---|
| className : String [読み取り専用]
このエフェクトクラスの名前です。たとえば、"FadeInstance" などがあります。 | IEffectInstance | ||
| duration : Number
エフェクトの持続時間を表します（ミリ秒単位）。 | IEffectInstance | ||
| effect : IEffect
この IEffectInstance オブジェクトを作成した IEffect オブジェクトを表します。 | IEffectInstance | ||
| effectTargetHost : mx.effects:IEffectTargetHost
データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。 | IEffectInstance | ||
| hideFocusRing : Boolean
エフェクトの開始時にエフェクトがフォーカス枠を非表示にするかどうかを指定します。 | IEffectInstance | ||
| playheadTime : Number
エフェクトの現在の時間位置です。 | IEffectInstance | ||
| propertyChanges : PropertyChanges
エフェクトのターゲットに関連するプロパティのセットに対して、開始値および終了値を含む PropertyChanges オブジェクトを指定します。 | IEffectInstance | ||
| repeatCount : int
エフェクトを繰り返す回数を表します。 | IEffectInstance | ||
| repeatDelay : int
エフェクトを繰り返す前の待機時間を表します（ミリ秒単位）。 | IEffectInstance | ||
| startDelay : int
エフェクトを開始する前の待機時間を表します（ミリ秒単位）。 | IEffectInstance | ||
| suspendBackgroundProcessing : Boolean
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。 | IEffectInstance | ||
| target : Object
このエフェクトが適用される UIComponent オブジェクトを表します。 | IEffectInstance | ||
| triggerEvent : Event
エフェクトの再生をトリガーしたイベントを表します（存在する場合）。 | IEffectInstance | ||
| メソッド | 定義元 | ||
|---|---|---|---|
現在再生中のエフェクトインスタンスを中断し、直ちにエフェクトの終わりにジャンプします。 | IEffectInstance | ||
エフェクトの再生が完了すると、end() メソッドによって呼び出されます。 | IEffectInstance | ||
繰り返されるエフェクトの各反復により再生が終了すると、呼び出されます。 | IEffectInstance | ||
このメソッドは、エフェクトが EffectManager によってトリガーされると呼び出されます。 | IEffectInstance | ||
resume() メソッドを呼び出すまで、エフェクトを一時停止します。 | IEffectInstance | ||
ターゲットでエフェクトインスタンスを再生します。 | IEffectInstance | ||
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。 | IEffectInstance | ||
エフェクトの現在位置から開始して、逆順でエフェクトを再生します。 | IEffectInstance | ||
startDelay 時間の経過後、ターゲットでエフェクトインスタンスを再生します。 | IEffectInstance | ||
ターゲットを現在の状態にしたまま、エフェクトを停止します。 | IEffectInstance | ||
className | プロパティ |
duration | プロパティ |
effect | プロパティ |
effectTargetHost | プロパティ |
effectTargetHost:mx.effects:IEffectTargetHost| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。 このプロパティにより、エフェクトクラスのインスタンスは、エフェクトが再生されているリストコントロールと通信できます。
実装
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 |
エフェクトの開始時にエフェクトがフォーカス枠を非表示にするかどうかを指定します。エフェクトターゲットは、フォーカス枠を非表示にします。UIComponent クラスのサブクラスは、フォーカス枠を自動的に非表示にします。エフェクトターゲットが UIComponent クラスのサブクラスではない場合は、フォーカス枠を非表示にするための機能を追加する必要があります。
エフェクトの再生中にフォーカス枠を非表示にするには、このプロパティを true に設定します。
Effect のサブクラスのデフォルト値は false です。 MaskEffect のサブクラスのデフォルト値は true です。
実装
public function get hideFocusRing():Boolean public function set hideFocusRing(value:Boolean):voidplayheadTime | プロパティ |
propertyChanges | プロパティ |
propertyChanges:PropertyChanges| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトのターゲットに関連するプロパティのセットに対して、開始値および終了値を含む PropertyChanges オブジェクトを指定します。 このプロパティは、このエフェクトインスタンスを作成したエフェクトで captureStartValues() メソッドが呼び出された場合にのみ設定されます。
propertyChanges プロパティは、トランジションの一部として使用されるエフェクトを作成する際に頻繁に使用されます。 captureStartValues() メソッドは、トランジションが開始されると、自動的に Flex から呼び出されます。 Effectinstance.play() メソッドのオーバーライドの範囲で、propertyChanges() メソッド内の情報を調べて、エフェクトの開始値および終了値を初期化できます。
実装
public function get propertyChanges():PropertyChanges public function set propertyChanges(value:PropertyChanges):void関連する API エレメント
repeatCount | プロパティ |
repeatDelay | プロパティ |
startDelay | プロパティ |
startDelay:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトを開始する前の待機時間を表します（ミリ秒単位）。 有効な値は 0 以上の整数です。 repeatCount プロパティの使用によりエフェクトが繰り返される場合は、エフェクトの初回再生時にのみ startDelay プロパティが適用されます。
デフォルト値： 0。
実装
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 |
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。 バックグラウンド処理では、測定、レイアウト、および、サーバーから受信した応答の処理が行われます。
デフォルト値： false。
実装
public function get suspendBackgroundProcessing():Boolean public function set suspendBackgroundProcessing(value:Boolean):void関連する API エレメント
target | プロパティ |
triggerEvent | プロパティ |
triggerEvent:Event| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトの再生をトリガーしたイベントを表します（存在する場合）。 このプロパティは、エフェクトが複数のトリガーイベントに割り当てられている場合に便利です。
エフェクトがイベントによってトリガーされるのでなく play() メソッドを呼び出すことによってプログラムで再生される場合、このプロパティは null となります。
実装
public function get triggerEvent():Event public function set triggerEvent(value:Event):voidend | () | メソッド |
public function end():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
現在再生中のエフェクトインスタンスを中断し、直ちにエフェクトの終わりにジャンプします。 このメソッドは、Effect.end() メソッドの呼び出しにより、呼び出されます。 実装時に、finishEffect() メソッドが呼び出されます。
エフェクトの終了処理の一環としてこのメソッドが呼び出されると、エフェクトインスタンスにより effectEnd イベントが送出されます。
EffectInstance のサブクラスでは、このメソッドを任意でオーバーライドできます。オーバーライドの一部として、ロジックの後、つまりオーバーライドの終わりで super.end() メソッドを呼び出す必要があります。
関連する API エレメント
finishEffect | () | メソッド |
public function finishEffect():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトの再生が完了すると、end() メソッドによって呼び出されます。 この関数によって、エフェクトターゲットの endEffect イベントが送出されます。
サブクラスでこのメソッドをオーバーライドする必要はありません。 エフェクトの使用時にこのメソッドを呼び出す必要はありません。ただし、エフェクトのサブクラスを作成する場合は、呼び出す必要があります。
関連する API エレメント
finishRepeat | () | メソッド |
public function finishRepeat():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
繰り返されるエフェクトの各反復により再生が終了すると、呼び出されます。
サブクラスでこのメソッドをオーバーライドする必要はありません。 エフェクトの使用時にこのメソッドを呼び出す必要はありません。
initEffect | () | メソッド |
public function initEffect(event:Event):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは、エフェクトが EffectManager によってトリガーされると、呼び出されます。 この基本クラスのバージョンによって、エフェクトをトリガーしたイベントが triggerEvent プロパティに保存されます。 各サブクラスによってこのメソッドがオーバーライドされます。
パラメーター
event:Event — エフェクトをトリガーするために送出されたイベントオブジェクトを表します。 たとえば、トリガーが mouseDownEffect の場合、イベントは MouseEvent となり、タイプは MouseEvent.MOUSEDOWN と同じになります。
|
pause | () | メソッド |
public function pause():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
resume() メソッドを呼び出すまで、エフェクトを一時停止します。
play | () | メソッド |
public function play():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ターゲットでエフェクトインスタンスを再生します。 EffectInstance でエフェクトの再生を開始する場合は、代わりに startEffect() メソッドを呼び出します。
EffectInstance のサブクラスでは、このメソッドをオーバーライドする必要があります。 オーバーライドによって super.play() メソッドが必ず呼び出され、ターゲットから effectStart イベントが送出されます。
resume | () | メソッド |
public function resume():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
pause() メソッドを呼び出してエフェクトを一時停止した後、再開させます。
reverse | () | メソッド |
public function reverse():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エフェクトの現在位置から開始して、逆順でエフェクトを再生します。
startEffect | () | メソッド |
public function startEffect():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
startDelay 時間の経過後、ターゲットでエフェクトインスタンスを再生します。 Effect クラスによって呼び出されます。 EffectInstance の開始時は、play() メソッドの代わりにこの関数を使用します。
stop | () | メソッド |
public function stop():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ターゲットを現在の状態にしたまま、エフェクトを停止します。 このメソッドは、Effect.stop() メソッドの呼び出しにより、呼び出されます。 実装時に、finishEffect() メソッドが呼び出されます。
エフェクトの終了処理の一環としてこのメソッドが呼び出されると、エフェクトインスタンスにより effectEnd イベントが送出されます。
Tue Jun 12 2018, 10:34 AM Z