| Paket | mx.collections |
| Klasse | public class AsyncListView |
| Vererbung | AsyncListView  OnDemandEventDispatcher Object |
| Implementiert | IList |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
getItemAt()
removeItemAt(), und toArray() ausgegeben geben.
Die getItemAt()-Methode verarbeitet ItemPendingErrors, indem sie ein vorläufiges „anstehendes“ Objekt zurückgibt, bis die zugrunde liegende Anforderung erfolgreich ausgeführt wurde oder fehlschlägt. Das vorläufige Objekt wird erzeugt, indem die von der createPendingItemFunction-Eigenschaft angegebene Funktion aufgerufen wird. Ist die Anforderung erfolgreich, ersetzt das tatsächliche Objekt das vorläufige. Schlägt sie fehl, wird das vorläufige Objekt durch dasjenige ersetzt, das zurückgegeben wird, wenn die von der createFailedItemFunction-Eigenschaft angegebene Funktion aufgerufen wird.
Diese Klasse delegiert die IList-Methoden und -Eigenschaften an ihre list. Wenn keine Liste angegeben ist, sind Methoden, die die Sammlung ändern, Leerbefehle, und Methoden, die die Sammlung abfragen, geben einen „leeren“ Wert wie z. B. null zurück.
Diese Klasse ist zur Verwendung mit Spark-Komponenten vorgesehen, die auf DataGroup basieren, z. B. List und ComboBox. Die Spark-Klassen stellen keine Unterstützung für die Verarbeitung von ItemPendingError bereit.
AsyncListView unterstützt das erneute Einfügen von ausstehenden oder fehlgeschlagenen Objekten nicht. Wenn ein fehlgeschlagenes oder ausstehendes Objekt entfernt wird, geht seine Verbindung zu einer ausstehenden Datenanforderung verloren. Die Verwendung von Drag & Drop zum Verschieben ausstehender Objekte in einer ASyncListView, die ausstehende oder fehlgeschlagene Objekte enthält, wird nicht unterstützt, da hierdurch Listenobjekte entfernt und erneut eingefügt würden.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:AsyncListView> tag inherits all the attributes of its
superclass, and adds the following attributes:
<mx:AsyncListView
Properties
createFailedItemFunction="null"
createPendingItemFunction="null"
list="null"
/>
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| createFailedItemFunction : Function
Eine für das Erstellen eines Ersetzungsobjekts verwendete Rückruffunktion, wenn eine Anforderung, die zur Ausgabe eines ItemPendingError geführt hat, im Anschluss fehlschlägt. | AsyncListView | ||
| createPendingItemFunction : Function
Eine für das Erstellen eines vorläufigen Objekts verwendete Rückruffunktion, wenn die Erstanforderung zur Ausgabe eines ItemPendingError führt. | AsyncListView | ||
| length : int [schreibgeschützt]
Die Anzahl der Elemente in dieser Sammlung. | AsyncListView | ||
| list : IList
Das IList-Objekt, das von dieser Sammlung eingeschlossen wird. | AsyncListView | ||
| Methode | Definiert von | ||
|---|---|---|---|
AsyncListView(list:IList = null)
Konstruktor. | AsyncListView | ||
| 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. | OnDemandEventDispatcher | |
Fügt das angegebene Element am Ende der Liste hinzu. | AsyncListView | ||
Fügt das Element an der angegebenen Indexposition hinzu. | AsyncListView | ||
|
Sendet ein Ereignis in den Ereignisablauf. | OnDemandEventDispatcher | |
Gibt den Wert von list.getItemAt(index) zurück. | AsyncListView | ||
Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element. | AsyncListView | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | OnDemandEventDispatcher | |
|
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. | AsyncListView | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Entfernt alle Elemente aus der Liste. | AsyncListView | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | OnDemandEventDispatcher | |
Entfernt das tatsächliche oder ausstehende Objekt an der angegebenen Indexposition und gibt es zurück. | AsyncListView | ||
Platziert das Element am angegebenen Index. | AsyncListView | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
Gibt ein Array mit denselben Elementen wie diese AsyncListView zurück. | AsyncListView | ||
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
Gibt einen String zurück, der die Länge der Liste und die Anzahl ausstehender Objektanforderungen enthält. | AsyncListView | ||
|
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. | OnDemandEventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| Wird ausgelöst, wenn sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird. | AsyncListView | |||
createFailedItemFunction | Eigenschaft |
createFailedItemFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Eine für das Erstellen eines Ersetzungsobjekts verwendete Rückruffunktion, wenn eine Anforderung, die zur Ausgabe eines ItemPendingError geführt hat, im Anschluss fehlschlägt. Das vorhandene Objekt ist normalerweise ein ausstehendes Objekt, das von der Rückruffunktion erzeugt wird, die von der createPendingItemFunction()-Eigenschaft angegeben wird. Dieses Objekt wird durch das fehlgeschlagene Objekt ersetzt.
Der Wert dieser Eigenschaft muss eine Funktion mit zwei Parametern sein, der Indexposition des angeforderten Objekts sowie dem Informationsobjekt zum Fehler, das von der IResponder fault()-Methode übergeben wird. In den meisten Fällen können Sie den zweiten Parameter ignorieren. Nachstehend wird eine Beispielimplementierung der Rückruffunktion gezeigt:
function createFailedItem(index:int, info:Object):Object
{
return "[" + index + "request failed]";
}
Das Festlegen dieser Eigenschaft wirkt sich nicht auf fehlgeschlagene Objekte aus, die bereits erstellt waren. Das Setzen der Eigenschaft auf null verhindert das Erstellen von fehlgeschlagenen Objekten.
Der Standardwert ist A function that unconditionally returns null..
Implementierung
public function get createFailedItemFunction():Function public function set createFailedItemFunction(value:Function):voidVerwandte API-Elemente
createPendingItemFunction | Eigenschaft |
createPendingItemFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Eine für das Erstellen eines vorläufigen Objekts verwendete Rückruffunktion, wenn die Erstanforderung zur Ausgabe eines ItemPendingError führt. Wenn die Anforderung schließlich erfüllt wird, wird das vorläufige Objekt automatisch durch das tatsächliche Objekt ersetzt. Schlägt die Anforderung fehl, wird das Objekt durch ein Objekt ersetzt, das mit der von der createFailedItemFunction-Eigenschaft angegebenen Rückruffunktion erstellt wird.
Der Wert dieser Eigenschaft muss eine Funktion mit zwei Parametern sein, der Indexposition des angeforderten Datenprovider-Objekts sowie dem ItemPendingError selbst. In den meisten Fällen kann der zweite Parameter ignoriert werden. Das nachstehende Beispiel zeigt eine Implementierung der Rückruffunktion:
function createPendingItem(index:int, ipe:ItemPendingError):Object
{
return "[" + index + "request is pending...]";
}
Das Festlegen dieser Eigenschaft wirkt sich nicht auf vorläufige „ausstehende“ Objekte aus, die bereits erstellt waren. Das Setzen der Eigenschaft auf null verhindert das Erstellen von vorläufigen „ausstehenden“ Objekten.
Der Standardwert ist A function that unconditionally returns null..
Implementierung
public function get createPendingItemFunction():Function public function set createPendingItemFunction(value:Function):voidVerwandte API-Elemente
length | Eigenschaft |
length:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Anzahl der Elemente in dieser Sammlung. 0 bedeutet keine Elemente, -1 bedeutet, dass die Länge unbekannt ist.
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():intlist | Eigenschaft |
list:IList| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das IList-Objekt, das von dieser Sammlung eingeschlossen wird. D. h. das Objekt, an das alle IList-Methoden delegiert werden.
Ist diese Eigenschaft „null“, sind die IList-Mutationsmethoden wie z. B. setItemAt() Leerbefehle. Die IList-Abfragemethoden, z. B. getItemAt(), geben entsprechend null zurück (-1 für getItemIndex()).
Der Standardwert ist null.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das listChanged -Ereignis ausgelöst.
Implementierung
public function get list():IList public function set list(value:IList):voidAsyncListView | () | Konstruktor |
addItem | () | Methode |
addItemAt | () | Methode |
public function addItemAt(item:Object, index:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt das Element an der angegebenen Indexposition hinzu. Der Index eines Elements, der größer als der Index des hinzugefügten Element ist, wird um 1 erhöht. Wenn der angegebene Index kleiner als 0 oder größer als die Länge der Liste ist, wird ein RangeError ausgegeben.
Parameter
item:Object — Das Element, das an die Indexposition platziert werden soll.
| |
index:int — Die Indexposition, an der das Element platziert werden soll.
|
getItemAt | () | Methode |
public function getItemAt(index:int, prefetch:int = 0):Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt den Wert von list.getItemAt(index) zurück.
Diese Methode erfasst die als Folge des Aufrufs von getItemAt() generierten ItemPendingErrors (IPEs). Wenn ein IPE ausgegeben wird, wird dem IPE ein IResponder hinzugefügt und es wird ein mit createPendingItemFunction erstelltes vorläufiges „ausstehendes“ Objekt zurückgegeben. Wenn die zugrunde liegende Anforderung schließlich erfüllt wird, wird das „ausstehende“ Objekt durch das tatsächliche Objekt ersetzt. Schlägt sie fehl, wird das „ausstehende“ Objekt durch einen von der createFailedItemFunction erzeugten Wert ersetzt.
Parameter
index:int — Die Listenindexposition, von der das Objekt abgerufen werden soll.
| |
prefetch:int (default = 0)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.
|
Object — Das Listenelement an der angegebenen Indexposition.
|
Auslöser
RangeError — Wenn index < 0 oder index >= length.
|
Verwandte API-Elemente
getItemIndex | () | Methode |
public function getItemIndex(item:Object):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.
Hinweis: Im Unterschied zu IViewCursor.findxxx()-Methoden kann die getItemIndex()-Methode keine Parameter mit einer Untergruppe der Felder im gesuchten Element verwenden. Diese Methode sucht immer nach einem Element, das genau dem Eingabeparameter entspricht.
Parameter
item:Object — Das zu suchende Element.
|
int — Der Index des Elements oder -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 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Informiert die Ansicht darüber, dass ein Element aktualisiert wurde. Dies ist nützlich, wenn der Inhalt der Ansicht IEventDispatcher nicht implementiert und ein PropertyChangeEvent auslöst. 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) |
removeAll | () | Methode |
public function removeAll():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt alle Elemente aus der Liste.
Wenn ein Element nicht lokal ist und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.
Weitere Informationen zur Verwendung von ItemPendingError finden Sie in der ItemPendingError-Dokumentation und der Dokumentation zu den Sammlungen.
removeItemAt | () | Methode |
public function removeItemAt(index:int):Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt das tatsächliche oder ausstehende Objekt an der angegebenen Indexposition und gibt es zurück. Die Indexposition aller Objekte, deren Indexposition höher als die angegebene Indexposition ist, wird um 1 vermindert.
Wenn an der angegebenen Indexposition kein tatsächliches oder ausstehendes Objekt vorhanden ist, zum Beispiel, weil ein Aufruf von getItemAt(index) nicht zum Paging der Daten geführt hat, gibt die zugrunde liegende list eventuell einen ItemPendingError aus. Die Implementierung ignoriert den ItemPendingError und gibt null zurück.
Parameter
index:int — Die Listenindexposition, von der das Objekt abgerufen werden soll.
|
Object — Das Objekt, das entfernt wurde oder den Wert null hat.
|
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 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Platziert das Element am angegebenen Index. Wenn sich bereits ein Element an diesem Index befand, wird es vom neuen Element ersetzt und zurückgegeben.
Parameter
item:Object — Das neue Element, das am angegebenen Index platziert werden soll.
| |
index:int — Die Indexposition, an der das Element platziert werden soll.
|
Object — Das Element, das ersetzt wurde, oder null, wenn keines ersetzt wurde.
|
toArray | () | Methode |
public function toArray():Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt ein Array mit denselben Elementen wie diese AsyncListView zurück. Das Array wird durch Abrufen der einzelnen Objekte mit getItemAt() initialisiert, sodass ausstehende Objekte ersetzt werden, wenn noch keine tatsächlichen Werte verfügbar sind. Das Array wird nicht aktualisiert, wenn die ASyncListView die ausstehenden Objekte durch tatsächliche (oder fehlgeschlagene) Werte ersetzt.
Array — Ein Array mit denselben Elementen wie diese AsyncListView.
|
toString | () | Methode |
public function toString():String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt einen String zurück, der die Länge der Liste und die Anzahl ausstehender Objektanforderungen enthält. Es werden keine ausstehenden Anforderungen ausgelöst.
RückgabewerteString — Eine kurze Beschreibung der Liste.
|
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 sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird.
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