パッケージfl.events
クラスpublic class DataChangeEvent
継承DataChangeEvent Inheritance Event Inheritance Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataChangeEvent クラスは、コンポーネントと関連付けられたデータが変更されると送出されるイベントを定義します。このイベントは、List、DataGrid、TileList、および ComboBox コンポーネントで使用されます。

このクラスは、次のイベントを提供します。

例を表示

関連項目

DataChangeType


パブリック プロパティ
 プロパティ定義元
 Inheritedbubbles : Boolean
[read-only] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[read-only] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
  changeType : String
[read-only] イベントをトリガした変更の種類を取得します。
DataChangeEvent
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcurrentTarget : Object
[read-only] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
  endIndex : uint
[read-only] 変更されたアイテム配列内で、最後に変更されたアイテムのインデックスを取得します。
DataChangeEvent
 InheritedeventPhase : uint
[read-only] イベントフローの現在の段階です。
Event
  items : Array
[read-only] 変更されたアイテムを含む配列を取得します。
DataChangeEvent
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  startIndex : uint
[read-only] 変更されたアイテム配列内で、最初に変更されたアイテムのインデックスを取得します。
DataChangeEvent
 Inheritedtarget : Object
[read-only] イベントターゲットです。
Event
 Inheritedtype : String
[read-only] イベントのタイプです。
Event
パブリック メソッド
 メソッド定義元
  
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
指定されたパラメータで、新しい DataChangeEvent オブジェクトを作成します。
DataChangeEvent
  
DataEvent オブジェクトのコピーを作成して、各パラメータの値を元のパラメータの値と一致するように設定します。
DataChangeEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() が呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルトの動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
  
DataChangeEvent オブジェクトのすべてのプロパティを含んでいるストリングを返します。
DataChangeEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック 定数
 定数定義元
 InheritedACTIVATE : String = "activate"
[static] activate イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedADDED : String = "added"
[static] added イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] addedToStage イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[static] cancel イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCHANGE : String = "change"
[static] change イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCLOSE : String = "close"
[static] close イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCOMPLETE : String = "complete"
[static] complete イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCONNECT : String = "connect"
[static] connect イベントオブジェクトの type プロパティ値を定義します。
Event
  DATA_CHANGE : String = "dataChange"
[static] dataChange イベントオブジェクトの type プロパティ値を定義します。
DataChangeEvent
 InheritedDEACTIVATE : String = "deactivate"
[static] deactivate イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] enterFrame イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] fullScreen イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedID3 : String = "id3"
[static] id3 イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedINIT : String = "init"
[static] init イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] mouseLeave イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedOPEN : String = "open"
[static] open イベントオブジェクトの type プロパティ値を定義します。
Event
  PRE_DATA_CHANGE : String = "preDataChange"
[static] preDataChange イベントオブジェクトの type プロパティ値を定義します。
DataChangeEvent
 InheritedREMOVED : String = "removed"
[static] removed イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] removedFromStage イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedRENDER : String = "render"
[static] render イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedRESIZE : String = "resize"
[static] resize イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedSCROLL : String = "scroll"
[static] scroll イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedSELECT : String = "select"
[static] select イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] soundComplete イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] tabChildrenChange イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] tabEnabledChange イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] tabIndexChange イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedUNLOAD : String = "unload"
[static] unload イベントオブジェクトの type プロパティ値を定義します。
Event
プロパティの詳細
changeTypeプロパティ
changeType:String  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

イベントをトリガした変更の種類を取得します。DataChangeType クラスは、このプロパティの想定される値を定義します。


実装
    public function get changeType():String

関連項目

endIndexプロパティ 
endIndex:uint  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

変更されたアイテム配列内で、最後に変更されたアイテムのインデックスを取得します。


実装
    public function get endIndex():uint

関連項目

itemsプロパティ 
items:Array  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

変更されたアイテムを含む配列を取得します。


実装
    public function get items():Array
startIndexプロパティ 
startIndex:uint  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

変更されたアイテム配列内で、最初に変更されたアイテムのインデックスを取得します。


実装
    public function get startIndex():uint

関連項目

コンストラクタの詳細
DataChangeEvent()コンストラクタ
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたパラメータで、新しい DataChangeEvent オブジェクトを作成します。

パラメータ
eventType:String — 変更イベントの型です。
 
changeType:String — 実行された変更の種類です。DataChangeType クラスは、このパラメータの想定される値を定義します。
 
items:Array — 変更されたアイテムのリストです。
 
startIndex:int (default = -1) — 最初に変更されたアイテムのインデックスです。
 
endIndex:int (default = -1) — 最後に変更されたアイテムのインデックスです。
メソッドの詳細
clone()メソッド
public override function clone():Event

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataEvent オブジェクトのコピーを作成して、各パラメータの値を元のパラメータの値と一致するように設定します。

戻り値
Event — 元のオブジェクトと同じプロパティ値を含む新しい DataChangeEvent オブジェクトです。
toString()メソッド 
public override function toString():String

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataChangeEvent オブジェクトのすべてのプロパティを含んでいるストリングを返します。ストリングは次の形式です。

[ DataChangeEvent type= value changeType= value startIndex= value endIndex= value bubbles= value cancelable= value ]

戻り値
String — DataChangeEvent オブジェクトのすべてのプロパティを含んでいるストリングです。
定数の詳細
DATA_CHANGE定数
public static const DATA_CHANGE:String = "dataChange"

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

type プロパティ (dataChange イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
changeType実行された変更の種類を識別します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
endIndex最後に変更されたアイテムのインデックスを識別します。
items変更されたアイテムをリストする配列。
startIndex最初に変更されたアイテムのインデックスを識別します。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

PRE_DATA_CHANGE定数 
public static const PRE_DATA_CHANGE:String = "preDataChange"

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

type プロパティ (preDataChange イベントオブジェクト) の値を定義します。このイベントオブジェクトは、コンポーネントデータが変更される前に送出されます。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
changeType実行される変更の種類を識別します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
endIndex最後に変更されるアイテムのインデックスを識別します。
items変更対象のアイテムをリストする配列。
startIndex最初に変更されるアイテムのインデックスを識別します。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

例の使用法
DataChangeEventExample.as

この例では、DataProvider によってブロードキャストされる DataChangeEvent を監視し、手動で DataGrid にそのイベントを格納する方法を示します。

例を実行するには、次の手順に従います。

  1. ライブラリに DataGrid および Button コンポーネントを追加します。
  2. このコードを FLA ファイルと同じディレクトリに DataChangeEventExample.as という名前で保存します。
  3. FLA ファイル内の Document クラスを DataChangeEventExample に設定します。
package
{
    import fl.controls.Button;
    import fl.controls.DataGrid;
    import fl.data.DataProvider;
    import fl.events.DataChangeEvent;
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    
    public class DataChangeEventExample extends Sprite
    {
        private var dg:DataGrid;
        private var dp:DataProvider;
        private var names:Array = [ "Mary", "Bob", "Sue", "Joe" ];
        
        public function DataChangeEventExample() {
            dp = new DataProvider();
            dp.addEventListener(DataChangeEvent.DATA_CHANGE,dataChanged);
        
            dg = new DataGrid();
            dg.move(10,45);
            dg.setSize(300,250);
            dg.columns = [ "name", "phone", "email" ];
            addChild(dg);

            var addContactBtn:Button = new Button();
            addContactBtn.label = "Add Contact";
            addContactBtn.move(10,10);
            addContactBtn.addEventListener(MouseEvent.CLICK, addContact);
            addChild(addContactBtn);            
        }
        
        private function getRandomPhone():String {
            return randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+randomDigit();    
        }
        private function randomDigit():String {
            return String(Math.round(Math.random()*10)%10);    
        }
        private function getRandomName():String {
            return names[Math.round(Math.random()*names.length)%names.length];    
        }
        private function addContact(e:MouseEvent):void {
            var randomName:String = getRandomName()
            dp.addItem( { name: randomName, phone: getRandomPhone(), email: randomName + "@fictitious.com" } );
        }
        private function dataChanged(e:DataChangeEvent):void {
            var changedItems:Array = e.items;
            dg.addItem(changedItems[0]);
        }
    }
}




 

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

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/events/DataChangeEvent.html