ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.events 

CollectionEvent  - AS3 Flex

Paketmx.events
Klassepublic class CollectionEvent
VererbungCollectionEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die mx.events.CollectionEvent-Klasse stellt ein Ereignis dar, das ausgelöst wird, wenn die verknüpfte Sammlung geändert wird.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  items : Array
Wenn die Art CollectionEventKind.ADD oder CollectionEventKind.REMOVE entspricht, ist die items-Eigenschaft ein Array hinzugefügter/entfernter Elemente.
CollectionEvent
  kind : String
Gibt die Art des aufgetretenen Ereignisses an.
CollectionEvent
  location : int
Wenn für „kind“ die Einstellungen CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE oder CollectionEventKind.REPLACE verwendet werden, entspricht diese Eigenschaft der auf null basierenden Indexposition in der Sammlung der Elemente, die in der items-Eigenschaft angegeben sind.
CollectionEvent
  oldLocation : int
Wenn für „kind“ die Einstellung CollectionEventKind.MOVE verwendet wird, entspricht diese Eigenschaft der auf null basierenden Indexposition in der Zielsammlung der vorhergehenden Position der Elemente, die in der items-Eigenschaft angegeben sind.
CollectionEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null)
Konstruktor.
CollectionEvent
 Inherited
Dupliziert eine Instanz einer Event-Unterklasse.
Event
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem 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
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  COLLECTION_CHANGE : String = "collectionChange"
[statisch] Die CollectionEvent.COLLECTION_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein Ereignis, das ausgelöst wird, wenn eine Sammlung geändert wird.
CollectionEvent
Eigenschaftendetails

items

Eigenschaft
public var items:Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn für kind die Einstellungen CollectionEventKind.ADD oder CollectionEventKind.REMOVE verwendet werden, ist die items-Eigenschaft ein Array hinzugefügter/entfernter Elemente. Wenn für kind die Einstellungen CollectionEventKind.REPLACE oder CollectionEventKind.UPDATE verwendet werden, ist die items-Eigenschaft ein Array von PropertyChangeEvent-Objekten mit Informationen zu den Elementen, die von diesem Ereignis betroffen sind. Wenn sich ein Wert ändert, fragen Sie die Felder newValue und oldValue des PropertyChangeEvent-Objekts ab, um die neuen und alten Werte festzustellen. Wenn für kind die Einstellungen CollectionEventKind.REFRESH oder CollectionEventKind.RESET verwendet werden, hat dieses Array eine Länge von null.

Der Standardwert ist [ ].

Verwandte API-Elemente

kind

Eigenschaft 
public var kind:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt die Art des aufgetretenen Ereignisses an. Der Eigenschaftswert kann ein Wert der CollectionEventKind-Klasse oder null sein (zeigt an, dass die Art unbekannt ist).

Der Standardwert ist null.

Verwandte API-Elemente

location

Eigenschaft 
public var location:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn für kind die Einstellungen CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE oder CollectionEventKind.REPLACE verwendet werden, entspricht diese Eigenschaft der auf null basierenden Indexposition in der Sammlung der Elemente, die in der items-Eigenschaft angegeben sind.

Der Standardwert ist -1.

Verwandte API-Elemente

oldLocation

Eigenschaft 
public var oldLocation:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn für kind die Einstellung CollectionEventKind.MOVE verwendet wird, entspricht diese Eigenschaft der auf null basierenden Indexposition in der Zielsammlung der vorherigen Position der Elemente, die in der items-Eigenschaft angegeben sind.

Der Standardwert ist -1.

Konstruktordetails

CollectionEvent

()Konstruktor
public function CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Parameter
type:String — Der Ereignistyp; gibt die Aktion an, die das Ereignis ausgelöst hat.
 
bubbles:Boolean (default = false) — Gibt an, ob das Ereignis in der Anzeigelistenhierarchie propagiert werden kann.
 
cancelable:Boolean (default = false) — Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
 
kind:String (default = null) — Gibt die Art des aufgetretenen Ereignisses an. Der Parameterwert kann ein Wert der CollectionEventKind-Klasse oder null sein (zeigt an, dass die Art unbekannt ist).
 
location:int (default = -1) — Wenn für kind die Einstellungen CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE oder CollectionEventKind.REPLACE verwendet werden, gibt dieser Wert die Position der in der items-Eigenschaft angegebenen Elemente in der Zielsammlung an.
 
oldLocation:int (default = -1) — Wenn für kind die Einstellung CollectionEventKind.MOVE verwendet wird, gibt dieser Wert die alte Position in der Zielsammlung der in der items-Eigenschaft angegebenen Elemente an.
 
items:Array (default = null) — Array von Objekten mit Informationen zu den Elementen, die von dem Ereignis betroffen sind, wie in der items-Eigenschaft beschrieben. Wenn für kind die Einstellungen CollectionEventKind.REFRESH oder CollectionEventKind.RESET verwendet werden, hat dieses Array eine Länge von null.
Konstantendetails

COLLECTION_CHANGE

Konstante
public static const COLLECTION_CHANGE:String = "collectionChange"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die CollectionEvent.COLLECTION_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein Ereignis, das ausgelöst wird, wenn eine Sammlung geändert wird.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte. Nicht alle Eigenschaften sind für alle Ereignistypen sinnvoll. Weitere Informationen finden Sie in den ausführlichen Eigenschaftsbeschreibungen.

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
itemsEin Array von Objekten mit Informationen zu den Elementen, die von dem Ereignis betroffen sind. Die Inhalte in diesem Feld hängen von der Art des Ereignisses ab; weitere Informationen finden Sie im Abschnitt zur items-Eigenschaft.
kindDie Art des Ereignisses. Die gültigen Werte werden in der CollectionEventKind-Klasse als Konstanten definiert.
locationPosition in der Zielsammlung der Elemente, die in der items-Eigenschaft angegebenen sind.
oldLocationDie vorherige Position in der Sammlung des Elements, das in der items-Eigenschaft angegebenen ist.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
typeCollectionEvent.COLLECTION_CHANGE





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.