Paketfl.events
Klassepublic class DataChangeEvent
VererbungDataChangeEvent Inheritance Event Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Die DataChangeEvent-Klasse definiert das Ereignis, das ausgelöst wird, wenn die mit einer Komponenten verknüpften Daten geändert werden. Dieses Ereignis wird von den Komponenten List, DataGrid, TileList und ComboBox verwendet.

Diese Klasse bietet das folgende Ereignis:

Beispiele anzeigen

Siehe auch

DataChangeType


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[read-only] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[read-only] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
  changeType : String
[read-only] Ruft die Art der Änderung ab, die das Ereignis ausgelöst hat.
DataChangeEvent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[read-only] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
  endIndex : uint
[read-only] Ruft die Indexposition des letzten geänderten Elements in dem Array mit geänderten Elementen ab.
DataChangeEvent
 InheritedeventPhase : uint
[read-only] Die aktuelle Phase im Ereignisablauf.
Event
  items : Array
[read-only] Ruft ein Array ab, das die geänderten Elemente enthält.
DataChangeEvent
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  startIndex : uint
[read-only] Ruft die Indexposition des ersten geänderten Elements in dem Array mit geänderten Elementen ab.
DataChangeEvent
 Inheritedtarget : Object
[read-only] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[read-only] Der Typ des Ereignisses.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
Erstellt ein neues DataChangeEvent-Objekt mit den angegebenen Parametern.
DataChangeEvent
  
Erstellt eine Kopie des DataEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.
DataChangeEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion, mit der die toString()-Methode in Ihrer benutzerdefinierten Event-Klasse implementiert wird.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob "preventDefault()" im Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
  
Gibt einen String zurück, der alle Eigenschaften des DataChangeEvent-Objekts enthält.
DataChangeEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
 InheritedACTIVATE : String = "activate"
[static] Definiert den Wert der Eigenschaft "type" eines activate-Ereignisobjekts.
Event
 InheritedADDED : String = "added"
[static] Definiert den Wert der Eigenschaft "type" eines added-Ereignisobjekts.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Definiert den Wert der Eigenschaft "type" eines addedToStage-Ereignisobjekts.
Event
 InheritedCANCEL : String = "cancel"
[static] Definiert den Wert der Eigenschaft type eines cancel-Ereignisobjekts.
Event
 InheritedCHANGE : String = "change"
[static] Definiert den Wert der Eigenschaft "type" eines change-Ereignisobjekts.
Event
 InheritedCLOSE : String = "close"
[static] Definiert den Wert der Eigenschaft "type" eines close-Ereignisobjekts.
Event
 InheritedCOMPLETE : String = "complete"
[static] Definiert den Wert der Eigenschaft "type" eines complete-Ereignisobjekts.
Event
 InheritedCONNECT : String = "connect"
[static] Definiert den Wert der Eigenschaft "type" eines connect-Ereignisobjekts.
Event
  DATA_CHANGE : String = "dataChange"
[static] Definiert den Wert der Eigenschaft "type" eines dataChange-Ereignisobjekts.
DataChangeEvent
 InheritedDEACTIVATE : String = "deactivate"
[static] Definiert den Wert der Eigenschaft "type" eines deactivate-Ereignisobjekts.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Definiert den Wert der Eigenschaft "type" eines enterFrame-Ereignisobjekts.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Definiert den Wert der Eigenschaft "type" eines fullScreen-Ereignisobjekts.
Event
 InheritedID3 : String = "id3"
[static] Definiert den Wert der Eigenschaft "type" eines id3-Ereignisobjekts.
Event
 InheritedINIT : String = "init"
[static] Definiert den Wert der Eigenschaft "type" eines init-Ereignisobjekts.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Definiert den Wert der Eigenschaft "type" eines mouseLeave-Ereignisobjekts.
Event
 InheritedOPEN : String = "open"
[static] Definiert den Wert der Eigenschaft "type" eines open-Ereignisobjekts.
Event
  PRE_DATA_CHANGE : String = "preDataChange"
[static] Definiert den Wert der Eigenschaft "type" eines preDataChange-Ereignisobjekts.
DataChangeEvent
 InheritedREMOVED : String = "removed"
[static] Definiert den Wert der Eigenschaft type eines removed-Ereignisobjekts.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Definiert den Wert der Eigenschaft "type" eines removedFromStage-Ereignisobjekts.
Event
 InheritedRENDER : String = "render"
[static] Definiert den Wert der Eigenschaft "type" eines render-Ereignisobjekts.
Event
 InheritedRESIZE : String = "resize"
[static] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.
Event
 InheritedSCROLL : String = "scroll"
[static] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
Event
 InheritedSELECT : String = "select"
[static] Definiert den Wert der Eigenschaft type eines select-Ereignisobjekts.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Definiert den Wert der Eigenschaft "type" eines soundComplete-Ereignisobjekts.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabChildrenChange-Ereignisobjekts.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Definiert den Wert der Eigenschaft type eines tabEnabledChange-Ereignisobjekts.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabIndexChange-Ereignisobjekts.
Event
 InheritedUNLOAD : String = "unload"
[static] Definiert den Wert der Eigenschaft "type" eines unload-Ereignisobjekts.
Event
Eigenschaftsdetail
changeTypeEigenschaft
changeType:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Art der Änderung ab, die das Ereignis ausgelöst hat. Die DataChangeType-Klasse definiert die möglichen Werte für diese Eigenschaft.


Implementierung
    public function get changeType():String

Siehe auch

endIndexEigenschaft 
endIndex:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Indexposition des letzten geänderten Elements in dem Array mit geänderten Elementen ab.


Implementierung
    public function get endIndex():uint

Siehe auch

itemsEigenschaft 
items:Array  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft ein Array ab, das die geänderten Elemente enthält.


Implementierung
    public function get items():Array
startIndexEigenschaft 
startIndex:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Indexposition des ersten geänderten Elements in dem Array mit geänderten Elementen ab.


Implementierung
    public function get startIndex():uint

Siehe auch

Konstruktordetail
DataChangeEvent()Konstruktor
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Erstellt ein neues DataChangeEvent-Objekt mit den angegebenen Parametern.

Parameter
eventType:String — Die Art des Änderungsereignisses.
 
changeType:String — Die Art der vorgenommenen Änderung. Die DataChangeType-Klasse definiert die möglichen Werte für diesen Parameter.
 
items:Array — Eine Liste der geänderten Elemente.
 
startIndex:int (default = -1) — Die Indexposition des ersten geänderten Elements.
 
endIndex:int (default = -1) — Die Indexposition des letzten geänderten Elements.
Methodendetail
clone()Methode
public override function clone():Event

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Erstellt eine Kopie des DataEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.

Rückgabewerte
Event — Ein neues DataChangeEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
toString()Methode 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Gibt einen String zurück, der alle Eigenschaften des DataChangeEvent-Objekts enthält. Der String liegt im folgenden Format vor:

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

Rückgabewerte
String — Ein String, der alle Eigenschaften des DataChangeEvent-Objekts enthält.
Konstantendetail
DATA_CHANGEKonstante
public static const DATA_CHANGE:String = "dataChange"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Definiert den Wert der Eigenschaft type eines dataChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
changeTypeGibt die Art der vorgenommenen Änderung an.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
endIndexGibt die Indexposition des letzten geänderten Elements an.
itemsEin Array, das die geänderten Elemente enthält.
startIndexGibt die Indexposition des ersten geänderten Elements an.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Siehe auch

PRE_DATA_CHANGEKonstante 
public static const PRE_DATA_CHANGE:String = "preDataChange"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Definiert den Wert der Eigenschaft type eines preDataChange-Ereignisobjekts. Dieses Ereignisobjekt wird ausgelöst, bevor Änderungen an den Komponentendaten vorgenommen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
changeTypeGibt die Art der vorzunehmenden Änderung an.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
endIndexGibt die Indexposition des letzten zu ändernden Elements an.
itemsEin Array, das die zu ändernden Elemente enthält.
startIndexGibt die Indexposition des ersten zu ändernden Elements an.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Siehe auch

Beispiele Verwendung von Beispielen
DataChangeEventExample.as

In diesem Beispiel wird gezeigt, wie Sie einen Listener für das vom "DataProvider" übermittelte "DataChangeEvent" verwenden und ein DataGrid manuell mit dessen Ereignissen füllen.

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

  1. Fügen Sie die DataGrid- und Button-Komponenten zur Bibliothek hinzu.
  2. Speichern Sie diesen Code unter DataChangeEventExample.as im gleichen Verzeichnis wie die FLA-Datei.
  3. Legen Sie in der FLA-Datei als Dokumentklasse den Wert "DataChangeEventExample" fest.
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]);
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/fl/events/DataChangeEvent.html