| パッケージ | mx.effects |
| クラス | public class TweenEffect |
| 継承 | TweenEffect Effect EventDispatcher Object |
| サブクラス | AnimateProperty, Blur, Dissolve, Fade, Glow, Move, Pause, Resize, Rotate, SeriesEffect, Zoom |
TweenEffect クラスのサブクラスを作成して、アニメーションを長時間再生するエフェクトを定義できます。 例えば、Resize エフェクトを使用すると、ターゲットのサイズ変更が指定した時間分だけ有効になります。
MXML のシンタックス
MXML シンタックスを隠すThe <mx:TweenEffect> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:TagName
Properties
easingFunction="easing function name; no default"
Events
tweenEnd="No default"
/>
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
![]() | className : String [読み取り専用]
このエフェクトクラスの名前です。たとえば、"Fade" などがあります。 | Effect | |
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
![]() | customFilter : EffectTargetFilter
エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。 | Effect | |
![]() | duration : Number
エフェクトの継続時間を表します(ミリ秒単位)。 | Effect | |
| easingFunction : Function = null
アニメーションのイージング関数を表します。 | TweenEffect | ||
![]() | effectTargetHost : IEffectTargetHost
データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。 | Effect | |
![]() | filter : String
エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。 | Effect | |
![]() | hideFocusRing : Boolean
エフェクトの開始時にエフェクトがフォーカスリングを非表示にするかどうかを指定します。 | Effect | |
![]() | instanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。 | Effect | |
![]() | isPlaying : Boolean [読み取り専用]
エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。 | Effect | |
![]() | perElementOffset : Number
エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延(ミリ秒)です。 | Effect | |
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
![]() | relevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。 | Effect | |
![]() | relevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。 | Effect | |
![]() | repeatCount : int = 1
エフェクトを繰り返す回数を表します。 | Effect | |
![]() | repeatDelay : int = 0
エフェクトを繰り返す前の待機時間を表します(ミリ秒単位)。 | Effect | |
![]() | startDelay : int = 0
エフェクトを開始する前の待機時間を表します(ミリ秒単位)。 | Effect | |
![]() | suspendBackgroundProcessing : Boolean = false
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。 | Effect | |
![]() | target : Object
このエフェクトが適用される UIComponent オブジェクトを表します。 | Effect | |
![]() | targets : Array
エフェクトのターゲットである UIComponent オブジェクトの配列を表します。 | Effect | |
![]() | triggerEvent : Event
エフェクトがトリガされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。 | Effect | |
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクタです。 | TweenEffect | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
![]() |
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャし、終了値として保存します。 | Effect | |
![]() |
ターゲットの追加セットの関連するプロパティの現在値をキャプチャします。この機能は、データ変更エフェクトを実行したときに Flex によって使用されます。
| Effect | |
![]() |
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。 | Effect | |
![]() |
1 つのエフェクトインスタンスを作成し、それを初期化します。 | Effect | |
![]() |
ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。 | Effect | |
![]() |
インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。 | Effect | |
![]() |
イベントをイベントフローに送出します。 | EventDispatcher | |
![]() |
現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。 | Effect | |
![]() |
ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。 | Effect | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
resume() メソッドを呼び出すまで、エフェクトを一時停止します。 | Effect | |
![]() |
エフェクトの再生を開始します。 | Effect | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
![]() |
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。 | Effect | |
![]() |
エフェクトが現在再生中の場合に、エフェクトの現在位置から開始して、逆順でエフェクトを再生します。 | Effect | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
エフェクトターゲットを現在の状態にしたまま、エフェクトを停止します。 | Effect | |
![]() |
指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| メソッド | 定義元 | ||
|---|---|---|---|
![]() |
エフェクトインフラストラクチャによって内部的に使用されます。 | Effect | |
![]() |
エフェクトインスタンスの再生終了時に呼び出されます。 | Effect | |
![]() |
このメソッドは、エフェクトインスタンスの再生開始時に呼び出されます。 | Effect | |
![]() |
エフェクトインスタンスをフィルタリングするために必要なロジックを決定します。 | Effect | |
![]() |
ターゲットからプロパティの値を取得するために captureStartValues() メソッドによって呼び出されます。 | Effect | |
![]() |
エフェクトインスタンスにエフェクトのプロパティをコピーします。 | Effect | |
TweenEffect から TweenEvent が送出されたときに呼び出されます。 | TweenEffect | ||
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
![]() | エフェクトの再生停止時(エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき)に送出されます。 | Effect | ||
![]() | エフェクトの再生開始時に送出されます。 | Effect | ||
| トゥイーンエフェクトの終了時に送出されます。 | TweenEffect | |||
| トゥイーンエフェクトの開始時に送出されます。これは onTweenUpdate() メソッドの最初の呼び出しに対応します。 | TweenEffect | |||
| トゥイーンエフェクトでターゲットが更新されるたびに送出されます。 | TweenEffect | |||
| easingFunction | プロパティ |
public var easingFunction:Function = nullアニメーションのイージング関数を表します。 イージング関数は初期値と終了値の間の補間に使用されます。 一般のイージング関数は線形補間を実行するだけですが、より高度なイージング関数では加速と減速の効果を生成して、アニメーションがより自然になるようにします。
イージング関数を指定しない場合は、Math.sin() メソッドに基づくイージング関数が使用されます。
イージング関数は、Robert Penner 氏が普及に尽力した関数シグネチャに従っています。 この関数では、4 つの引数を使用できます。 1 番目の引数は、アニメーションの開始時刻を 0 とした "現在の時刻" です。 2 番目の引数は、アニメーション開始時の初期値(数値)です。 3 番目の引数は、終了値から初期値を引いた値です。 4 番目の引数は、アニメーションの再生時間です。 戻り値は、現在の時刻に対する補間値になります。 通常、この値は初期値と終了値の間の値になります。
このプロパティの値は、必ず関数オブジェクトとなります。
Flex は、mx.effects.easing パッケージにイージング関数を一式含んでいます。
| TweenEffect | () | コンストラクタ |
public function TweenEffect(target:Object = null)コンストラクタです。
パラメータtarget:Object (default = null) — このエフェクトでアニメーション化するオブジェクトを表します。
|
| tweenEventHandler | () | メソッド |
protected function tweenEventHandler(event:TweenEvent):voidTweenEffect から TweenEvent が送出されたときに呼び出されます。 このメソッドをオーバーライドする場合、必ずスーパーメソッドを呼び出すようにしてください。
パラメータ
event:TweenEvent — TweenEvent 型のイベントオブジェクトを表します。
|
| tweenEnd | イベント |
mx.events.TweenEventmx.events.TweenEvent.TWEEN_END
トゥイーンエフェクトの終了時に送出されます。 このイベントは、TweenEffectInstance.onTweenEnd() メソッドの呼び出しに対応しています。
トゥイーンエフェクトが 1 度だけ再生された場合、このイベントは effectEnd イベントと同時に発生します。 トゥイーンエフェクトを繰り返し再生させる場合、このイベントはエフェクトが繰り返されるたびに発生し、最後のエフェクトの再生後に endEffect イベントが発生します。
TweenEvent.TWEEN_END 定数により、イベントオブジェクトの type プロパティ値が tweenEnd イベント用に定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
value | onTweenEnd() メソッドに渡される値です。 |
| tweenStart | イベント |
mx.events.TweenEventmx.events.TweenEvent.TWEEN_START
トゥイーンエフェクトの開始時に送出されます。これは onTweenUpdate() メソッドの最初の呼び出しに対応します。同時に、Flex によって、エフェクトの最初の tweenUpdate イベントも送出されます。
Effect.effectStart イベントは tweenStart イベントの前に送出されます。
TweenEvent.TWEEN_START 定数により、イベントオブジェクトの type プロパティ値が tweenStart イベント用に定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
value | onTweenUpdate() メソッドに渡される値です。 |
| tweenUpdate | イベント |
mx.events.TweenEventmx.events.TweenEvent.TWEEN_UPDATE
トゥイーンエフェクトでターゲットが更新されるたびに送出されます。 このイベントは、TweenEffectInstance.onTweenUpdate() メソッドの呼び出しに対応しています。
TweenEvent.TWEEN_UPDATE 定数により、イベントオブジェクトの type プロパティ値が tweenUpdate イベント用に定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
value | onTweenUpdate() メソッドに渡される値です。 |
<?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://livedocs.adobe.com/flex/3_jp/langref/mx/effects/TweenEffect.html