パッケージmx.effects
クラスpublic class MaskEffect
継承MaskEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object
サブクラス Iris, WipeDown, WipeLeft, WipeRight, WipeUp

MaskEffect クラスは、Wipe エフェクトや Iris エフェクトなどのようにマスクをアニメーション化するすべてのエフェクトの抽象基本クラスです。 このクラスは、マスクベースのエフェクトすべてに共通のメソッドとプロパティをカプセル化します。

マスクエフェクトでは、マスクと呼ばれるオーバーレイによってエフェクトが実行されます。 デフォルトでは、マスクはターゲットコンポーネントと同じサイズの矩形です。

マスクエフェクトでは、エフェクト適用前または適用後のターゲットコンポーネントの状態を不可視にする必要があります。 つまり、マスクエフェクトを適用すると、ターゲットコンポーネントが常に画面上に表示されるか、非表示になります。

マスクの初期倍率と最終倍率は、scaleXFromscaleYFromscaleXToscaleX の各プロパティを使用して指定します。たとえば、1.0 を指定するとマスクのサイズはターゲットコンポーネントと同じになります。2.0 を指定するとマスクのサイズはコンポーネントの 2 倍になります。 0.5 を指定するとマスクのサイズはコンポーネントの半分になります。4 つのプロパティすべてを指定すると、どのプロパティも使用できるようになります。

ターゲットコンポーネントに対するマスクの初期相対位置と最終相対位置の座標は、xFromyFromxToyTo の各プロパティを使用して指定します。(0, 0)はターゲットの左上隅を表します。4 つのプロパティすべてを指定すると、どのプロパティも使用できるようになります。

マスクの初期位置と最終位置の座標は、エフェクトの種類と、show プロパティの値が truefalse のどちらであるかによって異なります。 たとえば、WipeLeft エフェクトで show の値が false に設定されている場合、マスクの初期位置の座標は(0, 0)、つまりターゲットの左上隅になります。また、最終位置の座標はターゲットの右上の隅、つまり(ターゲットの幅, 0)になります。

WipeLeft エフェクトで show の値が true に設定されている場合、マスクの初期位置は(ターゲットの幅, 0)で、最終位置は(0, 0)になります。

MXML のシンタックスexpandedMXML シンタックスを隠す

The MaskEffect class defines the following properties, which all of its subclasses inherit:

  <mx:tagname
    createMaskFunction=""
    moveEasingFunction=""
    scaleEasingFunction=""
    scaleXFrom=""
    scaleXTo=""
    scaleYFrom=""
    scaleYTo=""
    show="true|false"
    xFrom=""
    xTo=""
    yFrom=""
    yTo=""
  />
  

関連項目

mx.effects.effectClasses.MaskEffectInstance
mx.effects.TweenEffect
Working with effects
Working with effects


パブリックプロパティ
 プロパティ定義元
 InheritedclassName : String
[読み取り専用] このエフェクトクラスの名前です。たとえば、"Fade" などがあります。
Effect
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  createMaskFunction : Function
エフェクトによってマスクが作成される際に呼び出される関数を表します。
MaskEffect
 InheritedcustomFilter : EffectTargetFilter
エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。
Effect
 Inheritedduration : Number
エフェクトの継続時間を表します(ミリ秒単位)。
Effect
 InheritedeffectTargetHost : IEffectTargetHost
データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。
Effect
 Inheritedfilter : String
エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。
Effect
 InheritedhideFocusRing : Boolean
エフェクトの開始時にエフェクトがフォーカスリングを非表示にするかどうかを指定します。
Effect
 InheritedinstanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。
Effect
 InheritedisPlaying : Boolean
[読み取り専用] エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。
Effect
  moveEasingFunction : Function
マスクを移動させるのに使用するイージング関数を表します。
MaskEffect
 InheritedperElementOffset : Number
エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延(ミリ秒)です。
Effect
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 InheritedrelevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。
Effect
 InheritedrelevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。
Effect
 InheritedrepeatCount : int = 1
エフェクトを繰り返す回数を表します。
Effect
 InheritedrepeatDelay : int = 0
エフェクトを繰り返す前の待機時間を表します(ミリ秒単位)。
Effect
  scaleEasingFunction : Function
マスクの伸縮に使用するイージング関数を表します。
MaskEffect
  scaleXFrom : Number
マスクの初期 scaleX を表します。
MaskEffect
  scaleXTo : Number
マスクの終了 scaleX を表します。
MaskEffect
  scaleYFrom : Number
マスクの初期 scaleY を表します。
MaskEffect
  scaleYTo : Number
マスクの終了 scaleY を表します。
MaskEffect
  showTarget : Boolean
ターゲットコンポーネントを可視にする場合は true に設定し、不可視にする場合は false に設定します。
MaskEffect
 InheritedstartDelay : int = 0
エフェクトを開始する前の待機時間を表します(ミリ秒単位)。
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。
Effect
 Inheritedtarget : Object
このエフェクトが適用される UIComponent オブジェクトを表します。
Effect
 Inheritedtargets : Array
エフェクトのターゲットである UIComponent オブジェクトの配列を表します。
Effect
 InheritedtriggerEvent : Event
エフェクトがトリガされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。
Effect
  xFrom : Number
マスクの初期位置の x 座標を表します。
MaskEffect
  xTo : Number
マスクの移動先の位置の x 座標を表します。
MaskEffect
  yFrom : Number
マスクの初期位置の y 座標を表します。
MaskEffect
  yTo : Number
マスクの移動先の位置の y 座標を表します。
MaskEffect
プロテクトプロパティ
 プロパティ定義元
 InheritedendValuesCaptured : Boolean = false
エフェクトの終了値が既に決定されている場合は true を含むフラグ、エフェクトの実行時にエフェクトターゲットの現在のプロパティから終了値を取得する必要がある場合は false を含むフラグです。
Effect
パブリックメソッド
 メソッド定義元
  
MaskEffect(target:Object = null)
コンストラクタです。
MaskEffect
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャし、終了値として保存します。
Effect
 Inherited
ターゲットの追加セットの関連するプロパティの現在値をキャプチャします。この機能は、データ変更エフェクトを実行したときに Flex によって使用されます。
Effect
 Inherited
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。
Effect
 Inherited
1 つのエフェクトインスタンスを作成し、それを初期化します。
Effect
 Inherited
createInstances(targets:Array = null):Array
ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。
Effect
 Inherited
インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。
Effect
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。
Effect
  
[override] このエフェクトによって変更されたコンポーネントプロパティを返します。
MaskEffect
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
resume() メソッドを呼び出すまで、エフェクトを一時停止します。
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
エフェクトの再生を開始します。
Effect
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。
Effect
 Inherited
エフェクトが現在再生中の場合に、エフェクトの現在位置から開始して、逆順でエフェクトを再生します。
Effect
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
エフェクトターゲットを現在の状態にしたまま、エフェクトを停止します。
Effect
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
エフェクトインフラストラクチャによって内部的に使用されます。
Effect
 Inherited
エフェクトインスタンスの再生終了時に呼び出されます。
Effect
 Inherited
このメソッドは、エフェクトインスタンスの再生開始時に呼び出されます。
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
エフェクトインスタンスをフィルタリングするために必要なロジックを決定します。
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
ターゲットからプロパティの値を取得するために captureStartValues() メソッドによって呼び出されます。
Effect
 Inherited
エフェクトインスタンスにエフェクトのプロパティをコピーします。
Effect
  
TweenEffect から TweenEvent が送出されたときに呼び出されます。
MaskEffect
イベント
 イベント 概要 定義元
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inheritedエフェクトの再生停止時(エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき)に送出されます。Effect
 Inheritedエフェクトの再生開始時に送出されます。Effect
  エフェクトの終了時に送出されます。MaskEffect
  エフェクトの開始時に送出されます。これは onMoveTweenUpdate() および onScaleTweenUpdate() メソッドの最初の呼び出しに対応します。MaskEffect
  エフェクトでターゲットが更新されるたびに送出されます。MaskEffect
プロパティの詳細
createMaskFunctionプロパティ
public var createMaskFunction:Function

エフェクトによってマスクが作成される際に呼び出される関数を表します。 デフォルト値は、ターゲットと同じサイズの矩形を返す関数です。

カスタムマスク関数には、次のシグネチャがあります。

      public function createLargeMask(targ:Object, bounds:Rectangle):Shape
      {
          var myMask:Shape = new FlexShape();
               // Create mask.
               return myMask;
      }
      

カスタムマスク関数は、エフェクトのターゲットコンポーネントに対応する引数を受け取ります。次に、ターゲットのサイズを定義する引数を受け取るため、正確にマスクのサイズを設定できます。 この引数を使用して、widthheight などのターゲットコンポーネントのプロパティにアクセスすることができます。このため、正しいサイズのマスクを作成できます。

関数により、マスクを定義する 1 つの Shape オブジェクトが返されます。

moveEasingFunctionプロパティ 
public var moveEasingFunction:Function

マスクの移動に使用するイージング関数を表します。

デフォルト値 : null.

scaleEasingFunctionプロパティ 
public var scaleEasingFunction:Function

マスクの伸縮に使用するイージング関数を表します。

デフォルト値 : null.

scaleXFromプロパティ 
public var scaleXFrom:Number

マスクの初期 scaleX を表します。

このプロパティを指定するには、scaleXFromscaleYFromscaleXTo、および scaleX の 4 つのプロパティをすべて指定する必要があります。

scaleXToプロパティ 
public var scaleXTo:Number

マスクの終了 scaleX を表します。

このプロパティを指定するには、scaleXFromscaleYFromscaleXTo、および scaleX の 4 つのプロパティをすべて指定する必要があります。

scaleYFromプロパティ 
public var scaleYFrom:Number

マスクの初期 scaleY を表します。

このプロパティを指定するには、scaleXFromscaleYFromscaleXTo、および scaleX の 4 つのプロパティをすべて指定する必要があります。

scaleYToプロパティ 
public var scaleYTo:Number

マスクの終了 scaleY を表します。

このプロパティを指定するには、scaleXFromscaleYFromscaleXTo、および scaleX の 4 つのプロパティをすべて指定する必要があります。

showTargetプロパティ 
showTarget:Boolean

ターゲットコンポーネントを可視にする場合は true に設定し、不可視にする場合は false に設定します。 このエフェクトを showEffect または hideEffect トリガで使用するよう指定した場合、showTarget プロパティが Flex により有効になります。コンポーネントが可視の場合は true に、不可視の場合は false に設定されます。 このエフェクトを異なるエフェクトトリガで使用する場合は、startEffect イベントのイベントリスナー内でこのエフェクトを設定する必要がある場合があります。

デフォルト値 : true.



実装
    public function get showTarget():Boolean
    public function set showTarget(value:Boolean):void
xFromプロパティ 
public var xFrom:Number

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

このプロパティを指定するには、xFromyFromxTo、および yTo の 4 つのプロパティをすべて指定する必要があります。

xToプロパティ 
public var xTo:Number

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

このプロパティを指定するには、xFromyFromxTo、および yTo の 4 つのプロパティをすべて指定する必要があります。

yFromプロパティ 
public var yFrom:Number

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

このプロパティを指定するには、xFromyFromxTo、および yTo の 4 つのプロパティをすべて指定する必要があります。

yToプロパティ 
public var yTo:Number

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

このプロパティを指定するには、xFromyFromxTo、および yTo の 4 つのプロパティをすべて指定する必要があります。

コンストラクタの詳細
MaskEffect()コンストラクタ
public function MaskEffect(target:Object = null)

コンストラクタです。

パラメータ
target:Object (default = null) — このエフェクトでアニメーション化するオブジェクトを表します。
メソッドの詳細
getAffectedProperties()メソッド
override public function getAffectedProperties():Array

このエフェクトによって変更されたコンポーネントプロパティを返します。 このメソッドで返される配列には、[ "visible", "width", "height" ] があります。WipeDown、WipeLeft、WipeRight、および WipeDown のすべてのエフェクトサブクラスが同一のプロパティを変更するため、これらのクラスではこのメソッドを実装しません。

MaskEffect をサブクラス化してカスタムエフェクトを作成し、ターゲットの別のプロパティ一式を変更する場合は、このメソッドをオーバーライドして、サブクラスで変更されたプロパティリストを含む配列を返す必要があります。

戻り値
Array — このエフェクトで変更されたプロパティの名前を指定するストリングの配列を表します。

関連項目

tweenEventHandler()メソッド 
protected function tweenEventHandler(event:TweenEvent):void

TweenEffect から TweenEvent が送出されたときに呼び出されます。 このメソッドをオーバーライドする場合、必ずスーパーメソッドを呼び出すようにしてください。

パラメータ

event:TweenEvent — TweenEvent 型のイベントオブジェクトを表します。

イベントの詳細
tweenEnd イベント
イベントオブジェクトの型: mx.events.TweenEvent
プロパティ TweenEvent.type = mx.events.TweenEvent.TWEEN_END

エフェクトの終了時に送出されます。

エフェクトが 1 度だけ再生された場合、このイベントは effectEnd イベントと同時に発生します。 エフェクトを繰り返し再生させる場合、このイベントはエフェクトが繰り返されるたびに発生し、最後のエフェクトの再生後に endEffect イベントが発生します。

TweenEvent.TWEEN_END 定数により、イベントオブジェクトの type プロパティ値が tweenEnd イベント用に定義されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
valueonTweenEnd() メソッドに渡される値です。
tweenStart イベント  
イベントオブジェクトの型: mx.events.TweenEvent
プロパティ TweenEvent.type = mx.events.TweenEvent.TWEEN_START

エフェクトの開始時に送出されます。これは onMoveTweenUpdate() および onScaleTweenUpdate() メソッドの最初の呼び出しに対応します。同時に、Flex によって、エフェクトの最初の tweenUpdate イベントも送出されます。

Effect.effectStart イベントは tweenStart イベントの前に送出されます。

TweenEvent.TWEEN_START 定数により、イベントオブジェクトの type プロパティ値が tweenStart イベント用に定義されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
valueonTweenUpdate() メソッドに渡される値です。
tweenUpdate イベント  
イベントオブジェクトの型: mx.events.TweenEvent
プロパティ TweenEvent.type = mx.events.TweenEvent.TWEEN_UPDATE

エフェクトでターゲットが更新されるたびに送出されます。 このイベントの送出は、onMoveTweenUpdate() および onScaleTweenUpdate() メソッドの呼び出しに対応します。

TweenEvent.TWEEN_UPDATE 定数により、イベントオブジェクトの type プロパティ値が tweenUpdate イベント用に定義されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
valueonTweenUpdate() メソッドに渡される値です。




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

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