Sort  - AS3 Flex

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.

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.

Der Standardwert ist null.

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

Verwandte API-Elemente

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.

Der Standardwert ist false.

Konstruktor.

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

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.

Parameter

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.

Parameter

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.

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.

Parameter

Bei der Ausführung einer Suche den Index für alle übereinstimmenden Elemente zurückgeben.

Bei der Ausführung einer Suche den Index für das erste übereinstimmende Element zurückgeben.

Bei der Ausführung einer Suche den Index für das letzte übereinstimmende Element zurückgeben.