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

Fade エフェクトはコンポーネントの alpha プロパティを、透明から不透明に、または不透明から透明に変化するようにアニメーション化します。

showEffect トリガまたは hideEffect トリガで Fade エフェクトを指定し、alphaFrom プロパティと alphaTo プロパティで値を省略すると、このエフェクトにより alpha の値が showEffect トリガでは 0 からターゲットの現在の alpha 値に、また hideEffect トリガではターゲットの現在の alpha 値から 0 に、それぞれ自動的に推移します。

メモ:テキストで Fade エフェクトを使用するには、デバイスフォントではなく、埋め込みフォントを使用する必要があります。

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

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

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

例の表示

関連項目

mx.effects.effectClasses.FadeInstance


パブリックプロパティ
 プロパティ定義
  alphaFrom : Number
最初の透明度レベルは 0.0 から 1.0 の範囲です (0.0 = 透明、1.0 = 完全に不透明)。
Fade
  alphaTo : Number
最終的な透明度レベルを表します。(0.0 = 透明、1.0 = 完全に不透明)。
Fade
 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
 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
パブリックメソッド
 メソッド定義
  Fade(target:Object = null)
コンストラクタ。
Fade
 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
プロパティの詳細
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 です。エフェクトによってターゲットコンポーネントが表示される場合、デフォルト値はターゲットの alpha プロパティの現在値です。

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

コンストラクタ。

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

    <mx:Script>
        <![CDATA[
        
            import flash.text.Font;
            
            [Embed("assets/arial.ttf", fontName="MyArial")]
            public var arial_font:Class;
        ]]>
    </mx:Script>
    
    <mx:Fade id="fadeOut" duration="1000" alphaFrom="1.0" alphaTo="0.0"/>
    <mx:Fade id="fadeIn" duration="1000" alphaFrom="0.0" alphaTo="1.0"/>

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

        <mx:Text width="100%" color="blue" 
            text="Use the Fade effect to show or hide the text and image. Use an embedded font when applying the Fade effect to text."/>

        <mx:Label text="Nokia 9930"  
            fontFamily="MyArial" fontSize="14"
            visible="{cb1.selected}"
            hideEffect="{fadeOut}" showEffect="{fadeIn}"/>
            
        <mx:Image source="@Embed(source='assets/Nokia_6630.png')" 
            visible="{cb1.selected}"
            hideEffect="{fadeOut}" showEffect="{fadeIn}"/>
            
        <mx:CheckBox id="cb1" label="visible" selected="true"/>

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