ArrayList

Paket	mx.collections
Klasse	public class ArrayList
Vererbung	ArrayList EventDispatcher 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

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : 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

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert 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
		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
		addItem(item:Object):void 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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getItemAt(index:int, prefetch:int = 0):Object Ruft das Element an der angegebenen Indexposition ab.	ArrayList
		getItemIndex(item:Object):int Gibt die Indexposition des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.	ArrayList
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean 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
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeAll():void Entfernt alle Elemente aus der Liste.	ArrayList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeItem(item:Object):Boolean Entfernt das angegebene Element aus der Liste, falls vorhanden.	ArrayList
		removeItemAt(index:int):Object 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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toArray():Array Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.	ArrayList
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt den Inhalt dieser ArrayList in einem String aus und gibt ihn zurück.	ArrayList
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Ü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

	Methode		Definiert von
		itemUpdateHandler(event:PropertyChangeEvent):void Wird aufgerufen, wenn eines der in der Liste enthaltenen Elemente ein ObjectChange-Ereignis auslöst.	ArrayList
		startTrackUpdates(item:Object):void Wenn das Element ein IEventDispatcher ist, überwachen Sie es auf Aktualisierungen.	ArrayList
		stopTrackUpdates(item:Object):void Wenn es sich bei dem Element um einen IEventDispatcher handelt, unterbrechen Sie das Überwachen auf Aktualisierungen.	ArrayList

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
collectionChange	Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde.	ArrayList
deactivate	[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

()

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

mx.events.CollectionEvent
mx.core.IPropertyChangeNotifier
mx.events.PropertyChangeEvent

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.

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das 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.
`items`	Ein 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.
`kind`	Die Art des Ereignisses. Die gültigen Werte werden in der CollectionEventKind-Klasse als Konstanten definiert.
`location`	Position in der Zielsammlung der Elemente, die in der `items`-Eigenschaft angegebenen sind.
`oldLocation`	Die vorherige Position in der Sammlung des Elements, das in der `items`-Eigenschaft angegebenen ist.
`target`	Das 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.
`type`	CollectionEvent.COLLECTION_CHANGE

Rechtliche Hinweise | Onlinedatenschutzerklärung

ArrayList - AS3 Flex

Klassen x

length

source

uid

ArrayList

addAll

addAllAt

addItem

addItemAt

getItemAt

getItemIndex

itemUpdated

itemUpdateHandler

removeAll

removeItem

removeItemAt

setItemAt

startTrackUpdates

stopTrackUpdates

toArray

toString

collectionChange