AnimateTransform

パッケージ	spark.effects
クラス	public class AnimateTransform
継承	AnimateTransform Animate Effect EventDispatcher Object
サブクラス	AnimateTransform3D, Move, Rotate, Scale

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

AnimateTransform エフェクトは、ターゲットオブジェクトでのすべての変換関連アニメーションを制御します。重複したプロパティ値を変更する際の競合を回避するため、平行移動、拡大縮小、回転などの変換操作は、単一の操作に結合されて同時に実行されます。このエフェクトは、ターゲットでの現在の変換エフェクトをすべてそのターゲット用の単一のエフェクトインスタンスに結合することによって機能します。つまり、同じ Parallel エフェクト内の複数の変換エフェクトは結合されます（Sequence 内の変換エフェクトは個別に実行されます）。

こうした複数の変換エフェクトの結合は内部的に行われますが、これにより、考慮しなければならない特定の制約が適用されます。

ターゲットオブジェクトの transformCenter は、そのターゲットにおいてすべての変換エフェクトにグローバルに適用されるため、すべてのターゲットで同じ値に設定される必要があります。
変換エフェクトは、繰り返しパラメーターを無視します。これは、単一の Transform エフェクトによるエフェクトが、同じターゲットで実行されている他のすべての Transform エフェクトに影響するためです。ただし、エフェクトを CompositeEffect 内にカプセル化することによって繰り返すことができます。
AnimateTransform クラスのサブクラスでは変換エフェクトの単純な操作を簡単に行うことができますが、基になるキーフレームの時間と値を完全に制御してきめ細かく操作するには、AnimateTransform エフェクトを直接使用します。

さらに、このエフェクトとそのサブクラスでは、ターゲットに UIComponent 型または GraphicElement 型（あるいはそれらのクラスのサブクラス）を使用する必要があるという制約があります（同様に定義されて実装された transformAround() 関数と transformPointToParent() 関数を持つ、その他のオブジェクトの型を使用することもできます）。

このエフェクトは直接使用するためのものではなく、サブクラスによって使用される共通機能を公開します。変換エフェクトを使用するには、サブクラスのエフェクト（Move、Move3D、Scale、Scale3D、Rotate、Rotate3D）を使用します。

MXML シンタックス expanded

MXML シンタックスを隠す

The <s:AnimateTransform> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:AnimateTransform
    Properties
    id="ID"
    applyChangesPostLayout="false"
    autoCenterTransform="false"
    transformX="0"
    transformY="0"
    transformZ="0"
  />

デフォルトの MXML プロパティmotionPaths

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		applyChangesPostLayout : Boolean AnimateTransform のサブクラスでは、このフラグを使用して、Layout Manager によって使用された変換値をエフェクトが変更するかどうか、つまりレイアウトが実行された後で使用された値を変更するかどうかを指定します。	AnimateTransform
		autoCenterTransform : Boolean = false エフェクトの再生時にターゲットの中心付近 (width/2, height/2) で変換エフェクトを発生させるかどうかを指定します。	AnimateTransform
		className : String [読み取り専用] このエフェクトクラスの名前です。たとえば、"Fade" などがあります。	Effect
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		customFilter : mx.effects:EffectTargetFilter エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルターオブジェクトを指定します。	Effect
		disableLayout : Boolean true の場合、エフェクトはそのターゲットの親コンテナでのレイアウトを無効にし、コンテナの autoLayout プロパティを false に設定して、ターゲットオブジェクトでのすべてのレイアウト制約も無効にします。	Animate
		duration : Number エフェクトの継続時間を表します（ミリ秒単位）。	Effect
		easer : IEaser このエフェクトのイージングビヘイビアーです。	Animate
		effectTargetHost : mx.effects:IEffectTargetHost データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。	Effect
		filter : String エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。	Effect
		hideFocusRing : Boolean エフェクトの開始時にエフェクトがフォーカス枠を非表示にするかどうかを指定します。	Effect
		instanceClass : Class このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。	Effect
		interpolator : IInterpolator プロパティの開始値と終了値の間の値を計算するためにこのエフェクトによって使用されるインターポレーターです。	Animate
		isPlaying : Boolean [読み取り専用] エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。	Effect
		motionPaths : Vector.<MotionPath> MotionPath オブジェクトのベクターです。各オブジェクトには、アニメーション化するプロパティの名前と、アニメーション実行期間においてプロパティが受け取る値が保持されます。	Animate
		perElementOffset : Number エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延（ミリ秒）です。	Effect
		playheadTime : Number エフェクトの現在の時間位置です。	Effect
		relevantProperties : Array フィルタリング実行時に使用するプロパティ名の配列を表します。	Effect
		relevantStyles : Array フィルタリング実行時に使用するスタイル名の配列を表します。	Effect
		startDelay : int = 0 エフェクトを開始する前の待機時間を表します（ミリ秒単位）。	Effect
		target : Object このエフェクトが適用されるオブジェクトを表します。	Effect
		targets : Array エフェクトのターゲットであるオブジェクトの配列を表します。	Effect
		transformX : Number autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の x 座標を設定します。	AnimateTransform
		transformY : Number autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の y 座標を設定します。	AnimateTransform
		transformZ : Number autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の z 座標を設定します。	AnimateTransform
		triggerEvent : Event エフェクトがトリガーされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。	Effect

プロテクトプロパティ

継承されるプロテクトプロパティを隠す

継承されるプロテクトプロパティを表示

	プロパティ		定義元
		applyTransitionEndProperties : Boolean このフラグは、エフェクトがトランジションで実行された場合に、エフェクト自体が設定した値をそのまま使用するのではなく、その終了状態に応じてプロパティ値を自動的に適用するかどうかを制御します。	Effect
		endValuesCaptured : Boolean = false エフェクトの終了値が既に決定されている場合は true を含むフラグ、エフェクトの実行時にエフェクトターゲットの現在のプロパティから終了値を取得する必要がある場合は false を含むフラグです。	Effect

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		AnimateTransform(target:Object = null) コンストラクターです。	AnimateTransform
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		captureEndValues():void エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャし、終了値として保存します。	Effect
		captureMoreStartValues(targets:Array):void ターゲットの追加セットの関連するプロパティの現在値をキャプチャします。この機能は、データ変更エフェクトを実行したときに Flex によって使用されます。	Effect
		captureStartValues():void エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。	Effect
		createInstance(target:Object = null):IEffectInstance 1 つのエフェクトインスタンスを作成し、それを初期化します。	Effect
		createInstances(targets:Array = null):Array ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。	Effect
		deleteInstance(instance:IEffectInstance):void インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。	Effect
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		end(effectInstance:IEffectInstance = null):void 現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。	Effect
		getAffectedProperties():Array ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。	Effect
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		pause():void resume() メソッドを呼び出すまで、エフェクトを一時停止します。	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array エフェクトの再生を開始します。	Effect
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		resume():void pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。	Effect
		reverse():void エフェクトが現在再生中の場合に、エフェクトの現在位置から開始して、逆順でエフェクトを再生します。	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		stop():void エフェクトターゲットを現在の状態にしたまま、エフェクトを停止します。	Effect
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

プロテクトメソッド

継承されるプロテクトメソッドを隠す

継承されるプロテクトメソッドを表示

	メソッド		定義元
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void エフェクトインフラストラクチャによって内部的に使用されます。	Effect
		effectEndHandler(event:EffectEvent):void エフェクトインスタンスの再生終了時に呼び出されます。	Effect
		effectStartHandler(event:EffectEvent):void このメソッドは、エフェクトインスタンスの再生開始時に呼び出されます。	Effect
		effectStopHandler(event:EffectEvent):void エフェクトインスタンスが stop() メソッドの呼び出しによって停止されると呼び出されます。	Effect
		filterInstance(propChanges:Array, target:Object):Boolean エフェクトインスタンスをフィルタリングするために必要なロジックを決定します。	Effect
		getValueFromTarget(target:Object, property:String):* ターゲットからプロパティの値を取得するために captureStartValues() メソッドによって呼び出されます。	Effect
		initInstance(instance:IEffectInstance):void エフェクトインスタンスにエフェクトのプロパティをコピーします。	Effect

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
effectEnd	エフェクトのインスタンスの 1 つが再生を停止したとき（インスタンスの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき）に送出されます。	Effect
effectRepeat	複数回繰り返される任意のエフェクトにおいて、エフェクトが新しい繰り返し処理を開始すると送出されます。	Animate
effectStart	エフェクトの再生開始時に送出されます。	Effect
effectStop	エフェクトが停止されると送出されます。これが発生するのは、stop() メソッドの呼び出しによってエフェクトが中断された場合のみです。	Effect
effectUpdate	エフェクトでターゲットが更新されるたびに送出されます。	Animate

プロパティの詳細

applyChangesPostLayout

プロパティ

applyChangesPostLayout:Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

AnimateTransform のサブクラスでは、このフラグを使用して、Layout Manager によって使用された変換値をエフェクトが変更するかどうか、つまりレイアウトが実行された後で使用された値を変更するかどうかを指定します。

デフォルト値： false。

実装
public function get applyChangesPostLayout():Boolean
public function set applyChangesPostLayout(value:Boolean):void

autoCenterTransform

プロパティ

public var autoCenterTransform:Boolean = false

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

エフェクトの再生時にターゲットの中心付近 (width/2, height/2) で変換エフェクトを発生させるかどうかを指定します。フラグが設定されていない場合、変換の中心は、オブジェクトの変換の中心（transformX, transformY, transformZ）と、このエフェクトの transformX、transformY、transformZ プロパティによって決定されます。つまり、変換の中心はターゲットオブジェクトの変換の中心であり、この transformX、transformY、transformZ プロパティが、エフェクトにあるそれらの値（設定されている場合）によってオーバーライドされます。

デフォルト値： false。

transformX

プロパティ

public var transformX:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の x 座標を設定します。

autoCenterTransform が false の場合、変換の中心はターゲットオブジェクトの transformX、transformY、transformZ プロパティによって決定されますが、これらの各プロパティは、このエフェクトで各プロパティを設定することによってオーバーライドできます。

transformY

プロパティ

public var transformY:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の y 座標を設定します。

transformZ

プロパティ

public var transformZ:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

autoCenterTransform プロパティによってオーバーライドされない場合、変換の中心の z 座標を設定します。

コンストラクターの詳細

()

コンストラクター

public function AnimateTransform(target:Object = null)

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンストラクターです。

パラメーター

target:Object (default = null) — このエフェクトでアニメーション化するオブジェクトを表します。

法律上の注意 | プライバシーポリシー

AnimateTransform - AS3 Flex

クラス x

applyChangesPostLayout

autoCenterTransform

transformX

transformY

transformZ

AnimateTransform