AsyncListView

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

Die AsyncListView-Klasse ist eine Implementierung der IList-Schnittstelle, die ItemPendingErrors-Fehler verarbeitet, die von den Methoden 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 expanded

MXML-Syntax ausblenden

The <mx:AsyncListView> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:AsyncListView
  Properties
    createFailedItemFunction="null"
    createPendingItemFunction="null"
    list="null"
  />

Ö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
		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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	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
		addItem(item:Object):void Fügt das angegebene Element am Ende der Liste hinzu.	AsyncListView
		addItemAt(item:Object, index:int):void Fügt das Element an der angegebenen Indexposition hinzu.	AsyncListView
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	OnDemandEventDispatcher
		getItemAt(index:int, prefetch:int = 0):Object Gibt den Wert von list.getItemAt(index) zurück.	AsyncListView
		getItemIndex(item:Object):int Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.	AsyncListView
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	OnDemandEventDispatcher
		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.	AsyncListView
		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.	AsyncListView
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	OnDemandEventDispatcher
		removeItemAt(index:int):Object Entfernt das tatsächliche oder ausstehende Objekt an der angegebenen Indexposition und gibt es zurück.	AsyncListView
		setItemAt(item:Object, index:int):Object Platziert das Element am angegebenen Index.	AsyncListView
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toArray():Array Gibt ein Array mit denselben Elementen wie diese AsyncListView zurück.	AsyncListView
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt einen String zurück, der die Länge der Liste und die Anzahl ausstehender Objektanforderungen enthält.	AsyncListView
		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.	OnDemandEventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Ereignis		Übersicht	Definiert von
		collectionChange	Wird ausgelöst, wenn sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird.	AsyncListView

Eigenschaftendetails

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

getItemAt()
createPendingItemFunction
mx.rpc.IResponder.fault

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

getItemAt()
createFailedItemFunction
mx.collections.errors.ItemPendingError

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

Konstruktordetails

()

Konstruktor

public function AsyncListView(list:IList = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Parameter

list:IList (default = null) — Der Anfangswert der Listeneigenschaft, die IList, an die delegiert wird.

Methodendetails

addItem

()

Methode

public function addItem(item:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

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

Rückgabewerte

Object — Das Listenelement an der angegebenen Indexposition.

Auslöser

RangeError — Wenn index < 0 oder index >= length.

Verwandte API-Elemente

createPendingItemFunction
createFailedItemFunction
mx.collections.errors.ItemPendingError
mx.rpc.IResponder

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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ückgabewerte

String — Eine kurze Beschreibung der Liste.

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 sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird.

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

AsyncListView - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.collections

createFailedItemFunction

createPendingItemFunction

length

list

AsyncListView

addItem

addItemAt

getItemAt

getItemIndex

itemUpdated

removeAll

removeItemAt

setItemAt

toArray

toString

collectionChange