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.collections 

ArrayList  - AS3 Flex

Paketmx.collections
Klassepublic class ArrayList
VererbungArrayList Inheritance EventDispatcher Inheritance Object
Implementiert IList, IExternalizable, IPropertyChangeNotifier
Unterklassen Conflicts

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die ArrayList-Klasse ist eine einfache Implementierung der IList, die ein zugrunde liegendes Array als Datenquelle verwendet. Auf die Elemente im zugrunde liegenden Array kann zugegriffen werden und sie können bearbeitet werden, indem Sie die Methoden und Eigenschaften der IList-Schnittstelle verwenden. Vorgänge an einer ArrayList-Instanz ändern die Datenquelle. Wenn Sie z. B. die removeItemAt()-Methode auf eine ArrayList anwenden, entfernen Sie das Element aus dem zugrunde liegenden Array. Diese Basisklasse gibt keine ItemPendingErrors aus, eine Unterklasse kann jedoch welche ausgeben.
  <mx:ArrayList
  Properties
  source="null"
  />
  

Standard-MXML-Eigenschaftsource



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  length : int
[schreibgeschützt] Ruft die Anzahl der Elemente in der Liste ab.
ArrayList
  source : Array
Das Quellarray für diese ArrayList.
ArrayList
  uid : String
Bietet Zugriff auf die eindeutige ID für diese Liste.
ArrayList
Öffentliche Methoden
 MethodeDefiniert von
  
ArrayList(source:Array = null)
Erstellt eine neue ArrayList, indem das angegebene Array als zugehörige Quelle verwendet wird.
ArrayList
  
addAll(addList:IList):void
Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden.
ArrayList
  
addAllAt(addList:IList, index:int):void
Fügt der aktuellen Liste eine Liste von Elementen hinzu. Sie werden an dem Positionsindex eingefügt, der an die Funktion übergeben wurde.
ArrayList
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
Fügt das angegebene Element am Ende der Liste hinzu.
ArrayList
  
addItemAt(item:Object, index:int):void
Fügt das Element an der angegebenen Indexposition hinzu.
ArrayList
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
getItemAt(index:int, prefetch:int = 0):Object
Ruft das Element an der angegebenen Indexposition ab.
ArrayList
  
Gibt die Indexposition des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.
ArrayList
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void
Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.
ArrayList
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Entfernt alle Elemente aus der Liste.
ArrayList
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Entfernt das angegebene Element aus der Liste, falls vorhanden.
ArrayList
  
Entfernt das Element an der angegebenen Indexposition und gibt es zurück.
ArrayList
  
setItemAt(item:Object, index:int):Object
Platziert das Element an der angegebenen Indexposition.
ArrayList
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.
ArrayList
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt den Inhalt dieser ArrayList in einem String aus und gibt ihn zurück.
ArrayList
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
  
Wird aufgerufen, wenn eines der in der Liste enthaltenen Elemente ein ObjectChange-Ereignis auslöst.
ArrayList
  
Wenn das Element ein IEventDispatcher ist, überwachen Sie es auf Aktualisierungen.
ArrayList
  
Wenn es sich bei dem Element um einen IEventDispatcher handelt, unterbrechen Sie das Überwachen auf Aktualisierungen.
ArrayList
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
  Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde.ArrayList
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

length

Eigenschaft
length:int  [schreibgeschützt]

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

Ruft die Anzahl der Elemente in der Liste ab. Für eine ArrayList sollte immer eine Länge angegeben sein, sodass nicht -1 zurückgegeben wird. Eine Unterklasse kann dieses Verhalten jedoch überschreiben.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das collectionChange -Ereignis ausgelöst.



Implementierung
    public function get length():int

source

Eigenschaft 
source:Array

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

Das Quellarray für diese ArrayList. Alle Änderungen, die durch die IList-Schnittstelle vorgenommen wurden, werden im Quellarray übernommen. Wenn kein Quellarray angegeben ist, erstellt die ArrayList unmittelbar ein internes Quellarray. Änderungen, die direkt am zugrunde liegenden Array vorgenommen wurden (z. B. Aufrufen der theList.source.pop()-Methode) führen nicht zum Auslösen von CollectionEvents.



Implementierung
    public function get source():Array
    public function set source(value:Array):void

uid

Eigenschaft 
uid:String

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

Bietet Zugriff auf die eindeutige ID für diese Liste.



Implementierung
    public function get uid():String
    public function set uid(value:String):void
Konstruktordetails

ArrayList

()Konstruktor
public function ArrayList(source:Array = null)

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

Erstellt eine neue ArrayList, indem das angegebene Array als zugehörige Quelle verwendet wird. Wenn keine Quelle angegeben ist, wird ein leeres Array verwendet.

Parameter
source:Array (default = null) — Das als Quelle für die ArrayList zu verwendende Array.
Methodendetails

addAll

()Methode
public function addAll(addList:IList):void

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

Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden.

Parameter

addList:IList — Die Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen.

addAllAt

()Methode 
public function addAllAt(addList:IList, index:int):void

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

Fügt der aktuellen Liste eine Liste von Elementen hinzu. Sie werden an dem Positionsindex eingefügt, der an die Funktion übergeben wurde. Die Elemente werden in der Reihenfolge an die Indexposition platziert, in der sie empfangen werden.

Parameter

addList:IList — Die Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen.
 
index:int — Die Position der aktuellen Liste, an die die neuen Elemente platziert werden sollen.

addItem

()Methode 
public function addItem(item:Object):void

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

Fügt das angegebene Element am Ende der Liste hinzu. Entspricht addItemAt(item, length);

Parameter

item:Object — das hinzuzufügende Element

addItemAt

()Methode 
public function addItemAt(item:Object, index:int):void

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

Fügt das Element an der angegebenen Indexposition hinzu. Alle nach dieser Indexposition platzierten Elemente werden um eine Stelle verschoben.

Parameter

item:Object — Das Element, das an die Indexposition platziert werden soll.
 
index:int — Die Indexposition, an der das Element platziert werden soll.


Auslöser
RangeError — Wenn die Indexposition kleiner als 0 oder größer als die Länge ist.

getItemAt

()Methode 
public function getItemAt(index:int, prefetch:int = 0):Object

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

Ruft das Element an der angegebenen Indexposition ab.

Parameter

index:int — Die Indexposition in der Liste, aus der das Element abgerufen werden soll.
 
prefetch:int (default = 0) — Ein int-Wert, der sowohl die Richtung als auch die Anzahl von Elementen angibt, die während der Anforderung abgerufen werden sollen, wenn das Element nicht lokal ist.

Rückgabewerte
Object — Das Element an dieser Indexposition; null, wenn keines vorhanden ist.

Auslöser
Error — Wenn die Daten für diesen Index von einem Remote-Speicherort geladen werden müssen
 
RangeError — Wenn Indexposition < 0 oder Indexposition >= Länge.

getItemIndex

()Methode 
public function getItemIndex(item:Object):int

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

Gibt die Indexposition des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element. Beachten Sie, dass in dieser Implementierung die Suche linear und daher O(n) ist.

Parameter

item:Object — das zu suchende Element

Rückgabewerte
int — Die Indexposition des Elements; -1, wenn das Element nicht in der Liste enthalten ist.

itemUpdated

()Methode 
public function itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void

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

Informiert die Ansicht darüber, dass ein Element aktualisiert wurde. Dies ist hilfreich, wenn der Inhalt der Ansicht den IEventDispatcher nicht implementiert. Wenn eine Eigenschaft angegeben wird, kann die Ansicht möglicherweise ihre Benachrichtigungsfunktion optimieren. Andernfalls wird möglicherweise einfach die gesamte Ansicht aktualisiert.

Parameter

item:Object — Das Element in der Ansicht, die aktualisiert wurde.
 
property:Object (default = null) — Ein String, QName oder int-Wert für die Angabe der aktualisierten Eigenschaft.
 
oldValue:Object (default = null) — Der alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.)
 
newValue:Object (default = null) — Der neue Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, muss der Wert nicht angegeben werden, da davon ausgegangen wird, dass das Element den neuen Wert hat.)

Verwandte API-Elemente

itemUpdateHandler

()Methode 
protected function itemUpdateHandler(event:PropertyChangeEvent):void

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

Wird aufgerufen, wenn eines der in der Liste enthaltenen Elemente ein ObjectChange-Ereignis auslöst. Schließt es in ein CollectionEventKind.UPDATE-Objekt ein.

Parameter

event:PropertyChangeEvent — Das Ereignisobjekt für das ObjectChange-Ereignis.

removeAll

()Methode 
public function removeAll():void

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

Entfernt alle Elemente aus der Liste.

removeItem

()Methode 
public function removeItem(item:Object):Boolean

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

Entfernt das angegebene Element aus der Liste, falls vorhanden.

Parameter

item:Object — Objektverweis auf das Element, das entfernt werden soll.

Rückgabewerte
Boolean — Boolescher Wert, der angibt, ob das Element entfernt wurde.

removeItemAt

()Methode 
public function removeItemAt(index:int):Object

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

Entfernt das Element an der angegebenen Indexposition und gibt es zurück. Alle Elemente, die sich nach diesem Index befanden, sind nun um eine Indexposition weiter vorne.

Parameter

index:int — Die Indexposition, an der das Element entfernt werden soll.

Rückgabewerte
Object — Das entfernte Element.

Auslöser
RangeError — Wenn index < 0 oder index >= length.

setItemAt

()Methode 
public function setItemAt(item:Object, index:int):Object

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

Platziert das Element an der angegebenen Indexposition. Wenn sich bereits ein Element an diesem Index befand, wird es vom neuen Element ersetzt und zurückgegeben.

Parameter

item:Object — der neue Wert der Indexposition
 
index:int — Die Indexposition, an der das Element platziert werden soll.

Rückgabewerte
Object — Das Element, das ersetzt wurde; null, wenn keines ersetzt wurde.

Auslöser
RangeError — Wenn die Indexposition kleiner als 0 oder größer als oder gleich die Länge ist.

startTrackUpdates

()Methode 
protected function startTrackUpdates(item:Object):void

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

Wenn das Element ein IEventDispatcher ist, überwachen Sie es auf Aktualisierungen. Diese Methode wird von der addItemAt()-Methode aufgerufen und wenn die Quelle anfänglich zugewiesen wird.

Parameter

item:Object — Das an die addItemAt()-Methode übergebene Element.

stopTrackUpdates

()Methode 
protected function stopTrackUpdates(item:Object):void

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

Wenn es sich bei dem Element um einen IEventDispatcher handelt, unterbrechen Sie das Überwachen auf Aktualisierungen. Diese Methode wird von der removeItemAt()- und removeAll()-Methode aufgerufen und bevor eine neue Quelle zugewiesen wird.

Parameter

item:Object — Das an die removeItemAt()-Methode übergebene Element.

toArray

()Methode 
public function toArray():Array

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

Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.

Rückgabewerte
Array — Ein Array, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.

Auslöser
Error — Wenn die Daten noch nicht vollständig von einem Remote-Speicherort geladen wurden.

toString

()Methode 
override public function toString():String

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

Gibt den Inhalt dieser ArrayList in einem String aus und gibt ihn zurück.

Rückgabewerte
String — Ein String, der die Inhalte der ArrayList beinhaltet.
Ereignisdetails

collectionChange

Ereignis
Ereignisobjekttyp: mx.events.CollectionEvent
Eigenschaft CollectionEvent.type = mx.events.CollectionEvent.COLLECTION_CHANGE

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

Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde.

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.