| 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 |
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
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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt eine neue ArrayList, indem das angegebene Array als zugehörige Quelle verwendet wird. | ArrayList | ||
Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden. | ArrayList | ||
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 | |
Fügt das angegebene Element am Ende der Liste hinzu. | ArrayList | ||
Fügt das Element an der angegebenen Indexposition hinzu. | ArrayList | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
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 | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
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 | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Entfernt alle Elemente aus der Liste. | ArrayList | ||
|
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 | ||
Platziert das Element an der angegebenen Indexposition. | ArrayList | ||
|
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 | ||
|
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 | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Methode | Definiert 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 | ||
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [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 | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
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():intsource | 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):voiduid | Eigenschaft |
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.
Parametersource:Array (default = null) |
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 |
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) |
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
|
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) | |
oldValue:Object (default = null) | |
newValue:Object (default = null) |
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.
|
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.
|
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.
|
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ückgabewerteArray — 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 |
collectionChange | Ereignis |
mx.events.CollectionEventEigenschaft 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 dertype-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 |
Tue Jun 12 2018, 10:04 AM Z