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

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

Move エフェクトは、指定された時間間隔でコンポーネントの位置を変更します。初期位置は xFrom と yFrom、移動先の位置は xTo と yTo の値でそれぞれ指定できます。また、コンポーネントの移動ピクセル数は xBy と yBy で指定できます。

初期位置、移動先の位置、または移動量のうち、2 つを指定すると、残りの 1 つは Flex で計算されます。3 つの値をすべて指定すると、xBy と yBy の値が無視されます。xTo と yTo の値、または xBy と yBy の値のみを指定すると、xFrom と yFrom はオブジェクトの現在の位置に設定されます。

moveEffect トリガに Move エフェクトを指定し、From、To、By の 6 つのプロパティ値をどれも設定しない場合、オブジェクトが現在の位置から新しい位置にスムーズに移動するように、これらのプロパティの値が設定されます。

オブジェクトの元の位置が親コンテナによって決まっていた場合 (たとえば、オブジェクトが HBox コンテナの内部にある場合)、コンテナのレイアウトコードを次回実行したときに、オブジェクトの位置はその元の位置にリセットされます。オブジェクトが元の位置に戻らないようにするには、オブジェクトを Canvas コンテナの内部に置くか、親コンテナの autoLayout プロパティを false に設定します。

MXML シンタックス expanded

MXML シンタックスの非表示

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

 <mx:Move id="ID" xFrom="val" yFrom="val" xTo="val" yTo="val" xBy="val" yBy="val" />

例の表示

関連項目

mx.effects.effectClasses.MoveInstance

パブリックプロパティ

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

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

	プロパティ		定義
		className : String `"Fade"` など、エフェクトクラスの名前です。	Effect
		constructor : Object 特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		customFilter : EffectTargetFilter エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。	Effect
		duration : Number エフェクトの継続時間を表します (ミリ秒単位)。	Effect
		easingFunction : Function = null アニメーションのイージング関数を表します。	TweenEffect
		filter : String エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。	Effect
		instanceClass : Class このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。	Effect
		isPlaying : Boolean エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。	Effect
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	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
		xBy : Number コンポーネントを x 軸に沿って移動するピクセル数を表します。	Move
		xFrom : Number 初期位置の x 座標を表します。	Move
		xTo : Number 移動先の位置の x 座標を表します。	Move
		yBy : Number コンポーネントを y 軸に沿って移動するピクセル数を表します。	Move
		yFrom : Number 初期位置の y 座標を表します。	Move
		yTo : Number 移動先の位置の y 座標を表します。	Move

パブリックメソッド

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

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

	メソッド		定義
		Move(target:Object = null) コンストラクタ。	Move
		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

プロパティの詳細

xBy

プロパティ

public var xBy:Number

コンポーネントを x 軸に沿って移動するピクセル数を表します。負の数値を指定することもできます。

xFrom

プロパティ

public var xFrom:Number

初期位置の x 座標を表します。

xTo

プロパティ

public var xTo:Number

移動先の位置の x 座標を表します。

yBy

プロパティ

public var yBy:Number

コンポーネントを y 軸に沿って移動するピクセル数を表します。負の数値を指定することもできます。

yFrom

プロパティ

public var yFrom:Number

初期位置の y 座標を表します。

yTo

プロパティ

public var yTo:Number

移動先の位置の y 座標を表します。

コンストラクタの詳細

Move

()

コンストラクタ

public 関数 Move(target:Object = null)

コンストラクタ。

パラメータ

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

例

MoveEffectExample

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

    <mx:Script>
        <![CDATA[

            private function moveImage():void {
                myMove.end();
                myMove.xTo=mouseX-60; 
                myMove.play();
            }
      ]]>
    </mx:Script>

    <mx:Move id="myMove" target="{img}"/>

    <mx:Panel title="Move Effect Example" width="95%" height="95%" 
        paddingTop="5" paddingLeft="10" paddingRight="10" paddingBottom="5">

       <mx:Text width="100%" color="blue" 
           text="Click anywhere on the canvas to move the phone horizontally to that position"/>

        <mx:Canvas id="canvas" width="100%" height="100%" mouseDown="moveImage();">

            <mx:Image id="img" source="@Embed(source='assets/Nokia_6630.png')"/>

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

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