mx.effects.AnimateProperty (Flex™ 2 リファレンスガイド)

パッケージ	mx.effects
	public class AnimateProperty
継承	AnimateProperty TweenEffect Effect EventDispatcher Object

AnimateProperty エフェクトは、コンポーネントのプロパティまたはスタイルを推移させます。ユーザーは、アニメーション化するプロパティのプロパティ名、開始値、および終了値を指定します。このエフェクトはまずプロパティを開始値に設定し、エフェクトの継続中はプロパティの値が終了値に達するまで値を更新し続けます。

たとえば、Button コントロールの幅を変化させる場合は、推移させるプロパティとして width を指定し、さらにエフェクトの開始時と終了時の幅をそれぞれ指定します。

MXML シンタックス expanded

MXML シンタックスの非表示

<mx:AnimateProperty> タグはスーパークラスのすべてのタグ属性を継承し、次のタグ属性を追加します。

 <mx:AnimateProperty id="ID" fromValue="0" isStyle="false|true" property="必須" roundValue="false|true" toValue="0" />

例の表示

パブリックプロパティ

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

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

	プロパティ		定義
		className : String `"Fade"` など、エフェクトクラスの名前です。	Effect
		constructor : Object 特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		customFilter : EffectTargetFilter エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。	Effect
		duration : Number エフェクトの継続時間を表します (ミリ秒単位)。	Effect
		easingFunction : Function = null アニメーションのイージング関数を表します。	TweenEffect
		filter : String エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。	Effect
		fromValue : Number エフェクトのプロパティの開始値を表します。	AnimateProperty
		instanceClass : Class このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。	Effect
		isPlaying : Boolean エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。	Effect
		isStyle : Boolean = false `true` の場合、プロパティ属性はスタイルとなり、`setStyle()` メソッドを使用して設定します。	AnimateProperty
		property : String アニメーション化するターゲットのプロパティの名前を表します。	AnimateProperty
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		relevantProperties : Array フィルタリング実行時に使用するプロパティ名の配列を表します。	Effect
		relevantStyles : Array フィルタリング実行時に使用するスタイル名の配列を表します。	Effect
		repeatCount : int = 1 エフェクトを繰り返す回数を表します。	Effect
		repeatDelay : int = 0 エフェクトを繰り返す前の待機時間を表します (ミリ秒単位)。	Effect
		roundValue : Boolean = false `true` の場合、補間されたトゥイーン値をその最も近い整数に四捨五入します。	AnimateProperty
		startDelay : int = 0 エフェクトを開始する前の待機時間を表します (ミリ秒単位)。	Effect
		suspendBackgroundProcessing : Boolean = false `true` の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。	Effect
		target : Object このエフェクトが適用される UIComponent オブジェクトを表します。	Effect
		targets : Array エフェクトのターゲットである UIComponent オブジェクトの配列を表します。	Effect
		toValue : Number エフェクトの終了値を表します。	AnimateProperty

パブリックメソッド

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

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

	メソッド		定義
		AnimateProperty(target:Object = null) コンストラクタ。	AnimateProperty
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		captureStartValues():void エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。	Effect
		createInstance(target:Object = null):EffectInstance 1 つのエフェクトインスタンスを作成し、それを初期化します。	Effect
		createInstances(targets:Array = null):Array ターゲットオブジェクトの配列を取得し、各ターゲットで `createInstance()` メソッドを呼び出します。	Effect
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		end(effectInstance:EffectInstance = 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
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブ値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

Protectedメソッド

継承される Protected メソッドの表示

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

イベント

継承されるイベントの非表示

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

	一覧	定義
effectEnd	エフェクトの再生停止時 (エフェクトの再生完了時、またはエフェクトが `end()` メソッドの呼び出しにより中断されたとき) に送出されます。	Effect
effectStart	エフェクトの再生開始時に送出されます。	Effect
tweenEnd	トゥイーンエフェクトの終了時に送出されます。	TweenEffect
tweenStart	`onTweenUpdate()` メソッドの最初の呼び出しに対応する、トゥイーンエフェクトの開始時に送出されます。	TweenEffect
tweenUpdate	トゥイーンエフェクトによりターゲットが更新されるたびに送出されます。	TweenEffect

プロパティの詳細

fromValue

プロパティ

public var fromValue:Number

エフェクトのプロパティの開始値を表します。デフォルト値は、ターゲットの現在のプロパティ値です。

isStyle

プロパティ

public var isStyle:Boolean = false

true の場合、プロパティ属性はスタイルとなり、setStyle() メソッドを使用して設定します。

デフォルト値false.

property

プロパティ

public var property:String

アニメーション化するターゲットのプロパティの名前を表します。この属性は必須です。

roundValue

プロパティ

public var roundValue:Boolean = false

true の場合、補間されたトゥイーン値をその最も近い整数に四捨五入します。このプロパティは、アニメーション化するプロパティが整数または符号なし整数の場合に有効です。

デフォルト値false.

toValue

プロパティ

public var toValue:Number

エフェクトの終了値を表します。デフォルト値は、ターゲットの現在のプロパティ値です。

コンストラクタの詳細

AnimateProperty

()

コンストラクタ

public 関数 AnimateProperty(target:Object = null)

コンストラクタ。

パラメータ

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

例

AnimatePropertyEffectExample

<?xml version="1.0"?>
<!-- Simple example to demonstrate the AnimateProperty effect. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Sequence id="animateScaleXUpDown" >
        <mx:AnimateProperty property="scaleX" fromValue="1" toValue="1.5" duration="1000" />
        <mx:AnimateProperty property="scaleX" fromValue="1.5" toValue="1" duration="1000" />    
    </mx:Sequence>

    <mx:Panel title="AnimateProperty Effect Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Text width="100%" color="blue" 
            text="Click on the image to use the AnimateProperty effect with the scaleX property."/>

        <mx:Image id="flex" source="@Embed(source='assets/Nokia_6630.png')"
            mouseDownEffect="{animateScaleXUpDown}"/>

    </mx:Panel>
</mx:Application>

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/mx/effects/AnimateProperty.html

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class AnimateProperty	プロパティ \| メソッド \| イベント \| 例