パッケージmx.effects
public class MaskEffect
継承MaskEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object
SubclassesIris, 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 エフェクトで showtrue に設定されている場合、マスクの初期位置は (ターゲットの幅, 0) で、最終位置は (0, 0) になります。

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

次のプロパティが MaskEffect クラスで定義され、このクラスのすべてのサブクラスに継承されます。

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

関連項目

mx.effects.effectClasses.MaskEffectInstance
mx.effects.TweenEffect
カスタムマスク関数の作成


パブリックプロパティ
 プロパティ定義
 InheritedclassName : String
"Fade" など、エフェクトクラスの名前です。
Effect
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  createMaskFunction : Function
エフェクトによってマスクが作成される際に呼び出される関数を表します。
MaskEffect
 InheritedcustomFilter : EffectTargetFilter
エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。
Effect
 Inheritedduration : Number
エフェクトの継続時間を表します (ミリ秒単位)。
Effect
 Inheritedfilter : String
エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。
Effect
 InheritedinstanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。
Effect
 InheritedisPlaying : Boolean
エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。
Effect
  moveEasingFunction : Function
マスクを移動させるのに使用するイージング関数を表します。
MaskEffect
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
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
  xFrom : Number
マスクの初期位置の x 座標を表します。
MaskEffect
  xTo : Number
マスクの移動先の位置の x 座標を表します。
MaskEffect
  yFrom : Number
マスクの初期位置の y 座標を表します。
MaskEffect
  yTo : Number
マスクの移動先の位置の y 座標を表します。
MaskEffect
パブリックメソッド
 メソッド定義
  MaskEffect(target:Object = null)
コンストラクタ。
MaskEffect
 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
  getAffectedProperties():Array
このエフェクトによって変更されたコンポーネントプロパティを返します。
MaskEffect
 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
  tweenEventHandler(event:TweenEvent):void
TweenEffect から TweenEvent が送出されたときに呼び出されます。
MaskEffect
イベント
 イベント一覧定義
 InheritedeffectEnd エフェクトの再生停止時 (エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき) に送出されます。Effect
 InheritedeffectStart エフェクトの再生開始時に送出されます。Effect
  tweenEnd エフェクトの終了時に送出されます。MaskEffect
  tweenStart エフェクトの開始時に送出されます。これは onMoveTweenUpdate() および onScaleTweenUpdate() メソッドの最初の呼び出しに対応します。MaskEffect
  tweenUpdate エフェクトでターゲットが更新されるたびに送出されます。MaskEffect
プロパティの詳細
createMaskFunctionプロパティ
public var createMaskFunction:Function

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

カスタムマスク関数のシグネチャは次のとおりです。

public function createLargeMask(targ:Object, bounds:Rectangle):Shape
      {
var myMask:Shape = new FlexShape();
// マスクを作成する。
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  [read-write]

ターゲットコンポーネントを見えるようにする場合は 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 関数 MaskEffect(target:Object = null)

コンストラクタ。

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

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

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

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

関連項目

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

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

パラメータ
event:TweenEvent — TweenEvent 型のイベントオブジェクトを表します。
イベントの詳細
tweenEndevent 
イベントオブジェクトの型: mx.events.TweenEvent
TweenEvent.type property = mx.events.TweenEvent.TWEEN_END

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

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

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

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

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

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

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

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

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

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

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

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

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

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