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

Zoom エフェクトは、中心点を基準にオブジェクトを拡大または縮小します。

システムフォントを使用してレンダリングされたテキストに Zoom エフェクトを適用すると、Flex では整数ポイントサイズ単位でテキストを拡大・縮小します。Zoom エフェクトをテキストに適用するときに埋め込みフォントを使用する必要はありませんが、埋め込みフォントに適用すると Zoom がよりスムーズになります。

メモ:Container.autoLayout プロパティが false の場合、Zoom エフェクトは機能しません。

MXML シンタックスexpandedMXML シンタックスの非表示

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

 <mx:Zoom id="ID" captureRollEvents="false|true" originX="計算された値" originY="計算された値" zoomWidthFrom="0.01" zoomWidthTo="1.0" zoomHeightFrom="0.01" zoomHeightTo="1.0" /> 

例の表示

関連項目

mx.effects.effectClasses.ZoomInstance
mx.managers.LayoutManager


パブリックプロパティ
 プロパティ定義
  captureRollEvents : Boolean
true の場合、マウスが移動されていなければ Flex は rollOut および rollOver イベントを送出しません。
Zoom
 InheritedclassName : String
"Fade" など、エフェクトクラスの名前です。
Effect
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcustomFilter : EffectTargetFilter
エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。
Effect
 Inheritedduration : Number
エフェクトの継続時間を表します (ミリ秒単位)。
Effect
 InheritedeasingFunction : Function = null
アニメーションのイージング関数を表します。
TweenEffect
 Inheritedfilter : String
エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。
Effect
 InheritedinstanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。
Effect
 InheritedisPlaying : Boolean
エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。
Effect
  originX : Number
この数値は、Canvas コンテナなど、絶対配置をサポートするコンテナにエフェクトターゲットがある場合にズーム原点の X 位置を表します。
Zoom
  originY : Number
この数値は、Canvas コンテナなど、絶対配置をサポートするコンテナにエフェクトターゲットがある場合にズーム原点の Y 位置を表します。
Zoom
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 InheritedrelevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。
Effect
 InheritedrelevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。
Effect
 InheritedrepeatCount : int = 1
エフェクトを繰り返す回数を表します。
Effect
 InheritedrepeatDelay : int = 0
エフェクトを繰り返す前の待機時間を表します (ミリ秒単位)。
Effect
 InheritedstartDelay : int = 0
エフェクトを開始する前の待機時間を表します (ミリ秒単位)。
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。
Effect
 Inheritedtarget : Object
このエフェクトが適用される UIComponent オブジェクトを表します。
Effect
 Inheritedtargets : Array
エフェクトのターゲットである UIComponent オブジェクトの配列を表します。
Effect
  zoomHeightFrom : Number
0.01 から 1.0 のパーセント表記で、高さズーム開始時の倍率を示す数値を表します。
Zoom
  zoomHeightTo : Number
0.01 から 1.0 のパーセント表記で、高さズーム終了時の倍率を示す数値を表します。
Zoom
  zoomWidthFrom : Number
0.01 から 1.0 のパーセント表記で、幅ズーム開始時の倍率を示す数値を表します。
Zoom
  zoomWidthTo : Number
0.01 から 1.0 のパーセント表記で、幅ズーム終了時の倍率を示す数値を表します。
Zoom
パブリックメソッド
 メソッド定義
  Zoom(target:Object = null)
コンストラクタ。
Zoom
 InheritedaddEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 InheritedcaptureStartValues():void
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。
Effect
 InheritedcreateInstance(target:Object = null):EffectInstance
1 つのエフェクトインスタンスを作成し、それを初期化します。
Effect
 InheritedcreateInstances(targets:Array = null):Array
ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。
Effect
 InheriteddispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inheritedend(effectInstance:EffectInstance = null):void
現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。
Effect
 InheritedgetAffectedProperties():Array
ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。
Effect
 InheritedhasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inheritedpause():void
resume() メソッドを呼び出すまで、エフェクトを一時停止します。
Effect
 Inheritedplay(targets:Array = null, playReversedFromEnd:Boolean = false):Array
エフェクトの再生を開始します。
Effect
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedremoveEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inheritedresume():void
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。
Effect
 Inheritedreverse():void
エフェクトが現在再生中の場合に、エフェクトの現在位置から開始して、逆順でエフェクトを再生します。
Effect
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 InheritedtoString():String
指定されたオブジェクトのストリング表現を返します。
Object
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
 InheritedwillTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
Protectedメソッド
 メソッド定義
 InheritedapplyValueToTarget(target:Object, property:String, value:*, props:Object):void
エフェクトインフラストラクチャによって内部的に使用されます。
Effect
 InheritedeffectEndHandler(event:EffectEvent):void
エフェクトインスタンスの再生終了時に呼び出されます。
Effect
 InheritedeffectStartHandler(event:EffectEvent):void
このメソッドは、エフェクトインスタンスの再生開始時に呼び出されます。
Effect
 InheritedfilterInstance(propChanges:Array, targ:Object):Boolean
エフェクトインスタンスのフィルタリングに必要なロジックを決定します。
Effect
 InheritedgetValueFromTarget(target:Object, property:String):*
ターゲットからプロパティの値を取得するために captureStartValues() によって呼び出されます。
Effect
 InheritedinitInstance(instance:EffectInstance):void
エフェクトインスタンスにエフェクトのプロパティをコピーします。
Effect
 InheritedtweenEventHandler(event:TweenEvent):void
TweenEffect から TweenEvent が送出されたときに呼び出されます。
TweenEffect
イベント
 イベント一覧定義
 InheritedeffectEnd エフェクトの再生停止時 (エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき) に送出されます。Effect
 InheritedeffectStart エフェクトの再生開始時に送出されます。Effect
 InheritedtweenEnd トゥイーンエフェクトの終了時に送出されます。TweenEffect
 InheritedtweenStart onTweenUpdate() メソッドの最初の呼び出しに対応する、トゥイーンエフェクトの開始時に送出されます。TweenEffect
 InheritedtweenUpdate トゥイーンエフェクトによりターゲットが更新されるたびに送出されます。TweenEffect
プロパティの詳細
captureRollEventsプロパティ
public var captureRollEvents:Boolean

true の場合、マウスが移動されていなければ Flex は rollOut および rollOver イベントを送出しません。Zoom エフェクトを使用してターゲットのサイズを切り替える場合は、このプロパティを true に設定します。

たとえば、rollOverEffect で Zoom エフェクトをトリガして、ターゲットのサイズを縮小するとします。ターゲットが縮小してマウスポインタがターゲット上から外れると、rollOut イベントおよび対応する rollOutEffect がトリガされます。captureRollEvents プロパティを true に設定することによって、マウスを移動させた場合を除き、Flex が rollOut イベントを送出しないようにできます。

デフォルト値false.

originXプロパティ 
public var originX:Number

この数値は、Canvas コンテナなど、絶対配置をサポートするコンテナにエフェクトターゲットがある場合にズーム原点の X 位置を表します。ズーム原点とは、Zoom エフェクトが中心点の基準とするターゲット上の位置のことです。

値の範囲は 0 からターゲットコンポーネントの幅になります。

デフォルト値は target.width / 2 で、これは、ターゲットの中心です。
originYプロパティ 
public var originY:Number

この数値は、Canvas コンテナなど、絶対配置をサポートするコンテナにエフェクトターゲットがある場合にズーム原点の Y 位置を表します。ズーム原点とは、Zoom エフェクトが中心点の基準とするターゲット上の位置のことです。

値の範囲は 0 からターゲットコンポーネントの高さになります。

デフォルト値は target.height / 2 で、これは、ターゲットの中心です。
zoomHeightFromプロパティ 
public var zoomHeightFrom:Number

0.01 から 1.0 のパーセント表記で、高さズーム開始時の倍率を示す数値を表します。デフォルト値は 0.01 です。これは、非常に小さな倍率です。

zoomHeightToプロパティ 
public var zoomHeightTo:Number

0.01 から 1.0 のパーセント表記で、高さズーム終了時の倍率を示す数値を表します。デフォルト値は 1.0 です。これは、オブジェクトの標準のサイズです。

zoomWidthFromプロパティ 
public var zoomWidthFrom:Number

0.01 から 1.0 のパーセント表記で、幅ズーム開始時の倍率を示す数値を表します。デフォルト値は 0.01 です。これは、非常に小さな倍率です。

zoomWidthToプロパティ 
public var zoomWidthTo:Number

0.01 から 1.0 のパーセント表記で、幅ズーム終了時の倍率を示す数値を表します。デフォルト値は 1.0 です。これは、オブジェクトの標準のサイズです。

コンストラクタの詳細
Zoom()コンストラクタ
public 関数 Zoom(target:Object = null)

コンストラクタ。

パラメータ
target:Object (default = null) — このエフェクトでアニメーション化するオブジェクトを表します。
ZoomEffectExample
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Zoom effect. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[        
            import flash.events.MouseEvent;
        
            public function doZoom(event:MouseEvent):void {
                if (zoomAll.isPlaying) {
                    zoomAll.reverse();
                }
                else {
                    // If this is a ROLL_OUT event, play the effect backwards. 
                    // If this is a ROLL_OVER event, play the effect forwards.
                    zoomAll.play([event.target], event.type == MouseEvent.ROLL_OUT ? true : false);
                }
            }
        ]]>    
    </mx:Script>

    <mx:Zoom id="zoomAll" zoomWidthTo="1" zoomHeightTo="1" zoomWidthFrom=".5" zoomHeightFrom=".5"  />
    
    <mx:Panel title="Zoom Effect Example" width="95%" height="95%" horizontalAlign="center"
        paddingTop="5" paddingLeft="10" paddingRight="10" paddingBottom="5">

        <mx:Text width="100%" color="blue"
            text="Move the mouse over the image to enlarge it. Move the mouse off of the image to shrink it."/>

        <mx:Image id="img"
            source="@Embed(source='assets/Nokia_6630.png')"
            scaleX=".5" scaleY=".5"
            rollOver="doZoom(event)"
            rollOut="doZoom(event)"/>

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