パッケージmx.effects
クラスpublic class DefaultListEffect
継承DefaultListEffect Inheritance Parallel Inheritance CompositeEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object

DefaultListEffect クラスは、データプロバイダ内のデータが変更されたときに List コントロールのアイテムレンダラーに適用される、デフォルトエフェクトを定義します。 List コントロール内のアイテムを削除すると、このエフェクトはアイテムをフェードアウトした後、アイテムのサイズを 0 に縮小します。 アイテムを List コントロールに追加すると、このエフェクトはアイテムのスロットを拡張した後、新しいアイテムをフェードインします。

このエフェクトを List コントロールに適用するには、itemsChangeEffect スタイルプロパティを使用します。 itemsChangeEffect スタイルプロパティのデフォルト値は、undefined です。これは、エフェクトを使用しないことを示します。

DefaultListEffect エフェクトは再生時にアイテムレンダラーを拡張または縮小するため、List コントロールが行の高さを動的に変更できるように、List.variableRowHeight プロパティを true に設定する必要があります。

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

The <mx:DefaultListEffect> tag inherits all the members of its parent and adds the following members:

   <DefaultListEffect
     Properties
     color="0xFFFFFF"
     fadeInDuration="300"
     fadeOutDuration="300"
     growDuration="300"
     removedElementOffset="100"
     shrinkDuration="300"
   />
 

例を表示

関連項目

mx.controls.List


パブリックプロパティ
 プロパティ定義元
 InheritedclassName : String
[読み取り専用] このエフェクトクラスの名前です。たとえば、"Fade" などがあります。
Effect
  color : Number
追加および削除されたアイテムをフェードするときに使用される色を表す 16 進値です。
DefaultListEffect
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  fadeInDuration : Number
追加および削除されたアイテムのレンダラーをフェードインするために使用される持続時間(ミリ秒)です。
DefaultListEffect
  fadeOutDuration : Number
追加および削除されたアイテムのレンダラーをフェードアウトするために使用される持続時間(ミリ秒)です。
DefaultListEffect
  growDuration : Number
追加および削除されたアイテムのレンダラーに適用される持続時間(ミリ秒)です。
DefaultListEffect
 InheritedhideFocusRing : Boolean
エフェクトの開始時にエフェクトがフォーカスリングを非表示にするかどうかを指定します。
Effect
 InheritedinstanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。
Effect
 InheritedisPlaying : Boolean
[読み取り専用] エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。
Effect
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 InheritedrelevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。
Effect
 InheritedrelevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。
Effect
  removedElementOffset : Number
同時に削除された複数のアイテムを表すレンダラーに適用されるエフェクト間のオフセット(ミリ秒)です。
DefaultListEffect
  shrinkDuration : Number
追加および削除されたアイテムのレンダラーに適用される持続時間(ミリ秒)です。
DefaultListEffect
 InheritedstartDelay : int = 0
エフェクトを開始する前の待機時間を表します(ミリ秒単位)。
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。
Effect
 InheritedtriggerEvent : Event
エフェクトがトリガされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。
Effect
プロテクトプロパティ
 プロパティ定義元
 InheritedendValuesCaptured : Boolean = false
エフェクトの終了値が既に決定されている場合は true を含むフラグ、エフェクトの実行時にエフェクトターゲットの現在のプロパティから終了値を取得する必要がある場合は false を含むフラグです。
Effect
パブリックメソッド
 メソッド定義元
 Inherited
addChild(childEffect:IEffect):void
新しい子エフェクトを、この組み合わせたエフェクトに追加します。
CompositeEffect
 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
 Inherited
ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。
Effect
 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
イベント
 イベント 概要 定義元
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inheritedエフェクトの再生停止時(エフェクトの再生完了時、またはエフェクトが end() メソッドの呼び出しにより中断されたとき)に送出されます。Effect
 Inheritedエフェクトの再生開始時に送出されます。Effect
プロパティの詳細
colorプロパティ
color:Number

追加および削除されたアイテムをフェードするときに使用される色を表す 16 進値です。

デフォルト値 : 0xFFFFFF.



実装
    public function get color():Number
    public function set color(value:Number):void
fadeInDurationプロパティ 
fadeInDuration:Number

追加および削除されたアイテムのレンダラーをフェードインするために使用される持続時間(ミリ秒)です。

デフォルト値 : 300.



実装
    public function get fadeInDuration():Number
    public function set fadeInDuration(value:Number):void
fadeOutDurationプロパティ 
fadeOutDuration:Number

追加および削除されたアイテムのレンダラーをフェードアウトするために使用される持続時間(ミリ秒)です。

デフォルト値 : 300.



実装
    public function get fadeOutDuration():Number
    public function set fadeOutDuration(value:Number):void
growDurationプロパティ 
growDuration:Number

追加および削除されたアイテムのレンダラーに適用される持続時間(ミリ秒)です。

デフォルト値 : 300.



実装
    public function get growDuration():Number
    public function set growDuration(value:Number):void
removedElementOffsetプロパティ 
removedElementOffset:Number

同時に削除された複数のアイテムを表すレンダラーに適用されるエフェクト間のオフセット(ミリ秒)です。 0 の場合、すべてのレンダラーが同時にフェードおよび縮小されます。

デフォルト値 : 100.



実装
    public function get removedElementOffset():Number
    public function set removedElementOffset(value:Number):void
shrinkDurationプロパティ 
shrinkDuration:Number

追加および削除されたアイテムのレンダラーに適用される持続時間(ミリ秒)です。

デフォルト値 : 300.



実装
    public function get shrinkDuration():Number
    public function set shrinkDuration(value:Number):void
例の使用法
DefaultListEffectExample.mxml
<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[
            import mx.effects.DefaultListEffect;
            import mx.collections.ArrayCollection;
            
            [Bindable]
            private var myDP:ArrayCollection = new ArrayCollection(
                ['A','B','C','D','E','F','G','H']);
            
            private function deleteItem():void {
                // As each item is removed, the index of the other items changes.
                // So first get the items to delete, then determine their indices
                // as you remove them.
                var toRemove:Array = [];
                for (var i:int = 0; i < list0.selectedItems.length; i++)
                    toRemove.push(list0.selectedItems[i]);
                for (i = 0; i < toRemove.length; i++)
                    myDP.removeItemAt(myDP.getItemIndex(toRemove[i]));
            }

            private var zcount:int = 0;
            private function addItem():void {
                // Always add the new item after the third item,
                // or after the last item if the length is less than 3.
                myDP.addItemAt("Z"+zcount++,Math.min(3,myDP.length));
            }            
        ]]>
    </mx:Script>

    <!-- Define an instance of the DefaultListEffect effect, 
         and set its fadeOutDuration and color properties. -->
    <mx:DefaultListEffect id="myDLE" 
        fadeOutDuration="1000" 
        color="0x0000ff"/>

    <mx:Panel title="DefaultListEffect Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:List id="list0" 
            width="150"
            dataProvider="{myDP}" 
            variableRowHeight="true" 
            fontSize="18" 
            allowMultipleSelection="true" 
            itemsChangeEffect="{myDLE}"/>
    
        <mx:Button 
            label="Delete item" 
            click="deleteItem();"/>
        <mx:Button 
            label="Add item" 
            click="addItem();"/>

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




 

 

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

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