mx.effects.Dissolve （Flex 3.2）

パッケージ	mx.effects
クラス	public class Dissolve
継承	Dissolve TweenEffect Effect EventDispatcher Object

コンポーネントが透明から不透明に、または不透明から透明に推移するようなアニメーション効果を設定します。 Dissolve エフェクトを再生すると、次のことが実行されます。

エフェクトの開始時に、不透明な矩形が作成されます。矩形はターゲットコンポーネントの上に浮かびます。矩形の色は Dissolve.color プロパティに一致し、alpha プロパティの初期値は（1.0 - Dissolve.alphaFrom）に設定されます。
エフェクトの再生に伴い、矩形の alpha プロパティが（1.0 - alphaFrom）から（1.0 - alphaTo）に変化します。徐々に矩形が不透明になり、その下に表示されるコンテンツが消えていきます。
エフェクトが終了すると、矩形が破棄されます。

ターゲットオブジェクトがコンテナの場合、Dissolve エフェクトはコンテナのコンテンツ領域に適用されます。コンテンツ領域は、コンテナの背景色が可視になっている領域です。

メモ： Dissolve エフェクトを DataGrid コントロールの creationCompleteEffect トリガで使用するには、DataGrid コントロールの子タグまたはデータバインディングを使用してコントロールインラインのデータプロバイダを定義する必要があります。この問題の原因は、creationComplete イベントが送出されるまでデータプロバイダが設定されないことにあります。そのため、エフェクトの再生開始時には、Flex による DataGrid コントロールのサイズ調整は完了していません。

MXML のシンタックス expanded

MXML シンタックスを隠す

The <mx:Dissolve> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Dissolve
    id="ID"
    alphaFrom="val"
    alphaTo="val"
    color="val"
  />

例を表示

パブリックプロパティ

継承されるパブリックプロパティを隠す

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

	プロパティ		定義元
		alphaFrom : Number 初期透明度レベルの範囲は 0.0 ～ 1.0 です。0.0 の場合は透明になり、1.0 の場合は完全に不透明になります。	Dissolve
		alphaTo : Number 最終的な透明度レベルは 0.0 から 1.0 の範囲です（0.0 = 透明、1.0 = 完全に不透明）。	Dissolve
		className : String [読み取り専用] このエフェクトクラスの名前です。たとえば、"Fade" などがあります。	Effect
		color : uint = 0xFFFFFFFF エフェクトによってターゲットオブジェクトの上に浮いて表示される矩形の色を表す 16 進値です。	Dissolve
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		customFilter : EffectTargetFilter エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルタオブジェクトを指定します。	Effect
		duration : Number エフェクトの継続時間を表します（ミリ秒単位）。	Effect
		easingFunction : Function = null アニメーションのイージング関数を表します。	TweenEffect
		effectTargetHost : IEffectTargetHost データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。	Effect
		filter : String エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。	Effect
		hideFocusRing : Boolean エフェクトの開始時にエフェクトがフォーカスリングを非表示にするかどうかを指定します。	Effect
		instanceClass : Class このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。	Effect
		isPlaying : Boolean [読み取り専用] エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。	Effect
		perElementOffset : Number エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延（ミリ秒）です。	Effect
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	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
		targetArea : RoundedRectangle エフェクトを再生するターゲットの領域を表します。	Dissolve
		targets : Array エフェクトのターゲットである UIComponent オブジェクトの配列を表します。	Effect
		triggerEvent : Event エフェクトがトリガされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。	Effect

	プロパティ	定義元
		endValuesCaptured : Boolean = false エフェクトの終了値が既に決定されている場合は true を含むフラグ、エフェクトの実行時にエフェクトターゲットの現在のプロパティから終了値を取得する必要がある場合は false を含むフラグです。	Effect

パブリックメソッド

継承されるパブリックメソッドを隠す

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

	メソッド		定義元
		Dissolve(target:Object = null) コンストラクタです。	Dissolve
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		captureEndValues():void エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャし、終了値として保存します。	Effect
		captureMoreStartValues(targets:Array):void ターゲットの追加セットの関連するプロパティの現在値をキャプチャします。この機能は、データ変更エフェクトを実行したときに Flex によって使用されます。	Effect
		captureStartValues():void エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。	Effect
		createInstance(target:Object = null):IEffectInstance 1 つのエフェクトインスタンスを作成し、それを初期化します。	Effect
		createInstances(targets:Array = null):Array ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。	Effect
		deleteInstance(instance:IEffectInstance):void インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。	Effect
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		end(effectInstance:IEffectInstance = 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
		stop():void エフェクトターゲットを現在の状態にしたまま、エフェクトを停止します。	Effect
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

プロテクトメソッド

継承されるプロテクトメソッドを表示

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

イベント

継承されるイベントを隠す

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

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
effectEnd	エフェクトの再生停止時（エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき）に送出されます。	Effect
effectStart	エフェクトの再生開始時に送出されます。	Effect
tweenEnd	トゥイーンエフェクトの終了時に送出されます。	TweenEffect
tweenStart	トゥイーンエフェクトの開始時に送出されます。これは onTweenUpdate() メソッドの最初の呼び出しに対応します。	TweenEffect
tweenUpdate	トゥイーンエフェクトでターゲットが更新されるたびに送出されます。	TweenEffect

プロパティの詳細

alphaFrom

プロパティ

public var alphaFrom:Number

最初の透明度レベルは 0.0 から 1.0 の範囲です（0.0 = 透明、1.0 = 完全に不透明）。

エフェクトによってターゲットコンポーネントが非表示になる場合、デフォルト値はターゲットの alpha プロパティの現在値です。エフェクトによってターゲットコンポーネントが表示される場合、デフォルト値は 0.0 です。

alphaTo

プロパティ

public var alphaTo:Number

最終的な透明度レベルは 0.0 から 1.0 の範囲です（0.0 = 透明、1.0 = 完全に不透明）。

エフェクトによってターゲットコンポーネントが非表示になる場合、デフォルト値は 0.0 です。エフェクトによってターゲットコンポーネントが表示される場合、デフォルト値はターゲットの alpha プロパティの現在値です。

color

プロパティ

public var color:uint = 0xFFFFFFFF

エフェクトによってターゲットオブジェクトの上に浮いた状態で表示される矩形の色を表す 16 進値です。デフォルト値は、ターゲットコンポーネントの backgroundColor スタイルプロパティで指定された色です。backgroundColor が設定されていない場合は 0xFFFFFF です。

targetArea

プロパティ

public var targetArea:RoundedRectangle

エフェクトを再生するターゲットの領域を表します。 Dissolve オーバーレイは、このプロパティのサイズを使用して描画されます。 UIComponent は、コンポーネント全体にわたるオーバーレイを作成します。コンテナは、クロムではなくコンテンツ領域上にオーバーレイを作成します。

デフォルト値 : null.

コンストラクタの詳細

Dissolve

()

コンストラクタ

public function Dissolve(target:Object = null)

コンストラクタです。

パラメータ

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

例例の使用法

DissolveEffectExample.mxml

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

    <mx:Dissolve id="dissolveOut" duration="1000" alphaFrom="1.0" alphaTo="0.0"/>
    <mx:Dissolve id="dissolveIn" duration="1000" alphaFrom="0.0" alphaTo="1.0"/>

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

        <mx:VBox height="100%">
            <mx:Label text="Nokia 9930"  
                fontSize="14"
                visible="{cb1.selected}"
                hideEffect="{dissolveOut}" showEffect="{dissolveIn}"/>
            
            <mx:Image source="@Embed(source='assets/Nokia_6630.png')" 
                visible="{cb1.selected}"
                hideEffect="{dissolveOut}" showEffect="{dissolveIn}"/>
        </mx:VBox>
            
        <mx:VBox height="100%" width="100%">
            <mx:Text width="100%" color="blue" 
                text="Use the Dissolve effect to show or hide the text, image, and button."/>
            
                <mx:Spacer height="100%"/>
            
                <mx:Button label="Purchase" 
                    visible="{cb1.selected}"
                    hideEffect="{dissolveOut}" showEffect="{dissolveIn}"/>            
        </mx:VBox>

        <mx:ControlBar>
            <mx:CheckBox id="cb1" label="visible" selected="true"/>
        </mx:ControlBar>
    </mx:Panel>
</mx:Application>

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

Adobe® Flex™ 3.2 リファレンスガイド This Help system only	すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
Dissolve	プロパティ \| メソッド \| イベント \| 例