mx.collectionsItemResponder Die ItemResponder-Klasse stellt eine Standardimplementierung der mx.rpc.IResponder-Schnittstelle bereit.mx.rpc:IResponderObject Die ItemResponder-Klasse stellt eine Standardimplementierung der mx.rpc.IResponder-Schnittstelle bereit. Sie stellt einen Responder dar, mit dem Sie Methoden festlegen können, die aufgerufen werden, wenn eine Anforderung ausgeführt wurde, sei es erfolgreich oder mit einem Fehler. Mit dem Klassenobjekt können Sie auch Daten bereitstellen (als Token), die von den Responder-Methoden verwendet werden sollen.

Sie können ein ItemResponder-Objekt in der catch-Anweisung eines Testblocks verwenden, dessen Ergebnis der Abruf von Remote-Daten sein kann, wie im folgenden Code dargestellt:


     import mx.collections.ItemResponder;
     //...
 
     try
     {
        //...
        cursor.moveNext();
     }
    catch(e:ItemPendingError)
     {
        e.addResponder(new ItemResponder(myResultFunction, myFaultFunction, {info:"..."}));
     }

Die festgelegte Ergebnismethode muss folgende Signatur haben:

     public function myResultFunction(result:Object, token:Object = null):void;

Die festgelegte Fehlermethode muss folgende Signatur haben:

     public function myFaultFunction(error:Object, token:Object = null):void;

Jede andere Signatur führt zu einem Laufzeitfehler.

mx.collections.errors.ItemPendingErrorItemResponder Erstellt eine Instanz des Responders mit den angegebenen Daten und Prozeduren.resultFunktion, die aufgerufen werden sollte, wenn die Anforderung erfolgreich ausgeführt wurde. Muss folgende Signatur haben: 
	     		    public function (result:Object, token:Object = null):void;
faultFunktion, die aufgerufen werden sollte, wenn die Anforderung mit Fehlern ausgeführt wurde. Muss folgende Signatur haben: 
	     		    public function (error:ErrorMessage, token:Object = null):void;
tokennullZusätzliche Objektinformationen [optional], die dieser Anforderung zugeordnet sind. Dieses Objekt wird an die Ergebnis- und Fehlerfunktionen als zweiter Parameter übergeben. Erstellt eine Instanz des Responders mit den angegebenen Daten und Prozeduren. fault Diese Methode wird von einem Dienst aufgerufen, wenn ein Fehler empfangen wurde.infoObjekt, das Informationen über den aufgetretenen Fehler enthält. Diese Methode wird von einem Dienst aufgerufen, wenn ein Fehler empfangen wurde. result Diese Methode wird von einem Dienst aufgerufen, wenn der Rückgabewert empfangen wurde.dataObjekt, das die Informationen enthält, die von der Anforderung zurückgegeben wurden. Diese Methode wird von einem Dienst aufgerufen, wenn der Rückgabewert empfangen wurde. Sort Stellt die Sortierinformationen bereit, die erforderlich sind, um eine Sortierung für eine vorhandene Ansicht durchzuführen (ICollectionView-Schnittstelle oder Klasse, die die Schnittstelle implementiert). The <mx:Sort> tag has the following attributes:

  <mx:Sort
  Properties
  compareFunction="Internal compare function"
  fields="null"
  unique="false | true"
  />

In case items have inconsistent data types or items have complex data types, the use of the default built-in compare functions is not recommended. Inconsistent sorting results may occur in such cases. To avoid such problem, provide a custom compare function and/or make the item types consistent.

Just like any other AdvancedStyleClient-based classes, the Sort and SortField classes do not have a parent-child relationship in terms of event handling. Locale changes in a Sort instance are not dispatched to its SortField instances automatically. The only exceptional case is the internal default SortField instance used when no explicit fields are provided. In this case, the internal default SortField instance follows the locale style that the owner Sort instance has.

]]>mx.collections:ISortflash.events:EventDispatcher Stellt die Sortierinformationen bereit, die erforderlich sind, um eine Sortierung für eine vorhandene Ansicht durchzuführen (ICollectionView-Schnittstelle oder Klasse, die die Schnittstelle implementiert). Nachdem Sie der sort-Eigenschaft der Ansicht eine Sort-Instanz zugewiesen haben, müssen Sie die refresh()-Methode der Ansicht aufrufen, um die Sortierkriterien anzuwenden. Normalerweise wird die Sortierung für Sammlungen komplexer Elemente definiert, also für Sammlungen, in denen die Sortierung einer oder mehrerer Eigenschaften der Objekte in der Sammlung durchgeführt wird. Das folgende Beispiel veranschaulicht diese Verwendung: 

     var col:ICollectionView = new ArrayCollection();
     // In the real world, the collection would have more than one item.
     col.addItem({first:"Anders", last:"Dickerson"});
     // Create the Sort instance.
     var sort:Sort = new Sort();
     // Set the sort field; sort on the last name first, first name second.
     // Both fields are case-insensitive.
     sort.fields = [new SortField("last",true), new SortField("first",true)];
       // Assign the Sort object to the view.
     col.sort = sort;
     // Apply the sort to the collection.
     col.refresh();

Es gibt Situationen, in denen die Sammlung einfache Elemente enthält, wie String, Date, Boolean usw. In diesem Fall wird die Sortierung direkt auf den einfachen Typ angewendet. Bei der Erstellung einer Sortierung für einfache Elemente verwenden Sie ein einzelnes Sortierfeld und geben im SortField-Objektkonstruktor einen (ersten) Parameter null name an. Beispiel: 


     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     // There is only one sort field, so use a null 
     // first parameter.
     sort.fields = [new SortField(null, true)];
     col.sort = sort;
     col.refresh();

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.

Standardmäßig stellt diese Sort-Klasse keine korrekte sprachspezifische Sortierung für Strings bereit. Weitere Informationen zu dieser Sortierungsart finden Sie unter den spark.collections.Sort- und spark.collections.SortField-Klassen.

mx.collections.ICollectionViewISortFieldspark.collections.Sortspark.collections.SortFieldSort Konstruktor. Konstruktor.

Erstellt eine neue Sort-Instanz ohne eingerichtete Felder und benutzerdefinierten Komparator.

findItem Sucht das angegebene Objekt im angegebenen Array (oder ggf. die Einfügemarke) und gibt die Indexposition zurück, falls sie gefunden wird, andernfalls -1.int Die Indexposition im Array des gefundenen Elements. Wenn der Parameter returnInsertionIndex den Wert false hat und das Element nicht gefunden wird. Gibt -1 zurück. Wenn der Parameter returnInsertionIndex den Wert true hat und das Element nicht gefunden wird, wird der Index des Punkts im sortierten Array zurückgegeben, an dem die Werte eingefügt würden. itemsDas Array, in dem gesucht werden soll. valuesObjekt, das die zu suchenden Eigenschaften enthält (oder das zu suchende Objekt selbst). Das Objekt muss aus Feldnamen/Werte-Paaren bestehen, wobei die Feldnamen die Namen von Feldern sind, die von der fields-Eigenschaft festgelegt wurden, und dieselbe Reihenfolge haben, in der sie in dieser Eigenschaft verwendet werden. Sie müssen nicht alle Felder aus der fields-Eigenschaft angeben, doch es ist nicht möglich, Felder in der Reihenfolge zu überspringen. Wenn die fields-Eigenschaft drei Felder auflistet, können Sie daher das erste und das zweite Feld in diesem Parameter angeben, nicht jedoch das erste und das dritte Feld. modeString, der den Typ des auszuführenden Suchvorgangs enthält. Die zulässigen Werte liegen zwischen und: ANY_INDEX_MODEGibt eine für die Werte zulässige Position zurück. FIRST_INDEX_MODE Gibt die Position der ersten Fundstelle der Werte zurück. LAST_INDEX_MODE Gibt die Position der letzten Fundstelle der angegebenen Werte zurück. returnInsertionIndexfalseWenn die Methode kein vom values-Parameter identifiziertes Element findet und dieser Parameter true ist, gibt die findItem()-Methode die Einfügemarke für die Werte zurück. Dies ist die Stelle in der sortierten Reihenfolge, an der das Element eingefügt werden soll. compareFunctionnullEine Komparator-Funktion zum Suchen des Elements. Wenn Sie diesen Parameter nicht angeben oder einen null-Wert bereitstellen, verwendet die findItem()-Funktion die von der compareFunction-Eigenschaft der ISort-Instanz festgelegte Vergleichsfunktion, die in den vom Werteobjekt und den derzeitigen SortFields bestimmten Feldarray übergeben wurde. Wenn Sie einen anderen Wert als null bereitstellen, verwendet die findItem()-Funktion diesen als die Vergleichsfunktion. Die Signatur der Funktion, die als compareFunction übergeben wurde, muss wie folgt lauten: function myCompareFunction(a:Object, b:Object):int. Beachten Sie, dass es kein drittes Argument gibt, im Gegensatz zur Vergleichsfunktion für die ISort.compareFunction()-Eigenschaft. Sucht das angegebene Objekt im angegebenen Array (oder ggf. die Einfügemarke) und gibt den Index zurück, falls er gefunden wird, andernfalls -1. Die findxxx()-Methoden der ListCollectionView-Klasse verwenden diese Methode, um das abgefragte Element zu suchen. Es ist im Allgemeinen einfacher, diese Funktionen anstelle von findItem() zu verwenden, um Daten in ListCollectionView-basierten Objekten zu suchen. Sie rufen die findItem()-Methode direkt auf, wenn Sie eine Klasse schreiben, die die Sortierung unterstützt, wie etwa eine neue ICollectionView-Implementierung. Das Eingabeelementarray muss vor dem Aufrufen dieser Funktion sortiert werden. Ansonsten kann diese Funktion den angegebenen Wert nicht richtig finden. propertyAffectsSort Gibt zurück, ob die angegebene Eigenschaft zur Steuerung der Sortierung verwendet wird.Ob der Eigenschaftswert Einfluss auf das Sortierergebnis haben kann. Wenn die Sortierung die compareFunction-Standardfunktion verwendet, wird true zurückgegeben, wenn der property-Parameter ein Sortierfeld angibt. Wenn die Sortierung oder ein beliebiges ISortField einen benutzerdefinierten Komparator verwendet, ist es nicht möglich, dies zu ermitteln. Daher wird true zurückgegeben. propertyDer Name des zu testenden Felds. Gibt zurück, ob die angegebene Eigenschaft zur Steuerung der Sortierung verwendet wird. Die Funktion kann keine definitive Antwort ermitteln, wenn die Sortierung einen benutzerdefinierten Komparator verwendet. Sie gibt in diesem Fall immer true zurück. reverse Durchläuft das Feldarray und ruft reverse() für jedes ISortField-Objekt im Array auf. Durchläuft das fields-Array und ruft reverse() für jedes ISortField-Objekt im Array auf. Wenn das Feld absteigend sortiert war, ist es nun aufsteigend sortiert und umgekehrt.

Hinweis: Eine ICollectionView wird nicht automatisch aktualisiert, wenn die Objekte im fields-Array geändert werden. Rufen Sie zur Aktualisierung der Ansicht ihre refresh()-Methode auf.

sort Die aktuelle Sortierung auf das angegebene Array anwenden (keine Kopie davon).itemsArray von zu sortierenden Elementen. Die aktuelle Sortierung auf das angegebene Array anwenden (keine Kopie davon). Um zu verhindern, dass das Array geändert wird, erstellen Sie eine Kopie und verwenden die Kopie im items-Parameter.

ICollectionView-Implementierungen von Flex rufen die sort-Methode automatisch auf und stellen sicher, dass die Sortierung an einer Kopie der zugrunde liegenden Daten ausgeführt wird.

ANY_INDEX_MODE Bei der Ausführung einer Suche den Index für alle übereinstimmenden Elemente zurückgeben.any Bei der Ausführung einer Suche den Index für alle übereinstimmenden Elemente zurückgeben. FIRST_INDEX_MODE Bei der Ausführung einer Suche den Index für das erste übereinstimmende Element zurückgeben.first Bei der Ausführung einer Suche den Index für das erste übereinstimmende Element zurückgeben. LAST_INDEX_MODE Bei der Ausführung eines Suche den Index für das letzte übereinstimmende Element zurückgeben.last Bei der Ausführung eines Suche den Index für das letzte übereinstimmende Element zurückgeben. compareFunction Die Methode, die für den Vergleich von Elementen bei der Sortierung verwendet wird. Die Methode, die für den Vergleich von Elementen bei der Sortierung verwendet wird. Wenn Sie diese Eigenschaft angeben, ignoriert Flex alle compareFunction-Eigenschaften, die Sie in den ISortField-Objekten angeben, die Sie in dieser Klasse verwenden.

Die Vergleichsfunktion muss folgende Signatur haben:


     
         function [name](a:Object, b:Object, fields:Array = null):int

Diese Funktion muss Folgendes zurückgeben value:

  • -1, wenn das Object a vor dem Object b in der sortierten Sequenz erscheinen soll
  • 0, wenn Object a Object b entspricht
  • 1, wenn das Object a nach dem Object b in der sortierten Sequenz erscheinen soll

Um zur internen Vergleichsfunktion zurückzukehren, setzen Sie diesen Wert auf null.

Das fields-Array gibt die zu vergleichenden Objektfelder an. Normalerweise vergleicht der Algorithmus Eigenschaften, bis die Feldliste abgearbeitet wurde oder ein Wert ungleich null zurückgegeben werden kann. Beispiel:


        function myCompare(a:Object, b:Object, fields:Array = null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }

Der Standardwert ist eine interne Vergleichsfunktion, die einen Vergleich von Strings, numerischen Werten oder Datumsangaben in aufsteigender oder absteigender Reihenfolge durchführen kann. Geben Sie Ihre eigene Funktion nur an, wenn ein benutzerdefinierter Vergleichsalgorithmus erforderlich ist. Dies ist normalerweise nur der Fall, wenn ein berechnetes Feld in einer Anzeige verwendet wird.

Alternativ dazu können Sie für jedes Sortierfeld mithilfe der compareFunction-Eigenschaft der ISortField-Klasse eigene Vergleichsfunktionen festlegen. Auf diese Weise können Sie für bestimmte Felder den Standardvergleich und für andere Felder einen benutzerdefinierten Vergleich verwenden.

fields Ein Array von ISortField-Objekten, das die zu vergleichenden Felder angibt.null Ein Array von ISortField-Objekten, das die zu vergleichenden Felder angibt. Die Reihenfolge der ISortField-Objekte im Array bestimmt die Reihenfolge der Feldpriorität bei der Sortierung. Der Standardsortierkomparator prüft die Sortierfelder in der Arrayreihenfolge, bis eine Sortierreihenfolge für die beiden verglichenen Felder bestimmt werden kann. SortFieldunique Gibt an, ob die Sortierung eindeutig sein soll.false Gibt an, ob die Sortierung eindeutig sein soll. Eindeutige Sortierungen schlagen fehl, wenn ein Wert oder kombinierter Wert, der von den im Feldeigenschaftenergebnis aufgeführten Feldern angegeben wird, eine unbestimmte oder nicht-eindeutige Sortierreihenfolge ergibt, d. h., wenn zwei oder mehr Elemente identische Sortierfeldwerte haben. Ein Fehler wird ausgegeben, wenn die Sortierung nicht eindeutig ist. Die Sortierungslogik verwendet diesen unique-Eigenschaftswert nur, wenn jedes Sortierfeld explizit festgelegt wird. Wenn kein Sortierfeld explizit festgelegt wird, wird kein Fehler ausgegeben, selbst wenn identische Wertelemente vorhanden sind. ISortField Die ISortField-Schnittstelle definiert die Schnittstelle für Klassen, die mit ISort-Klassen verwendet werden, um die zur Sortierung der bestimmten Felder oder Eigenschaften einer Sammlungsansicht erforderlichen Sortierinformationen bereitzustellen. Die ISortField-Schnittstelle definiert die Schnittstelle für Klassen, die mit ISort-Klassen verwendet werden, um die zur Sortierung der bestimmten Felder oder Eigenschaften einer Sammlungsansicht erforderlichen Sortierinformationen bereitzustellen. initializeDefaultCompareFunction Eine Hilfsfunktion, die von der Sort-Klasse aufgerufen wird, um die Standardvergleichsfunktion zur Durchführung eines Vergleichs basierend auf einer von drei Möglichkeiten festzulegen: ob eine benutzerdefinierte Vergleichsfunktion, der Datentyp für das angegebene Feld oder der Wert der numerischen Eigenschaft festgelegt wurde.objDas Objekt, das die Daten enthält. Wenn der Feldname mit den Namenseigenschaften festgelegt wurde, wird mit dem Namen auf den Datenwert von diesem Objekt zugegriffen. Andernfalls wird das Objekt selbst als Datenwert verwendet. Eine Hilfsfunktion, die von der Sort-Klasse aufgerufen wird, um die Standardvergleichsfunktion zur Durchführung eines Vergleichs basierend auf einer von drei Möglichkeiten festzulegen: ob eine benutzerdefinierte Vergleichsfunktion, der Datentyp für das angegebene Feld oder der Wert der numerischen Eigenschaft festgelegt wurde. Wenn die numeric-Eigenschaft „true“ ist, wird beim Sortieren ein numerischer Vergleich durchgeführt. reverse Die Kriterien für dieses Sortierfeld umkehren. Die Kriterien für dieses Sortierfeld umkehren. Wenn das Feld z. B. in absteigender Reihenfolge sortiert war, wird es in aufsteigender Reihenfolge sortiert.

Hinweis: Eine ICollectionView wird nicht automatisch aktualisiert, wenn die ISortFields geändert werden. Rufen Sie zur Aktualisierung der Ansicht ihre refresh()-Methode auf.

arraySortOnOptions Diese Helper-Eigenschaft wird intern in der findItem(). und sort()-Methode verwendet. Diese Helper-Eigenschaft wird intern in der findItem()- und sort()-Methode verwendet. Andere Verwendungen dieser Eigenschaft werden nicht unterstützt. Gibt -1 zurück, wenn dieses ISortField nicht von der Sort-Klasse zum Sortieren des Felds verwendet werden soll (es gibt keine compareFunction und keinen Namen). Andernfalls wird eine Bitmask von Sortieroptionen zurückgegeben. compareFunction Die Funktion, die zwei Elemente bei der Sortierung von Elementen für die zugehörige Sammlung vergleicht. Die Funktion, die zwei Elemente bei der Sortierung von Elementen für die zugehörige Sammlung vergleicht. Wenn Sie eine compareFunction-Eigenschaft in einem ISort-Objekt angeben, ignoriert Flex alle compareFunction-Eigenschaften der ISortField-Objekte der ISort.

Die Vergleichsfunktion muss folgende Signatur haben:

function myCompare(a:Object, b:Object):int

Die Funktion gibt folgende Werte zurück:

  • -1, wenn a in der sortierten Sequenz vor b erscheint.
  • 0, wenn a gleich b ist.
  • -1, wenn a in der sortierten Sequenz nach b erscheint.
descending Gibt an, ob dieses Feld in absteigender Reihenfolge sortiert werden soll. Gibt an, ob dieses Feld in absteigender Reihenfolge sortiert werden soll.

Der Standardwert ist false (aufsteigend).

name Der Name des zu sortierenden Felds. Der Name des zu sortierenden Felds. numeric Gibt an, dass der Komparator einen numerischen Vergleich verwendet, wenn das sortierte Feld numerische Werte (number/int/uint) oder Stringdarstellungen numerischer Werte enthält.null Gibt an, dass der Komparator einen numerischen Vergleich verwendet, wenn das sortierte Feld numerische Werte (number/int/uint) oder Stringdarstellungen numerischer Werte enthält.

Diese Eigenschaft wird von der SortField-Klasse verwendet, wenn die benutzerdefinierte Vergleichsfunktion nicht bereitgestellt wird.

Wenn diese Eigenschaft true ist, wird die integrierte Vergleichsfunktion verwendet. Jedes Datenelement wird vor dem Vergleich in eine Number()-Funktion umgewandelt.

Wenn diese Eigenschaft false ist, wird die integrierte Stringvergleichsfunktion verwendet. Jedes Datenelement wird vor dem Vergleich in eine String()-Funktion umgewandelt.

Wenn diese Eigenschaft null ist, wird das erste Datenelement geprüft, um festzustellen, ob es sich um eine Zahl oder einen String handelt, und die Sortierung wird basierend auf dieser Prüfung fortgesetzt.

usingCustomCompareFunction „True“, wenn dieses ISortField eine benutzerdefinierte Komparator-Funktion verwendet. „True“, wenn dieses ISortField eine benutzerdefinierte Komparator-Funktion verwendet. ArrayList Die ArrayList-Klasse ist eine einfache Implementierung der IList, die ein zugrunde liegendes Array als Datenquelle verwendet.mx.collections:IListflash.utils:IExternalizablemx.core:IPropertyChangeNotifierflash.events:EventDispatcher Die ArrayList-Klasse ist eine einfache Implementierung der IList, die ein zugrunde liegendes Array als Datenquelle verwendet. Auf die Elemente im zugrunde liegenden Array kann zugegriffen werden und sie können bearbeitet werden, indem Sie die Methoden und Eigenschaften der 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"
  />
collectionChange Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde. ArrayList Erstellt eine neue ArrayList, indem das angegebene Array als zugehörige Quelle verwendet wird.sourcenullDas als Quelle für die ArrayList zu verwendende Array. Erstellt eine neue ArrayList, indem das angegebene Array als zugehörige Quelle verwendet wird. Wenn keine Quelle angegeben ist, wird ein leeres Array verwendet. addAllAt addListmx.collections:IListDie Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen. indexDie Position der aktuellen Liste, an die die neuen Elemente platziert werden sollen. addAll addListmx.collections:IListDie Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen. addItemAt Fügt das Element an der angegebenen Indexposition hinzu.Wenn die Indexposition kleiner als 0 oder größer als die Länge ist. RangeErrorRangeErroritemDas Element, das an die Indexposition platziert werden soll. indexDie Indexposition, an der das Element platziert werden soll. Fügt das Element an der angegebenen Indexposition hinzu. Alle nach dieser Indexposition platzierten Elemente werden um eine Stelle verschoben. addItem Fügt das angegebene Element am Ende der Liste hinzu.itemdas hinzuzufügende Element Fügt das angegebene Element am Ende der Liste hinzu. Entspricht addItemAt(item, length); getItemAt Ruft das Element an der angegebenen Indexposition ab.Wenn die Daten für diesen Index von einem Remote-Speicherort geladen werden müssen ItemPendingErrorItemPendingErrorWenn Indexposition < 0 oder Indexposition >= Länge. RangeErrorRangeErrorDas Element an dieser Indexposition; null, wenn keines vorhanden ist. indexDie Indexposition in der Liste, aus der das Element abgerufen werden soll. prefetch0Ein 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. Ruft das Element an der angegebenen Indexposition ab. getItemIndex Gibt die Indexposition des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.Die Indexposition des Elements; -1, wenn das Element nicht in der Liste enthalten ist. itemdas zu suchende Element 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. itemUpdateHandler Wird aufgerufen, wenn eines der in der Liste enthaltenen Elemente ein ObjectChange-Ereignis auslöst.eventmx.events:PropertyChangeEventDas Ereignisobjekt für das ObjectChange-Ereignis. Wird aufgerufen, wenn eines der in der Liste enthaltenen Elemente ein ObjectChange-Ereignis auslöst. Schließt es in ein CollectionEventKind.UPDATE-Objekt ein. itemUpdated Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.itemDas Element in der Ansicht, die aktualisiert wurde. propertynullEin String, QName oder int-Wert für die Angabe der aktualisierten Eigenschaft. oldValuenullDer alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.) newValuenullDer 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.) 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. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventremoveAll Entfernt alle Elemente aus der Liste. Entfernt alle Elemente aus der Liste. removeItemAt Entfernt das Element an der angegebenen Indexposition und gibt es zurück.Wenn index < 0 oder index >= length. RangeErrorRangeErrorDas entfernte Element. indexDer Index, an dem das Element entfernt werden soll. 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. removeItem Entfernt das angegebene Element aus der Liste, falls vorhanden.Boolescher Wert, der angibt, ob das Element entfernt wurde. itemObjektverweis auf das Element, das entfernt werden soll. Entfernt das angegebene Element aus der Liste, falls vorhanden. setItemAt Platziert das Element an der angegebenen Indexposition.Wenn die Indexposition kleiner als 0 oder größer als oder gleich die Länge ist. RangeErrorRangeErrorDas Element, das ersetzt wurde; null, wenn keines ersetzt wurde. itemder neue Wert der Indexposition indexDie Indexposition, an der das Element platziert werden soll. 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. startTrackUpdates Wenn das Element ein IEventDispatcher ist, überwachen Sie es auf Aktualisierungen.itemDas an die addItemAt()-Methode übergebene Element. 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. stopTrackUpdates Wenn es sich bei dem Element um einen IEventDispatcher handelt, unterbrechen Sie das Überwachen auf Aktualisierungen.itemDas an die removeItemAt()-Methode übergebene Element. 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. toArray Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.Wenn die Daten noch nicht vollständig von einem Remote-Speicherort geladen wurden. ItemPendingErrorItemPendingErrorEin Array, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung. Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung. toString Gibt den Inhalt dieser ArrayList in einem String aus und gibt ihn zurück.Ein String, der die Inhalte der ArrayList beinhaltet. Gibt den Inhalt dieser ArrayList in einem String aus und gibt ihn zurück. length Ruft die Anzahl der Elemente in der Liste ab. 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. source Das Quellarray für diese ArrayList. 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. uid Bietet Zugriff auf die eindeutige ID für diese Liste. Bietet Zugriff auf die eindeutige ID für diese Liste. SortField Stellt die Sortierinformationen bereit, die erforderlich sind, um eine Sortierung eines Felds oder einer Eigenschaft in einer Sammlungsansicht durchzuführen. The <mx:SortField> tag has the following attributes:

  <mx:SortField
  Properties
  caseInsensitive="false"
  compareFunction="Internal compare function"
  descending="false"
  name="null"
  numeric="null"
  />
]]>mx.collections:ISortFieldflash.events:EventDispatcher Stellt die Sortierinformationen bereit, die erforderlich sind, um eine Sortierung eines Felds oder einer Eigenschaft in einer Sammlungsansicht durchzuführen. Die SortField-Klasse wird mit der Sort-Klasse verwendet. Normalerweise wird die Sortierung für Sammlungen komplexer Elemente definiert, also für Elemente, in denen die Sortierung anhand von Eigenschaften dieser Objekte durchgeführt wird. Beispiel: 

     var col:ICollectionView = new ArrayCollection();
     col.addItem({first:"Anders", last:"Dickerson"});
     var sort:Sort = new Sort();
     sort.fields = [new SortField("first", true)];
     col.sort = sort;
Es gibt Situationen, in denen die Sammlung einfache Elemente enthält, wie String, Date, Boolean usw. In diesem Fall wird die Sortierung direkt auf den einfachen Datentyp angewendet. Bei der Erstellung einer Sortierung für diese Situation ist nur ein einzelnes Sortierfeld erforderlich, für das name nicht angegeben sein sollte. Beispiel: 

     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     sort.fields = [new SortField(null, true)];
     col.sort = sort;

Standardmäßig stellt der von der SortField-Klasse bereitgestellte Vergleich keine korrekte sprachspezifische Sortierung für Strings bereit. Weitere Informationen zu dieser Sortierungsart finden Sie unter den spark.collections.Sort- und spark.collections.SortField-Klassen.

mx.collections.ICollectionViewmx.collections.Sortspark.collections.Sortspark.collections.SortFieldSortField Konstruktor.namenullDer Name der Eigenschaft, die dieses Feld für den Vergleich verwendet. Wenn das Objekt ein einfacher Typ ist, übergeben Sie null. caseInsensitivefalseBeim Sortieren von Strings wird der Komparator angewiesen, ob die Schreibweise der Werte ignoriert werden soll. descendingfalseWeist den Komparator an, ob Elemente in absteigender Reihenfolge angeordnet werden sollen. numericnullWeist den Komparator an, ob Sortierelemente als Zahlenwerte verglichen werden sollen, anstatt alphabetisch. Konstruktor. initializeDefaultCompareFunction Eine Hilfsfunktion, die von der Sort-Klasse aufgerufen wird, um die Standardvergleichsfunktion zur Durchführung eines Vergleichs basierend auf einer von drei Möglichkeiten festzulegen: ob eine benutzerdefinierte Vergleichsfunktion, der Datentyp für das angegebene Feld oder der Wert der numerischen Eigenschaft festgelegt wurde.objDas Objekt, das die Daten enthält. Wenn der Feldname mit den Namenseigenschaften festgelegt wurde, wird mit dem Namen auf den Datenwert von diesem Objekt zugegriffen. Andernfalls wird das Objekt selbst als Datenwert verwendet. Eine Hilfsfunktion, die von der Sort-Klasse aufgerufen wird, um die Standardvergleichsfunktion zur Durchführung eines Vergleichs basierend auf einer von drei Möglichkeiten festzulegen: ob eine benutzerdefinierte Vergleichsfunktion, der Datentyp für das angegebene Feld oder der Wert der numerischen Eigenschaft festgelegt wurde. Wenn die numeric-Eigenschaft „true“ ist, wird beim Sortieren ein numerischer Vergleich durchgeführt. reverse Die Kriterien für dieses Sortierfeld umkehren. Die Kriterien für dieses Sortierfeld umkehren. Wenn das Feld z. B. in absteigender Reihenfolge sortiert war, wird es in aufsteigender Reihenfolge sortiert.

Hinweis: Eine ICollectionView wird nicht automatisch aktualisiert, wenn die ISortFields geändert werden. Rufen Sie zur Aktualisierung der Ansicht ihre refresh()-Methode auf.

arraySortOnOptions Diese Helper-Eigenschaft wird intern in der findItem(). und sort()-Methode verwendet. Diese Helper-Eigenschaft wird intern in der findItem()- und sort()-Methode verwendet. Andere Verwendungen dieser Eigenschaft werden nicht unterstützt. Gibt -1 zurück, wenn dieses ISortField nicht von der Sort-Klasse zum Sortieren des Felds verwendet werden soll (es gibt keine compareFunction und keinen Namen). Andernfalls wird eine Bitmask von Sortieroptionen zurückgegeben. caseInsensitive Gibt an, ob die Sortierung für dieses Feld zwischen Groß- und Kleinschreibung unterscheiden soll.false Gibt an, ob die Sortierung für dieses Feld zwischen Groß- und Kleinschreibung unterscheiden soll. compareFunction Die Funktion, die zwei Elemente bei der Sortierung von Elementen für die zugehörige Sammlung vergleicht. Die Funktion, die zwei Elemente bei der Sortierung von Elementen für die zugehörige Sammlung vergleicht. Wenn Sie eine compareFunction-Eigenschaft in einem ISort-Objekt angeben, ignoriert Flex alle compareFunction-Eigenschaften der SortField-Objekte der ISort.

Die Vergleichsfunktion muss folgende Signatur haben:

function myCompare(a:Object, b:Object):int

Diese Funktion muss folgende Werte zurückgeben:

  • -1, wenn a in der sortierten Sequenz vor b erscheint.
  • 0, wenn a gleich b ist.
  • -1, wenn a in der sortierten Sequenz nach b erscheint.

Der Standardwert ist eine interne Vergleichsfunktion, die einen Vergleich von Strings, numerischen Werten oder Datumsangaben in aufsteigender oder absteigender Reihenfolge durchführen kann, wobei die Stringvergleiche zwischen Groß- und Kleinschreibung unterscheiden können. Geben Sie Ihre eigene Funktion nur an, wenn ein benutzerdefinierter Vergleichsalgorithmus erforderlich ist. Dies ist normalerweise nur der Fall, wenn ein berechnetes Feld in einer Anzeige verwendet wird.

Hinweis: Wenn Sie sprachspezifische Sortierung benötigen, betrachten Sie die spark.collections.SortField-Klasse als Alternative. spark.collections.SortFielddescending Gibt an, ob dieses Feld in absteigender Reihenfolge sortiert werden soll. Gibt an, ob dieses Feld in absteigender Reihenfolge sortiert werden soll.

Der Standardwert ist false (aufsteigend).

name Der Name des zu sortierenden Felds.null Der Name des zu sortierenden Felds. numeric Gibt an, dass der Komparator einen numerischen Vergleich verwendet, wenn das sortierte Feld numerische Werte (number/int/uint) oder Stringdarstellungen numerischer Werte enthält.null Gibt an, dass der Komparator einen numerischen Vergleich verwendet, wenn das sortierte Feld numerische Werte (number/int/uint) oder Stringdarstellungen numerischer Werte enthält.

Diese Eigenschaft wird von der SortField-Klasse verwendet, wenn die benutzerdefinierte Vergleichsfunktion nicht bereitgestellt wird.

Wenn diese Eigenschaft true ist, wird die integrierte Vergleichsfunktion verwendet. Jedes Datenelement wird vor dem Vergleich in eine Number()-Funktion umgewandelt.

Wenn diese Eigenschaft false ist, wird die integrierte Stringvergleichsfunktion verwendet. Jedes Datenelement wird vor dem Vergleich in eine String()-Funktion umgewandelt.

Wenn diese Eigenschaft null ist, wird das erste Datenelement geprüft, um festzustellen, ob es sich um eine Zahl oder einen String handelt, und die Sortierung wird basierend auf dieser Prüfung fortgesetzt.

usingCustomCompareFunction „True“, wenn dieses ISortField eine benutzerdefinierte Komparator-Funktion verwendet. „True“, wenn dieses ISortField eine benutzerdefinierte Komparator-Funktion verwendet. AsyncListView Die AsyncListView-Klasse ist eine Implementierung der IList-Schnittstelle, die ItemPendingErrors-Fehler verarbeitet, die von den Methoden getItemAt(), removeItemAt() und toArray() ausgegeben geben.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"
  />
]]>mx.collections:IListmx.utils:OnDemandEventDispatcher 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.

collectionChange Wird ausgelöst, wenn sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Wird ausgelöst, wenn sich die Länge der Liste geändert hat oder wenn ein Listenelement ersetzt wird. AsyncListView Konstruktor.listmx.collections:IListnullDer Anfangswert der Listeneigenschaft, die IList, an die delegiert wird. Konstruktor. addItemAt Fügt das Element an der angegebenen Indexposition hinzu.itemDas Element, das an die Indexposition platziert werden soll. indexDer Index, an den das Element platziert werden soll. 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. addItem Fügt das angegebene Element am Ende der Liste hinzu.itemDas hinzuzufügende Element. Fügt das angegebene Element am Ende der Liste hinzu. Entspricht addItemAt(item, length). getItemAt Gibt den Wert von list.getItemAt(index) zurück.Wenn index < 0 oder index >= length. RangeErrorRangeErrorDas Listenelement an der angegebenen Indexposition. indexDie Listenindexposition, von der das Objekt abgerufen werden soll. prefetch0Ein 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. 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.

createPendingItemFunctioncreateFailedItemFunctionmx.collections.errors.ItemPendingErrormx.rpc.IRespondergetItemIndex Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.Der Index des Elements oder -1, wenn das Element nicht in der Liste enthalten ist. itemDas zu suchende Element. 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.

itemUpdated Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.itemDas Element in der Ansicht, die aktualisiert wurde. propertynullDer Name der Eigenschaft, die aktualisiert wurde. oldValuenullDer alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.) newValuenullDer 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.) 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. removeAll Entfernt alle Elemente aus der Liste. 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 Entfernt das tatsächliche oder ausstehende Objekt an der angegebenen Indexposition und gibt es zurück.Wenn index < 0 oder index >= length. RangeErrorRangeErrorDas Objekt, das entfernt wurde oder den Wert null hat. indexDie Listenindexposition, von der das Objekt abgerufen werden soll. 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.

setItemAt Platziert das Element am angegebenen Index.Das Element, das ersetzt wurde, oder null, wenn keines ersetzt wurde. itemDas neue Element, das am angegebenen Index platziert werden soll. indexDer Index, an den das Element platziert werden soll. Platziert das Element am angegebenen Index. Wenn sich bereits ein Element an diesem Index befand, wird es vom neuen Element ersetzt und zurückgegeben. toArray Gibt ein Array mit denselben Elementen wie diese AsyncListView zurück.Ein Array mit denselben Elementen wie diese AsyncListView. 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. toString Gibt einen String zurück, der die Länge der Liste und die Anzahl ausstehender Objektanforderungen enthält.Eine kurze Beschreibung der Liste. 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. createFailedItemFunction 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.A function that unconditionally returns null. 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.

getItemAt()createPendingItemFunctionmx.rpc.IResponder.faultcreatePendingItemFunction Eine für das Erstellen eines vorläufigen Objekts verwendete Rückruffunktion, wenn die Erstanforderung zur Ausgabe eines ItemPendingError führt.A function that unconditionally returns null. 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.

getItemAt()createFailedItemFunctionmx.collections.errors.ItemPendingErrorlength Die Anzahl der Elemente in dieser Sammlung. Die Anzahl der Elemente in dieser Sammlung. 0 bedeutet keine Elemente, -1 bedeutet, dass die Länge unbekannt ist. list Das IList-Objekt, das von dieser Sammlung eingeschlossen wird.mx.collections:IListnull 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()).

ArrayCollection Die ArrayCollection-Klasse ist eine Wrapper-Klasse, die ein Array als Sammlung anzeigt, auf die mit den Methoden und Eigenschaften der Schnittstellen ICollectionView und IList zugegriffen und mit diesen auch verändert werden kann.The <mx:ArrayCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:ArrayCollection
  Properties
  source="null"
  />
]]>flash.utils:IExternalizablemx.collections:ListCollectionView Die ArrayCollection-Klasse ist ein Wrapper-Klasse, die ein Array als Sammlung anzeigt, auf die mit den Methoden und Eigenschaften der Schnittstellen ICollectionView und IList zugegriffen und mit diesen auch verändert werden kann. Vorgänge an einer ArrayCollection-Instanz modifizieren die Datenquelle. Wenn Sie z. B. die removeItemAt()-Methode auf eine ArrayCollection anwenden, entfernen Sie das Element aus dem zugrunde liegenden Array. Der folgende Code erstellt ein einfaches ArrayCollection-Objekt, das auf ein Array mit einem einzelnen Object-Element zugreift und dieses ändert. Es ruft das Element mithilfe der getItemAt-Methode der IList-Schnittstelle ab und ein IViewCursor-Objekt mithilfe der createCursor-Methode der ICollectionView-Schnittstelle. 
  var myCollection:ArrayCollection = new ArrayCollection([ { first: 'Matt', last: 'Matthews' } ]);
  var myCursor:IViewCursor = myCollection.createCursor();
  var firstItem:Object = myCollection.getItemAt(0);
  var firstItemFromCursor:Object = myCursor.current;
  if (firstItem == firstItemFromCursor)
        doCelebration();
ArrayCollection Konstruktor.sourcenullDas Quellarray. Konstruktor.

Erstellt mithilfe des angegebenen Quellarrays ein neues ArrayCollection-Objekt. Wenn kein Array angegeben wird, wird ein leeres Array verwendet.

source Die Quelle der Daten im ArrayCollection-Objekt. Die Quelle der Daten im ArrayCollection-Objekt. Das ArrayCollection-Objekt stellt keine Änderungen dar, die Sie direkt am Quellarray vornehmen. Verwenden Sie zum Modifizieren der Sammlung immer die Methoden ICollectionView oder IList. ISort Die ISort-Schnittstelle definiert die Schnittstelle für Klassen, die die zur Sortierung der Daten einer Sammlungsansicht erforderlichen Sortierinformationen bereitstellen. Die ISort-Schnittstelle definiert die Schnittstelle für Klassen, die die zur Sortierung der Daten einer Sammlungsansicht erforderlichen Sortierinformationen bereitstellen. mx.collections.ICollectionViewmx.collections.ISortFieldfindItem Sucht das angegebene Objekt im angegebenen Array (oder ggf. die Einfügemarke) und gibt die Indexposition zurück, falls sie gefunden wird, andernfalls -1.Wenn Parameterfehler vorliegen, ist das Suchkriterium nicht mit der Sortierungs- oder Komparator-Funktion kompatibel, weil die Sortierung nicht bestimmt werden kann. SortErrorSortErrorint Die Indexposition im Array des gefundenen Elements. Wenn der Parameter returnInsertionIndex den Wert false hat und das Element nicht gefunden wird. Gibt -1 zurück. Wenn der Parameter returnInsertionIndex den Wert true hat und das Element nicht gefunden wird, wird der Index des Punkts im sortierten Array zurückgegeben, an dem die Werte eingefügt würden. itemsDas Array, in dem gesucht werden soll. valuesObjekt, das die zu suchenden Eigenschaften enthält (oder das zu suchende Objekt selbst). Das Objekt muss aus Feldnamen/Werte-Paaren bestehen, wobei die Feldnamen die Namen von Feldern sind, die von der fields-Eigenschaft festgelegt wurden, und dieselbe Reihenfolge haben, in der sie in dieser Eigenschaft verwendet werden. Sie müssen nicht alle Felder aus der fields-Eigenschaft angeben, doch es ist nicht möglich, Felder in der Reihenfolge zu überspringen. Wenn die fields-Eigenschaft drei Felder auflistet, können Sie daher das erste und das zweite Feld in diesem Parameter angeben, nicht jedoch das erste und das dritte Feld. modeString, der den Typ des auszuführenden Suchvorgangs enthält. Die zulässigen Werte liegen zwischen und: ANY_INDEX_MODEGibt eine für die Werte zulässige Position zurück. FIRST_INDEX_MODE Gibt die Position der ersten Fundstelle der Werte zurück. LAST_INDEX_MODE Gibt die Position der letzten Fundstelle der angegebenen Werte zurück. returnInsertionIndexfalseWenn die Methode kein vom values-Parameter identifiziertes Element findet und dieser Parameter true ist, gibt die findItem()-Methode die Einfügemarke für die Werte zurück. Dies ist die Stelle in der sortierten Reihenfolge, an der das Element eingefügt werden soll. compareFunctionnullEine Komparator-Funktion zum Suchen des Elements. Wenn Sie diesen Parameter nicht angeben oder einen null-Wert bereitstellen, verwendet die findItem()-Funktion die von der compareFunction-Eigenschaft der ISort-Instanz festgelegte Vergleichsfunktion, die in den vom Werteobjekt und den derzeitigen SortFields bestimmten Feldarray übergeben wurde. Wenn Sie einen anderen Wert als null bereitstellen, verwendet die findItem()-Funktion diesen als die Vergleichsfunktion. Die Signatur der Funktion, die als compareFunction übergeben wurde, muss wie folgt lauten: function myCompareFunction(a:Object, b:Object):int. Beachten Sie, dass es kein drittes Argument gibt, im Gegensatz zur Vergleichsfunktion für die ISort.compareFunction()-Eigenschaft. Sucht das angegebene Objekt im angegebenen Array (oder ggf. die Einfügemarke) und gibt den Index zurück, falls er gefunden wird, andernfalls -1. Die findxxx()-Methoden der ListCollectionView-Klasse verwenden diese Methode, um das abgefragte Element zu suchen. Es ist im Allgemeinen einfacher, diese Funktionen anstelle von findItem() zu verwenden, um Daten in ListCollectionView-basierten Objekten zu suchen. Sie rufen die findItem()-Methode direkt auf, wenn Sie eine Klasse schreiben, die die Sortierung unterstützt, wie etwa eine neue ICollectionView-Implementierung. Das Eingabeelementarray muss vor dem Aufrufen dieser Funktion sortiert werden. Ansonsten kann diese Funktion den angegebenen Wert nicht richtig finden. propertyAffectsSort Gibt zurück, ob die angegebene Eigenschaft zur Steuerung der Sortierung verwendet wird.Ob der Eigenschaftswert Einfluss auf das Sortierergebnis haben kann. Wenn die Sortierung die compareFunction-Standardfunktion verwendet, wird true zurückgegeben, wenn der property-Parameter ein Sortierfeld angibt. Wenn die Sortierung oder ein beliebiges ISortField einen benutzerdefinierten Komparator verwendet, ist es nicht möglich, dies zu ermitteln. Daher wird true zurückgegeben. propertyDer Name des zu testenden Felds. Gibt zurück, ob die angegebene Eigenschaft zur Steuerung der Sortierung verwendet wird. Die Funktion kann keine definitive Antwort ermitteln, wenn die Sortierung einen benutzerdefinierten Komparator verwendet. Sie gibt in diesem Fall immer true zurück. reverse Durchläuft das Feldarray und ruft reverse() für jedes ISortField-Objekt im Array auf. Durchläuft das fields-Array und ruft reverse() für jedes ISortField-Objekt im Array auf. Wenn das Feld absteigend sortiert war, ist es nun aufsteigend sortiert und umgekehrt.

Hinweis: Eine ICollectionView wird nicht automatisch aktualisiert, wenn die Objekte im fields-Array geändert werden. Rufen Sie zur Aktualisierung der Ansicht ihre refresh()-Methode auf.

sort Die aktuelle Sortierung auf das angegebene Array anwenden (keine Kopie davon).itemsArray von zu sortierenden Elementen. Die aktuelle Sortierung auf das angegebene Array anwenden (keine Kopie davon). Um zu verhindern, dass das Array geändert wird, erstellen Sie eine Kopie und verwenden die Kopie im items-Parameter.

ICollectionView-Implementierungen von Flex rufen die sort-Methode automatisch auf und stellen sicher, dass die Sortierung an einer Kopie der zugrunde liegenden Daten ausgeführt wird.

compareFunction Die Methode, die für den Vergleich von Elementen bei der Sortierung verwendet wird. Die Methode, die für den Vergleich von Elementen bei der Sortierung verwendet wird. Wenn Sie diese Eigenschaft angeben, ignoriert Flex alle compareFunction-Eigenschaften, die Sie in den ISortField-Objekten angeben, die Sie in dieser Klasse verwenden.

Die Vergleichsfunktion muss folgende Signatur haben:


     
         function [name](a:Object, b:Object, fields:Array = null):int

Diese Funktion muss Folgendes zurückgeben value:

  • -1, wenn das Object a vor dem Object b in der sortierten Sequenz erscheinen soll
  • 0, wenn Object a Object b entspricht
  • 1, wenn das Object a nach dem Object b in der sortierten Sequenz erscheinen soll

Um zur internen Vergleichsfunktion zurückzukehren, setzen Sie diesen Wert auf null.

Das fields-Array gibt die zu vergleichenden Objektfelder an. Normalerweise vergleicht der Algorithmus Eigenschaften, bis die Feldliste abgearbeitet wurde oder ein Wert ungleich null zurückgegeben werden kann. Beispiel:


        function myCompare(a:Object, b:Object, fields:Array = null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }

Der Standardwert ist eine interne Vergleichsfunktion, die einen Vergleich von Strings, numerischen Werten oder Datumsangaben in aufsteigender oder absteigender Reihenfolge durchführen kann. Geben Sie Ihre eigene Funktion nur an, wenn ein benutzerdefinierter Vergleichsalgorithmus erforderlich ist. Dies ist normalerweise nur der Fall, wenn ein berechnetes Feld in einer Anzeige verwendet wird.

Alternativ dazu können Sie für jedes Sortierfeld mithilfe der compareFunction-Eigenschaft der ISortField-Klasse eigene Vergleichsfunktionen festlegen. Auf diese Weise können Sie für bestimmte Felder den Standardvergleich und für andere Felder einen benutzerdefinierten Vergleich verwenden.

fields Ein Array von ISortField-Objekten, das die zu vergleichenden Felder angibt.null Ein Array von ISortField-Objekten, das die zu vergleichenden Felder angibt. Die Reihenfolge der ISortField-Objekte im Array bestimmt die Reihenfolge der Feldpriorität bei der Sortierung. Der Standardsortierkomparator prüft die Sortierfelder in der Arrayreihenfolge, bis eine Sortierreihenfolge für die beiden verglichenen Felder bestimmt werden kann. ISortFieldunique Gibt an, ob die Sortierung eindeutig sein soll.false Gibt an, ob die Sortierung eindeutig sein soll. Eindeutige Sortierungen schlagen fehl, wenn ein Wert oder kombinierter Wert, der von den im Feldeigenschaftenergebnis aufgeführten Feldern angegeben wird, eine unbestimmte oder nicht-eindeutige Sortierreihenfolge ergibt, d. h., wenn zwei oder mehr Elemente identische Sortierfeldwerte haben. Ein Fehler wird ausgegeben, wenn die Sortierung nicht eindeutig ist. Die Sortierungslogik verwendet diesen unique-Eigenschaftswert nur, wenn jedes Sortierfeld explizit festgelegt wird. Wenn kein Sortierfeld explizit festgelegt wird, wird kein Fehler ausgegeben, selbst wenn identische Wertelemente vorhanden sind. XMLListCollection Die XMLListCollection-Klasse stellt Sammlungsfunktionen für ein XMLList-Objekt bereit und macht einige der Methoden der nativen XMLList-Klasse verfügbar.The <mx:XMLListCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:XMLListCollection
  Properties
  source="null"
  />
]]>mx.collections:ListCollectionView Die XMLListCollection-Klasse stellt Sammlungsfunktionen für ein XMLList-Objekt bereit und macht einige der Methoden der nativen XMLList-Klasse verfügbar. XMLListXMLXMLListCollection Konstruktor.sourcenullDas XMLList-Objekt, das die Daten enthält, die vom XMLListCollection-Objekt dargestellt werden sollen. Konstruktor.

Erstellt mithilfe des angegebenen XMLList-Objekts ein neues XMLListCollection-Objekt.

attribute Ruft die attribute()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList der Ergebnisse zurück, die mit dem angegebenen attributeName übereinstimmen.Die XMLList von übereinstimmenden XML-Objekten. attributeNameDas Attribut, das in den XML-Objekten der XMLList übereinstimmen soll. Ruft die attribute()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList der Ergebnisse zurück, die mit dem angegebenen attributeName übereinstimmen. XML.attribute()attributes Ruft die attributes()-Methode jedes XML-Objekts im XMLList-Objekt auf und gibt für jedes XML-Objekt eine XMLList der Attribute zurück.Das XMLList-Objekt mit den resultierenden XML-Objekten, in dem die Attribute aufgelistet werden. Ruft die attributes()-Methode jedes XML-Objekts im XMLList-Objekt auf und gibt für jedes XML-Objekt eine XMLList der Attribute zurück. XML.attributes()child Ruft die child()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den sortierten untergeordneten Elementen und den angegebenen Eigenschaftsnamen zurück.Eine XMLList von übereinstimmenden untergeordneten Elementen der XML-Objekte in der Original-XMLList. propertyNameDie Eigenschaft, die gesucht wird. Ruft die child()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den sortierten untergeordneten Elementen und den angegebenen Eigenschaftsnamen zurück. XML.child()children Ruft die children()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück.Eine XMLList von untergeordneten Elementen der XML-Objekte in der Original-XMLList. Ruft die children()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück. XML.children()copy Gibt eine tiefe Kopie des XMLList-Objekts zurück.Eine Kopie des XMLList-Objekts. Gibt eine tiefe Kopie des XMLList-Objekts zurück. descendants Ruft die descendants()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück.XMLList der übereinstimmenden untergeordneten Elemente (direkt untergeordnete Elemente, wiederum untergeordnete Elemente usw.) der XML-Objekte in der Original-XMLList. name*Der Name des zu vergleichenden Elements. Ruft die descendants()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück. Der name-Parameter wird an die descendants()-Methode des XML-Objekts übergeben. Wenn Sie keinen Parameter angeben, wird der String „~~“ „~~“ an die descendants()-Methode übergeben. XML.descendants()elements Ruft die elements()-Methode jedes XML-Objekts in der XMLList auf.XMLList der übereinstimmenden untergeordneten Elemente der XML-Objekte in der Original-XMLList. name*Der Name des zu vergleichenden Elements. Ruft die elements()-Methode jedes XML-Objekts in der XMLList auf. Der name-Parameter wird an die elements()-Methode des XML-Objekts übergeben. Wenn Sie keinen Parameter angeben, wird der String „~~“ an die elements()-Methode übergeben. XML.elements()text Ruft die text()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück.Die XMLList, die das Ergebnis enthält. Ruft die text()-Methode jedes XML-Objekts in der XMLList auf und gibt eine XMLList mit den Ergebnissen zurück. XML.text()toString Gibt eine Stringdarstellung der XMLList zurück, indem die toString()-Methode für jedes XML-Objekt in der XMLList aufgerufen wird.Die Stringdarstellung des XMLList-Objekts. Gibt eine Stringdarstellung der XMLList zurück, indem die toString()-Methode für jedes XML-Objekt in der XMLList aufgerufen wird. Wenn die prettyPrinting-Eigenschaft der XML-Klasse auf true gesetzt ist, werden die Ergebnisse für jedes XML-Objekt in der XMLList durch das Wagenrücklaufzeichen getrennt. Andernfalls, wenn prettyPrinting auf false eingestellt ist, werden die Ergebnisse einfach aneinander angehängt, ohne trennendes Wagenrücklaufzeichen.

Die toString()-Methode entfernt Folgendes aus dem zurückgegebenen String für ein XML-Objekt mit einfachem Inhalt: Das Start-Tag, Attribute, Namespace-Deklarationen und das Ende-Tag. Verwenden Sie die toXMLString()-Methode, wenn Sie diese im zurückgegebenen String für XML-Objekte mit einfachem Inhalt beibehalten möchten.

XML.prettyPrintingtoXMLString Gibt eine Stringdarstellung der XMLList zurück, indem die toXMLString()-Methode für jedes XML-Objekt in der XMLList aufgerufen wird.Die Stringdarstellung der XMLList. Gibt eine Stringdarstellung der XMLList zurück, indem die toXMLString()-Methode für jedes XML-Objekt in der XMLList aufgerufen wird. Wenn die prettyPrinting-Eigenschaft der XML-Klasse auf true gesetzt ist, werden die Ergebnisse für jedes XML-Objekt in der XMLList durch das Wagenrücklaufzeichen getrennt. Andernfalls, wenn prettyPrinting auf false eingestellt ist, werden die Ergebnisse einfach aneinander angehängt, ohne trennendes Wagenrücklaufzeichen.

Die toString()-Methode behält Folgendes im zurückgegebenen String für ein XML-Objekt mit einfachem Inhalt bei: Das Start-Tag, Attribute, Namespace-Deklarationen und das Ende-Tag. Verwenden Sie die toString()-Methode, wenn Sie diese aus dem zurückgegebenen String für XML-Objekte mit einfachem Inhalt entfernen möchten.

XML.prettyPrintingsource Die zugrunde liegende XMLList für diese Sammlung. Die zugrunde liegende XMLList für diese Sammlung. Das XMLListCollection-Objekt stellt keine Änderungen dar, die Sie direkt am XMLList-Quellobjekt vornehmen. Verwenden Sie zum Modifizieren der Sammlung immer die XMLListCollection-Methode. IList Eine ordinal angelegte Sammlung von Elementen.flash.events:IEventDispatcher Eine ordinal angelegte Sammlung von Elementen. Sie stellt Methoden für den Zugriff und die Änderung basierend auf dem Index bereit.

Eine IList kann eine Ansicht von Daten sein, die von einer Remote-Position abgerufen wurden. Wenn eine Sammlung, die möglicherweise remote ist, bearbeitet wird, muss der Fall behandelt werden, dass Daten noch nicht verfügbar sind. Dies wird von ItemPendingError angezeigt.

Die ICollectionView-Instanz ist eine Alternative zu IList.

mx.collections.errors.ItemPendingErrormx.collections.ICollectionViewmx.collections.ListCollectionViewcollectionChange Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Wird ausgelöst, wenn IList auf irgendeine Weise aktualisiert wurde. addItemAt Fügt das Element an der angegebenen Indexposition hinzu.Wenn der Index kleiner als 0 oder größer als die Länge der Liste ist. RangeErrorRangeErroritemDas Element, das an der Indexposition platziert werden soll. indexDer Index, an den das Element platziert werden soll. 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. addItem Fügt das angegebene Element am Ende der Liste hinzu.itemDas hinzuzufügende Element. Fügt das angegebene Element am Ende der Liste hinzu. Entspricht addItemAt(item, length). getItemAt Ruft das Element am angegebenen Index ab.Wenn die Daten für diesen Index von einem Remote-Speicherort geladen werden müssen. ItemPendingErrormx.collections.errors:ItemPendingErrorWenn index < 0 oder index >= length. RangeErrorRangeErrorDas Element an diesem Index oder null, wenn keines vorhanden ist. indexDer Index in der Liste, aus der das Element abgerufen werden soll. prefetch0Ein 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. Ruft das Element am angegebenen Index ab. getItemIndex Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.Der Index des Elements oder -1, wenn das Element nicht in der Liste enthalten ist. itemDas zu suchende Element. 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.

itemUpdated Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.itemDas Element in der Ansicht, die aktualisiert wurde. propertynullDer Name der Eigenschaft, die aktualisiert wurde. oldValuenullDer alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.) newValuenullDer 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.) 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. mx.events.CollectionEventmx.events.PropertyChangeEventremoveAll Entfernt alle Elemente aus der Liste. 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 Entfernt das Element am angegebenen Index und gibt es zurück.Wenn der Index kleiner als 0 oder größer als die Länge ist. RangeErrorRangeErrorDas entfernte Element. indexDer Index, an dem das Element entfernt werden soll. 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. setItemAt Platziert das Element am angegebenen Index.Wenn der Index kleiner als 0 oder größer als die Länge ist. RangeErrorRangeErrorDas Element, das ersetzt wurde, oder null, wenn keines ersetzt wurde. itemDas neue Element, das am angegebenen Index platziert werden soll. indexDer Index, an den das Element platziert werden soll. Platziert das Element am angegebenen Index. Wenn sich bereits ein Element an diesem Index befand, wird es vom neuen Element ersetzt und zurückgegeben. toArray Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.Wenn die Daten noch nicht vollständig von einem Remote-Speicherort geladen wurden. ItemPendingErrormx.collections.errors:ItemPendingErrorAnschließend wird das Array. Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung. Diese Methode kann einen ItemPendingError ausgeben. length Die Anzahl der Elemente in dieser Sammlung. Die Anzahl der Elemente in dieser Sammlung. 0 bedeutet keine Elemente, -1 bedeutet, dass die Länge unbekannt ist. ListCollectionView Die ListCollectionView-Klasse fügt die Eigenschaften und Methoden der ICollectionView-Schnittstelle einem Objekt hinzu, das mit der IList-Schnittstelle kompatibel ist.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"
  />
]]>mx.collections:ICollectionViewmx.collections:IListmx.core:IMXMLObjectflash.utils:Proxy 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.

collectionChange Wird ausgelöst, wenn ICollectionView auf irgendeine Weise aktualisiert wurde.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Wird ausgelöst, wenn ICollectionView auf irgendeine Weise aktualisiert wurde. ListCollectionView Der ListCollectionView-Konstruktor.listmx.collections:IListnullDie IList, die diese ListCollectionView einschließen soll. Der ListCollectionView-Konstruktor. addAllAt Fügt der aktuellen Liste eine Liste von Elementen hinzu. Sie werden an dem Positionsindex eingefügt, der an die Funktion übergeben wurde. Wenn der Index kleiner als 0 oder größer als die Länge der Liste ist. RangeErrorRangeErroraddListmx.collections:IListDie Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen. indexDie Position der aktuellen Liste, an die die neuen Elemente platziert werden sollen. 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. addAll Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden. addListmx.collections:IListDie Liste von Elementen, die der aktuellen Liste hinzugefügt werden sollen. Fügt am Ende der aktuellen Liste eine Liste von Elementen in der Reihenfolge hinzu, in der sie übergeben werden. addEventListener typelisteneruseCapturefalsepriority0useWeakReferencefalse addItemAt Fügt das Element an der angegebenen Indexposition hinzu.itemDas Element, das an die Indexposition platziert werden soll. indexDer Index, an den das Element platziert werden soll. 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. addItem Fügt das angegebene Element am Ende der Liste hinzu.itemDas hinzuzufügende Element. Fügt das angegebene Element am Ende der Liste hinzu. Entspricht addItemAt(item, length). contains Gibt zurück, ob die Ansicht das angegebene Objekt enthält.Ist „true“, wenn die ICollectionView nach dem Anwenden von Filtern das Element enthält, andernfalls „false“. itemDas zu suchende Objekt. 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. enableAutoUpdate()mx.events.CollectionEventcreateCursor Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird.Eine neue IViewCursor-Implementierung. mx.collections:IViewCursor Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird. disableAutoUpdate Verhindert, dass Änderungen der Sammlung selbst und Elemente aus der Sammlung von der Ansicht verteilt werden. 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. mx.collections.ICollectionView.enableAutoUpdate()mx.events.CollectionEventdispatchEvent event enableAutoUpdate Aktiviert die automatische Aktualisierung. Aktiviert die automatische Aktualisierung. Weitere Informationen finden Sie unter disableAutoUpdate. mx.collections.ICollectionView.disableAutoUpdate()getItemAt Ruft das Element am angegebenen Index ab.Das Element an diesem Index oder null, wenn keines vorhanden ist. indexDer Index in der Liste, aus der das Element abgerufen werden soll. prefetch0Ein 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. Ruft das Element am angegebenen Index ab. getItemIndex Gibt den Index des Elements zurück, wenn es in der Liste enthalten ist, sodass gilt: getItemAt(Index) == Element.Der Index des Elements oder -1, wenn das Element nicht in der Liste enthalten ist. itemDas zu suchende Element. 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.

hasEventListener type initialized Wird automatisch vom MXML-Compiler aufgerufen, wenn die ListCollectionView mithilfe eines MXML-Tags erstellt wird.documentDas MXML-Dokument, das dieses ListCollectionView-Objekt enthält. idIgnoriert. 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. itemUpdated Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.itemDas Element in der Ansicht, die aktualisiert wurde. propertynullDer Name der Eigenschaft, die aktualisiert wurde. oldValuenullDer alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.) newValuenullDer 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.) 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. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Wendet die Sortierung und den Filter auf die Ansicht an.true, wenn refresh() abgeschlossen wurde, false, wenn refresh() nicht abgeschlossen wurde. 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.

removeAll Entfernt alle Elemente aus der Liste. Entfernt alle Elemente aus der Liste. removeEventListener typelisteneruseCapturefalse removeItemAt Entfernt das Element am angegebenen Index und gibt es zurück.Das entfernte Element. indexDer Index, an dem das Element entfernt werden soll. 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. setItemAt Platziert das Element am angegebenen Index.Das Element, das ersetzt wurde, oder null, wenn keines ersetzt wurde. itemDas neue Element, das am angegebenen Index platziert werden soll. indexDer Index, an den das Element platziert werden soll. Platziert das Element am angegebenen Index. Wenn sich bereits ein Element an diesem Index befand, wird es vom neuen Element ersetzt und zurückgegeben. toArray Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung.Anschließend wird das Array. Gibt ein Array zurück, das in derselben Reihenfolge gefüllt wird wie die IList-Implementierung. Diese Methode kann einen ItemPendingError ausgeben. toString Gibt den Inhalt dieser Ansicht als String aus und gibt ihn zurück.Der Inhalt dieser Ansicht in Stringform. Gibt den Inhalt dieser Ansicht als String aus und gibt ihn zurück. willTrigger type localIndex 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. 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. filterFunction Eine Funktion, die von der Ansicht verwendet wird, um Elemente zu entfernen, die die Funktionskriterien nicht erfüllen. 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.

aktualisieren()length Die Anzahl der Elemente in dieser Ansicht. Die Anzahl der Elemente in dieser Ansicht. 0 bedeutet keine Elemente, -1 bedeutet, dass die Länge unbekannt ist. list Die IList, die diese Sammlung einschließt.mx.collections:IList Die IList, die diese Sammlung einschließt. sort Das ISort-Objekt, das auf die ICollectionView angewendet wird.mx.collections:ISort 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.

aktualisieren()ICollectionView Eine ICollectionView ist eine Ansicht auf eine Sammlung von Daten.flash.events:IEventDispatcher Eine ICollectionView ist eine Ansicht einer Sammlung von Daten. Die Ansicht kann modifiziert werden, um die Daten nach verschiedenen Kriterien sortiert oder durch Filter verringert anzuzeigen, ohne die zugrunde liegenden Daten zu ändern. Ein IViewCursor bietet Zugriff auf Elemente in einer Sammlung. Sie können die Sammlung mithilfe der Methoden insert() und remove() der IViewCursor-Schnittstelle modifizieren.

Eine ICollectionView kann eine Ansicht von Daten sein, die von einer Remote-Position abgerufen wurden. Wenn diese Schnittstelle für Daten implementiert wird, die möglicherweise remote gespeichert sind, muss der Fall berücksichtigt werden, wo Daten ggf. noch nicht verfügbar sind. Dies wird durch ItemPendingError angezeigt.

Die IList-Schnittstelle ist eine Alternative zur ICollectionView-Schnittstelle.

mx.collections.IViewCursormx.collections.errors.ItemPendingErrormx.collections.IListcollectionChange Wird ausgelöst, wenn ICollectionView auf irgendeine Weise aktualisiert wurde.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Wird ausgelöst, wenn ICollectionView auf irgendeine Weise aktualisiert wurde. contains Gibt zurück, ob die Ansicht das angegebene Objekt enthält.Ist „true“, wenn die ICollectionView nach dem Anwenden von Filtern das Element enthält, andernfalls „false“. itemDas zu suchende Objekt. 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. createCursor Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird.Eine neue IViewCursor-Implementierung. mx.collections:IViewCursor Erstellt einen neuen IViewCursor, der mit dieser Ansicht verwendet wird. disableAutoUpdate Verhindert, dass Änderungen der Sammlung selbst und Elemente aus der Sammlung von der Ansicht verteilt werden. 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. enableAutoUpdate Aktiviert die automatische Aktualisierung. Aktiviert die automatische Aktualisierung. Weitere Informationen finden Sie unter disableAutoUpdate. disableAutoUpdate()itemUpdated Informiert die Ansicht darüber, dass ein Element aktualisiert wurde.itemDas Element in der Ansicht, die aktualisiert wurde. propertynullDer Name der Eigenschaft, die aktualisiert wurde. oldValuenullDer alte Wert dieser Eigenschaft. (Wenn die Eigenschaft „null“ war, kann dies der alte Wert des Elements sein.) newValuenullDer 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.) 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. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Wendet die Sortierung und den Filter auf die Ansicht an.true, wenn refresh() abgeschlossen wurde, false, wenn refresh() nicht abgeschlossen wurde. 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.

filterFunction Eine Funktion, die von der Ansicht verwendet wird, um Elemente zu entfernen, die die Funktionskriterien nicht erfüllen. 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.

aktualisieren()length Die Anzahl der Elemente in dieser Ansicht. Die Anzahl der Elemente in dieser Ansicht. 0 bedeutet keine Elemente, -1 bedeutet, dass die Länge unbekannt ist. sort Das ISort-Objekt, das auf die ICollectionView angewendet wird.mx.collections:ISort 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.

aktualisieren()CursorBookmark Fasst die Positionsaspekte eines Cursor in einer ICollectionView zusammen.Object Fasst die Positionsaspekte eines Cursors in einer ICollectionView zusammen. Lesezeichen werden verwendet, um einen Cursor an eine absolute Position innerhalb der ICollectionView zurückzuversetzen. mx.collections.IViewCursor.bookmarkmx.collections.IViewCursor.seek()CursorBookmark Erstellt eine neue Instanz eines Lesezeichens mit dem angegebenen Wert.valueDer Wert dieses Lesezeichens. Erstellt eine neue Instanz eines Lesezeichens mit dem angegebenen Wert. getViewIndex Ruft den ungefähren Index des Elements ab, der von diesem Lesezeichen in seiner Ansicht dargestellt wird.Der Index des Elements. Wenn das Element nicht in der aktuellen Ansicht enthalten ist, gibt diese Methode -1 zurück. Diese Methode gibt auch -1 zurück, wenn die auf dem Index basierende Position nicht möglich ist. Ruft den ungefähren Index des Elements ab, der von diesem Lesezeichen in seiner Ansicht dargestellt wird. Wenn das Element ausgelagert wurde, kann diese Methode einen ItemPendingError ausgeben. CURRENT Ein Lesezeichen, das das aktuelle Element für den IViewCursor in einer ICollectionView darstellt.mx.collections:CursorBookmark Ein Lesezeichen, das das aktuelle Element für den IViewCursor in einer ICollectionView darstellt. FIRST Ein Lesezeichen, das das erste Element in einer ICollectionView darstellt.mx.collections:CursorBookmark Ein Lesezeichen, das das erste Element in einer ICollectionView darstellt. LAST Ein Lesezeichen, das das letzte Element in einer ICollectionView darstellt.mx.collections:CursorBookmark Ein Lesezeichen, das das letzte Element in einer ICollectionView darstellt. Wenn die Ansicht keine Elemente enthält, befindet sich der Cursor an diesem Lesezeichen. value Die zugrunde liegende Markierungsdarstellung des Lesezeichens. Die zugrunde liegende Markierungsdarstellung des Lesezeichens. Dieser Wert wird im Allgemeinen nur von der IViewCursor- oder ICollectionView-Implementierung verstanden. IViewCursor Definiert die Schnittstelle zur bidirektionalen Aufzählung einer hierarchischen Sammlungsansicht.flash.events:IEventDispatcher Definiert die Schnittstelle zur bidirektionalen Aufzählung einer hierarchischen Sammlungsansicht. Dieser Cursor stellt Such- und Lesezeichenfunktionen sowie die Änderungsmethoden „insert“ und „remove“ bereit. Wenn ein Cursor aus einer Ansicht abgerufen wird (normalerweise mit der createCursor()-Methode von ICollectionView) sollte der Wert der current-Eigenschaft das erste Element in der Ansicht sein, außer die Ansicht ist leer. cursorUpdate Wird ausgelöst, wenn die Cursorposition aktualisiert wird.mx.events.FlexEvent.CURSOR_UPDATEmx.events.FlexEvent Wird ausgelöst, wenn die Cursorposition aktualisiert wird. findAny Sucht in der Sammlung ein Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element.Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false. valuesDie Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x, y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein. Sucht in der Sammlung ein Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.

Die findAny()-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError ausgegeben.

Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.

Wenn mehrere Elemente die Suchkriterien erfüllen, ist das gefundene Elemente nicht-deterministisch. Wenn es wichtig ist, das erste oder letzte Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findFirst()- oder findLast()-Methode.

Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.

findFirst()findLast()mx.collections.errors.ItemPendingErrorfindFirst Sucht in der Sammlung das erste Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element.Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false. valuesDie Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x, y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein. Sucht in der Sammlung das erste Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.

Die findFirst()-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError ausgegeben.

Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.

Wenn es nicht wichtig ist, das erste Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findAny()-Methode, die möglicherweise ein wenig schneller ist als die findFirst()-Methode.

Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.

findAny()findLast()mx.collections.errors.ItemPendingErrorfindLast Sucht in der Sammlung das letzte Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element.Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false. valuesDie Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x, y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein. Sucht in der Sammlung das letzte Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.

Die findLast()-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError ausgegeben.

Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.

Wenn es nicht wichtig ist, das letzte Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findAny()-Methode, die möglicherweise ein wenig schneller ist.

Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.

findAny()findFirst()mx.collections.errors.ItemPendingErrorinsert Fügt das angegebene Element vor der aktuellen Cursor-Position ein.itemDas Element, das vor der aktuellen Cursor-Position eingefügt werden soll. Fügt das angegebene Element vor der aktuellen Cursor-Position ein. Wenn der Cursor afterLast ist, erfolgt die Einfügung am Ende der Ansicht. Wenn der Cursor bei einer nicht leeren Ansicht beforeFirst ist, wird ein Fehler ausgegeben. moveNext Verschiebt den Cursor auf das nächste Element in der Sammlung.true, wenn noch in der Liste, false, wenn current ursprünglich den Wert afterLast hatte oder diesen Wert aktuell hat. Verschiebt den Cursor auf das nächste Element in der Sammlung. Bei Erfolg wird die Eigenschaft current aktualisiert, um das Objekt an dieser neuen Position zu referenzieren. Gibt true zurück, wenn die resultierende Eigenschaft current gültig ist, andernfalls false (der Eigenschaftswert ist afterLast).

Wenn die Daten nicht lokal sind 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.

 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      while (!cursor.afterLast)
      {
          trace(cursor.current);
          cursor.moveNext();
      }
currentmovePrevious()mx.collections.errors.ItemPendingErrormovePrevious Verschiebt den Cursor auf das vorherige Element in der Sammlung.true, wenn noch in der Liste, false, wenn current ursprünglich den Wert beforeFirst hatte oder diesen Wert aktuell hat. Beispiel: 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      cursor.seek(CursorBookmark.last);
      while (!cursor.beforeFirst)
      {
          trace(current);
          cursor.movePrevious();
      }
Verschiebt den Cursor auf das vorherige Element in der Sammlung. Bei Erfolg wird die Eigenschaft current aktualisiert, um das Objekt an dieser neuen Position zu referenzieren. Gibt true zurück, wenn die resultierende Eigenschaft current gültig ist, andernfalls false (der Eigenschaftswert ist beforeFirst).

Wenn die Daten nicht lokal sind 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.

currentmoveNext()mx.collections.errors.ItemPendingErrorremove Entfernt das aktuelle Elemente und gibt es zurück.Das entfernte Element. Entfernt das aktuelle Elemente und gibt es zurück. Wenn die Cursorposition beforeFirst oder afterLast ist, gibt die Methode einen CursorError aus. Wenn Sie ein anderes Element als das letzte Element entfernen, wird der Cursor zum nächsten Element verschoben. Wenn Sie das letzte Element entfernen, befindet sich der Cursor beim AFTER_LAST-Lesezeichen.

Wenn die Daten nach dem entfernten Element nicht lokal sind 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.

mx.collections.errors.ItemPendingErrorseek Verschiebt den Cursor an eine Position an einem Offset vom angegebenen Lesezeichen.bookmarkmx.collections:CursorBookmarkCursorBookmark-Verweis auf Markeninformationen, die eine Neuplatzierung an einer bestimmten Position ermöglichen. Sie können diesen Parameter auf den Wert setzen, der von der bookmark-Eigenschaft zurückgegeben wurde, oder auf einen der folgenden konstanten Lesezeichenwerte:
  • CursorBookmark.FIRST - Vom Beginn der Sammlung aus (erstes Element) suchen
  • CursorBookmark.CURRENT - Von der aktuellen Position der Sammlung aus suchen
  • CursorBookmark.LAST - Vom Ende der Sammlung aus (letztes Element) suchen
offset0Gibt an, wie weit vom angegebenen Lesezeichen gesucht werden soll. Wenn die angegebene Zahl negativ ist, versucht der Cursor, sich vor dem angegebene Lesezeichen zu platzieren. Wenn der angegebene Offset sich nach dem Ende der Sammlung befindet, wird der Cursor hinter das Ende platziert, an die Position beforeFirst oder afterLast. prefetch0Wird für Remote-Daten verwendet. Gibt eine Priorität an, die Sammlung in einer angegebene Richtung zu durchlaufen, wenn der Suchvorgang abgeschlossen wurde. Dies verringert die Anzahl der erforderlichen Netzwerk-Roundtrips bei einer Suche. Wenn die Durchlaufrichtung zum Zeitpunkt der Anforderung bekannt ist, kann die geeignete Datenmenge zurückgegeben werden, bevor die Anforderung die Daten durchläuft. Verschiebt den Cursor an eine Position an einem Offset vom angegebenen Lesezeichen. Der Offset kann negativ sein. In diesem Fall wird der Cursor um die in offset angegebene Anzahl von Elementen vor dem angegebenen Lesezeichen platziert.

Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung.

Wenn die Daten nicht lokal sind 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.

mx.collections.errors.ItemPendingErrorafterLast Wenn der Cursor sich hinter dem letzten Element in der Ansicht befindet, ist diese Eigenschaft „true“. Wenn der Cursor sich hinter dem letzten Element in der Ansicht befindet, ist diese Eigenschaft true. Wenn die ICollectionView leer ist (length == 0), ist diese Eigenschaft true. beforeFirst Wenn der Cursor sich vor dem ersten Element in der Ansicht befindet, ist diese Eigenschaft „true“. Wenn der Cursor sich vor dem ersten Element in der Ansicht befindet, ist diese Eigenschaft true. Wenn die ICollectionView leer ist (length == 0), ist diese Eigenschaft true. bookmark Bietet Zugriff auf ein Lesezeichen, das dem von der aktuellen Eigenschaft zurückgegebenen Element entspricht.mx.collections:CursorBookmark Bietet Zugriff auf ein Lesezeichen, das dem von der current-Eigenschaft zurückgegebenen Element entspricht. Das Lesezeichen kann verwendet werden, um den Cursor an ein zuvor besuchtes Element oder eine Position relativ zu diesem Element zu verschieben. (Weitere Informationen finden Sie unter der seek()-Methode.) currentseek()current Bietet Zugriff auf das Objekt an der Position in der Quellsammlung, die von diesem Cursor referenziert wird. Bietet Zugriff auf das Objekt an der Position in der Quellsammlung, die von diesem Cursor referenziert wird. Wenn der Cursor sich hinter dem Ende der Sammlung befindet (beforeFirst, afterLast) wird null zurückgegeben. moveNext()movePrevious()seek()beforeFirstafterLastview Ein Verweis auf die ICollectionView, der dieser Cursor zugeordnet ist.mx.collections:ICollectionView Ein Verweis auf die ICollectionView, der dieser Cursor zugeordnet ist.