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-SyntaxMXML-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):void
Verwandte 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):void
Verwandte 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():int
list | 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):void
AsyncListView | () | 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 ) — 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.
|
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 ) — Der Name der Eigenschaft, die aktualisiert wurde.
| |
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.)
|
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.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 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