ListCollectionView

Paket	mx.collections
Klasse	public class ListCollectionView
Vererbung	ListCollectionView Proxy
Implementiert	ICollectionView, IList, IMXMLObject
Unterklassen	ArrayCollection, XMLListCollection

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die ListCollectionView-Klasse fügt die Eigenschaften und Methoden der ICollectionView-Schnittstelle einem Objekt hinzu, das mit der IList-Schnittstelle kompatibel ist. Als Ergebnis können Sie ein Objekt dieser Klasse an alle Objekte übergeben, die eine IList- oder ICollectionView-Schnittstelle erfordern.

Bei dieser Klasse können Sie auch die Arrayschreibweise [] verwenden, um auf die getItemAt()- und setItemAt()-Methode zuzugreifen. Wenn Sie Code wie myListCollectionView[Index] verwenden, ruft Flex die setItemAt()- oder getItemAt()-Methode des myListCollectionView-Objekts auf.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <mx:ListCollectionView> has the following attributes, which all of its subclasses inherit:

  <mx:ListCollectionView
  Properties
  filterFunction="null"
  list="null"
  sort="null"
  Events
  collectionChange="No default"
  />

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		filterFunction : Function Eine Funktion, die von der Ansicht verwendet wird, um Elemente zu entfernen, die die Funktionskriterien nicht erfüllen.	ListCollectionView
		length : int [schreibgeschützt] Die Anzahl der Elemente in dieser Ansicht.	ListCollectionView
		list : IList Die IList, die diese Sammlung einschließt.	ListCollectionView
		sort : ISort Das ISort-Objekt, das auf die ICollectionView angewendet wird.	ListCollectionView

Geschützte Eigenschaften

	Eigenschaft		Definiert von
		localIndex : Array Wenn die Ansicht sortiert oder gefiltert wird, enthält die localIndex-Eigenschaft ein Array von Elementen in der sortierten bzw. gefilterten (angeordneten, reduzierten) Ansicht und in der sortierten Reihenfolge.	ListCollectionView

Öffentliche Methoden

	Methode		Definiert von
		ListCollectionView(list:IList = null) Der ListCollectionView-Konstruktor.	ListCollectionView
		addAll(addList:IList):void Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden.	ListCollectionView
		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.	ListCollectionView
		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.	ListCollectionView
		addItem(item:Object):void Fügt das angegebene Element am Ende der Liste hinzu.	ListCollectionView
		addItemAt(item:Object, index:int):void Fügt das Element an der angegebenen Indexposition hinzu.	ListCollectionView
		contains(item:Object):Boolean Gibt zurück, ob die Ansicht das angegebene Objekt enthält.	ListCollectionView
		createCursor():IViewCursor Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird.	ListCollectionView
		disableAutoUpdate():void Verhindert, dass Änderungen der Sammlung selbst und Elemente aus der Sammlung von der Ansicht verteilt werden.	ListCollectionView
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	ListCollectionView
		enableAutoUpdate():void Aktiviert die automatische Aktualisierung.	ListCollectionView
		getItemAt(index:int, prefetch:int = 0):Object Ruft das Element am angegebenen Index ab.	ListCollectionView
		getItemIndex(item:Object):int Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.	ListCollectionView
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	ListCollectionView
		initialized(document:Object, id:String):void Wird automatisch vom MXML-Compiler aufgerufen, wenn die ListCollectionView mithilfe eines MXML-Tags erstellt wird.	ListCollectionView
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.	ListCollectionView
		refresh():Boolean Wendet die Sortierung und den Filter auf die Ansicht an.	ListCollectionView
		removeAll():void Entfernt alle Elemente aus der Liste.	ListCollectionView
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	ListCollectionView
		removeItemAt(index:int):Object Entfernt das Element am angegebenen Index und gibt es zurück.	ListCollectionView
		setItemAt(item:Object, index:int):Object Platziert das Element am angegebenen Index.	ListCollectionView
		toArray():Array Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.	ListCollectionView
		toString():String Gibt den Inhalt dieser Ansicht als String aus und gibt ihn zurück.	ListCollectionView
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner übergeordneten Objekte ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	ListCollectionView

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Ereignis		Übersicht	Definiert von
		collectionChange	Wird ausgelöst, wenn ICollectionView auf irgendeine Weise aktualisiert wurde.	ListCollectionView

Eigenschaftendetails

filterFunction

Eigenschaft

filterFunction:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Funktion, die von der Ansicht verwendet wird, um Elemente zu entfernen, die die Funktionskriterien nicht erfüllen. Eine filterFunction muss folgende Signatur haben:

f(item:Object):Boolean

Dabei ist der Rückgabewert true, wenn das angegebene Element in der Ansicht beibehalten werden soll.

Wenn ein Filter nicht unterstützt wird, gibt Flex einen Fehler aus, wenn auf diese Eigenschaft zugegriffen wird. Sie müssen refresh() aufrufen, nachdem Sie die filterFunction-Eigenschaft zum Aktualisieren der Ansicht eingerichtet haben.

Hinweis: Die Flex-Implementierungen der ICollectionView rufen alle Elemente von einer Remote-Position ab, bevor die Filterfunktion ausgeführt wird. Wenn Sie Paging verwenden, wenden Sie den Filter auf die Remote-Sammlung an, bevor Sie die Daten abrufen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das filterFunctionChanged -Ereignis ausgelöst.

Implementierung
public function get filterFunction():Function
public function set filterFunction(value:Function):void

Verwandte API-Elemente

aktualisieren()

length

Eigenschaft

length:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Anzahl der Elemente in dieser Ansicht. 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 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die IList, die diese Sammlung einschließt.

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

localIndex

Eigenschaft

protected var localIndex:Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wenn die Ansicht sortiert oder gefiltert wird, enthält die localIndex-Eigenschaft ein Array von Elementen in der sortierten bzw. gefilterten (angeordneten, reduzierten) Ansicht und in der sortierten Reihenfolge. Die ListCollectionView-Klasse verwendet dann diese Eigenschaft, um auf die Elemente in der Ansicht zuzugreifen. Die localIndex-Eigenschaft sollte nie Elemente enthalten, die nicht in der Quelle enthalten sind. Sie kann jedoch in der Quelle vorhandene Elemente nicht enthalten. Diese Eigenschaft ist null, wenn keine Sortierung durchgeführt wird.

sort

Eigenschaft

sort:ISort

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das ISort-Objekt, das auf die ICollectionView angewendet wird. Durch das Einrichten der Sortierung wird nicht automatisch die Ansicht aktualisiert. Sie müssen die refresh()-Methode nach dem Einrichten dieser Eigenschaft aufrufen. Wenn die Sortierung nicht unterstützt wird, gibt Flex einen Fehler aus, wenn auf diese Eigenschaft zugegriffen wird.

Hinweis: Die Flex-Implementierungen der ICollectionView-Schnittstelle rufen alle Elemente von einer Remote-Position ab, bevor eine Sortierung durchgeführt wird. Wenn Sie bei einer sortierten Liste Paging verwenden, wenden Sie die Sortierung auf die Remote-Sammlung an, bevor Sie die Daten abrufen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das sortChanged -Ereignis ausgelöst.

Implementierung
public function get sort():ISort
public function set sort(value:ISort):void

Verwandte API-Elemente

aktualisieren()

Konstruktordetails

()

Konstruktor

public function ListCollectionView(list:IList = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der ListCollectionView-Konstruktor.

Parameter

list:IList (default = null) — Die IList, die diese ListCollectionView einschließen soll.

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.

Auslöser

RangeError — Wenn der Index kleiner als 0 oder größer als die Länge der Liste ist.

addEventListener

()

Methode

 public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.

Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeEventListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.

Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Erfassungsphase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Erfassungsphase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.

Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.

Wenn Sie einen Ereignis-Listener nicht mehr benötigen, entfernen sie ihn, indem Sie EventDispatcher.removeEventListener() aufrufen, andernfalls könnte es zu Speicherproblemen kommen. Objekte mit registrierten Ereignis-Listenern werden nicht automatisch aus dem Speicher entfernt, da der Garbagekollektor (Speichermanagement) keine Objekte entfernt, die noch Verweise enthalten.

Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.

Wenn der Ereignis-Listener bei einem Knoten registriert ist und dieser Knoten ein Ereignis durchgeführt, so wird der Ereignis-Listener nicht während der aktuellen Phase ausgelöst, kann aber in einer späteren Phase im Ereignisablauf gesendet werden, etwa in der Bubbling-Phase.

Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).

Parameter

	`type:String` — Der Ereignistyp.

	`listener:Function` — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss, wie das nachfolgende Beispiel zeigt, ein Ereignisobjekt als einzigen Parameter akzeptieren und keinen Wert zurückgeben: `function(evt:Event):void` Der Name der Funktion ist beliebig.

	`useCapture:Boolean` (default = `false`) — Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet. Ist `useCapture` auf `true` gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat `useCapture` hingegen den Wert `false`, verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Damit das Ereignis in allen drei Phasen aktiv ist, rufen Sie `addEventListener()` zweimal auf; einmal ist `useCapture` auf `true` gesetzt, und beim zweiten Mal hat `useCapture` den Wert `false`.

	`priority:int` (default = `0`) — Die Prioritätsstufe des Ereignis-Listeners. Prioritäten werden über eine 32-Bit-Ganzzahl zugewiesen. Je höher die Zahl, desto höher die Priorität. Alle Listener mit der Priorität n werden vor Listenern mit der Priorität n-1 verarbeitet. Wenn zwei oder mehr Listener die gleiche Priorität aufweisen, werden sie in der Reihenfolge verarbeitet, in der sie hinzugefügt wurden. Die Standardpriorität ist 0.

	`useWeakReference:Boolean` (default = `false`) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Funktionen von Mitgliedern auf Klassenebene werden nicht vom Garbagekollektor entfernt. Daher können Sie `useWeakReference` für Mitgliedsfunktionen auf Klassenebene auf `true` setzen, ohne dass sie vom Garbagekollektor entfernt werden. Wenn Sie `useWeakReference` für einen Listener, der eine verschachtelte innere Funktion ist, auf `true` setzen, wird Garbage Collection auf diese Funktion angewendet, die damit nicht mehr permanent gespeichert wird. Indem Sie Verweise auf die innere Funktion erstellen (d. h sie in einer anderen Variable speichern), umgehen Sie die Garbage Collection, sodass die Funktion permanent gespeichert bleibt.

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

contains

()

Methode

public function contains(item:Object):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt zurück, ob die Ansicht das angegebene Objekt enthält. Im Unterschied zu IViewCursor.findxxx-Methoden ist diese Suche nur erfolgreich, wenn sie ein Element findet, das dem Parameter genau entspricht. Wenn ein Filter auf die Ansicht angewendet wird, kann diese Methode false zurückgeben, selbst wenn die zugrunde liegende Sammlung das Element enthält.

Parameter

item:Object — Das zu suchende Objekt.

Rückgabewerte

Boolean — Ist „true“, wenn die ICollectionView nach dem Anwenden von Filtern das Element enthält, andernfalls „false“.

Verwandte API-Elemente

enableAutoUpdate()
mx.events.CollectionEvent

createCursor

()

Methode

public function createCursor():IViewCursor

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird.

Rückgabewerte

IViewCursor — Eine neue IViewCursor-Implementierung.

disableAutoUpdate

()

Methode

public function disableAutoUpdate():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Verhindert, dass Änderungen der Sammlung selbst und Elemente aus der Sammlung von der Ansicht verteilt werden. Die Methode verhindert auch, dass die Ansicht die Positionen der Elemente aktualisiert, wenn die Positionen in der Sammlung geändert werden. Die Änderungen werden in die Warteschlange geschrieben und nach dem Aufruf von enableAutoUpdate entsprechend verteilt. Wenn mehr Ereignisse als Aktualisierungen an einem einzelnen Element vorgenommen werden, wird die Ansicht möglicherweise zurückgesetzt. Die disableAutoUpdate-Methode agiert kumulativ. Es ist dieselbe Anzahl von enableAutoUpdate-Aufrufen für die Ansicht erforderlich, um Ereignisse zu verteilen und die Ansicht zu aktualisieren. Hinweis: disableAutoUpdate hat nur Auswirkungen auf die einzelne Ansicht. Änderungen können einzeln von anderen Ansichten festgestellt werden.

Verwandte API-Elemente

mx.collections.ICollectionView.enableAutoUpdate()
mx.events.CollectionEvent

dispatchEvent

()

Methode

public function dispatchEvent(event:Event):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird.

Parameter

event:Event — Das Ereignisobjekt, das in den Ereignisablauf gesendet wird.

Rückgabewerte

Boolean — Der Wert true (sofern nicht preventDefault()) wird bei dem Ereignis aufgerufen. In diesem Fall wird false zurückgegeben.

enableAutoUpdate

()

Methode

public function enableAutoUpdate():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Aktiviert die automatische Aktualisierung. Weitere Informationen finden Sie unter disableAutoUpdate.

Verwandte API-Elemente

mx.collections.ICollectionView.disableAutoUpdate()

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 am angegebenen Index 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 diesem Index oder null, wenn keines vorhanden ist.

getItemIndex

()

Methode

public function getItemIndex(item:Object):int

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

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.

hasEventListener

()

Methode

public function hasEventListener(type:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. Dadurch können Sie bestimmen, wo ein EventDispatcher-Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Um festzustellen, ob ein bestimmter Ereignistyp einen Ereignis-Listener auslöst, verwenden Sie IEventDispatcher.willTrigger().

Der Unterschied zwischen hasEventListener() und willTrigger() besteht darin, dass hasEventListener() nur das Objekt untersucht, zu dem es gehört, während willTrigger() den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Parameter

type:String — Der Ereignistyp.

Rückgabewerte

Boolean — Der Wert true, wenn ein Listener des angegebenen Typs registriert ist; andernfalls false.

initialized

()

Methode

public function initialized(document:Object, id:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird automatisch vom MXML-Compiler aufgerufen, wenn die ListCollectionView mithilfe eines MXML-Tags erstellt wird. Wenn Sie die ListCollectionView mit ActionScript erstellen, müssen Sie diese Methode aufrufen und das MXML-Dokument sowie null für die id übergeben.

Parameter

	`document:Object` — Das MXML-Dokument, das dieses ListCollectionView-Objekt enthält.

	`id:String` — Werden ignoriert.

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. Diese Methode ist nützlich, wenn der Inhalt der Ansicht IPropertyChangeNotifier nicht implementiert. Wenn der Aufruf dieser Methode einen property-Parameter enthält, 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.)

Verwandte API-Elemente

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

refresh

()

Methode

public function refresh():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wendet die Sortierung und den Filter auf die Ansicht an. Die ICollectionView erkennt Änderungen einer Gruppe nicht automatisch. Daher müssen Sie die refresh()-Methode aufrufen, um die Ansicht nach dem Einrichten der Eigenschaften sort oder filterFunction zu aktualisieren. Wenn Ihre ICollectionView-Implementierung auch die IMXMLObject-Schnittstelle implementiert, sollten Sie die refresh()-Methode von der initialized()-Methode aus aufrufen.

Gibt true zurück, wenn die Aktualisierung erfolgreich war und false, wenn die Sortierung noch nicht abgeschlossen wurde (d. h. es stehen noch Elemente aus). Ein Client der Ansicht sollte auf ein CollectionEvent-Ereignis mit der Eigenschaft CollectionEventKind.REFRESH kind warten, um sicherzustellen, dass der refresh()-Vorgang abgeschlossen wurde.

Rückgabewerte

Boolean — true, wenn refresh() abgeschlossen wurde, false, wenn refresh() nicht abgeschlossen wurde.

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.

removeEventListener

()

Methode

public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.

Parameter

	`type:String` — Der Ereignistyp.

	`listener:Function` — Das zu entfernende Listener-Objekt.

	`useCapture:Boolean` (default = `false`) — Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde. Wenn der Listener sowohl für die Erfassungs- als auch für die Bubbling-Phase registriert wurde, sind auch zwei Aufrufe von `removeEventListener()` erforderlich, um beide zu entfernen: ein Aufruf, bei dem `useCapture` auf `true` gesetzt ist, und einer, bei dem `useCapture` auf `false` gesetzt ist.

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.

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

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung. Diese Methode kann einen ItemPendingError ausgeben.

Rückgabewerte

Array — Anschließend wird das Array.

toString

()

Methode

public function toString():String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt den Inhalt dieser Ansicht als String aus und gibt ihn zurück.

Rückgabewerte

String — Der Inhalt dieser Ansicht in Stringform.

willTrigger

()

Methode

public function willTrigger(type:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. Diese Methode liefert den Wert true, wenn während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für dieses EventDispatcher-Objekt oder eines seiner nachfolgenden Elemente ausgelöst wird.

Parameter

type:String — Der Ereignistyp.

Rückgabewerte

Boolean — Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false.

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

ListCollectionView - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.collections

filterFunction

length

list

localIndex

sort