Grouping  - 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 SortField-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:

• -1, wenn a in der sortierten Sequenz vor b erscheinen soll.
• 0, wenn a gleich b ist.
• -1, wenn a in der sortierten Sequenz nach b 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, 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.

Alternativ dazu können Sie für jedes Sortierfeld mithilfe der compare-Eigenschaft der SortField-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 GroupingField-Objekten, das die Felder festlegt, die zum Gruppieren der Daten verwendet werden. Die Reihenfolge der GroupingField-Objekte im Array bestimmt die Reihenfolge der Feldpriorität bei der Sortierung.

Der Standardwert ist null.

Verwandte API-Elemente

Eine Callback-Funktion, die für jeden Gruppenknoten zum Bestimmen des Gruppierungsobjekts ausgeführt werden soll. Standardmäßig wird für Gruppenknoten ein neues Objekt erstellt.

Sie können eine groupingObjectFunction angeben, die das geeignete Objekt für Gruppenknoten bereitstellt.

Die Methodensignatur lautet wie folgt:

      myGroupObjectFunction(label:String):Object

Dabei enthält label den Wert, der für diesen Gruppenknoten angezeigt wird. Die Funktion gibt ein Objekt zurück, das für Gruppenknoten verwendet wird.

      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

Der Name des Felds, das den flachen Daten hinzugefügt werden soll, um die Hierarchie zu erstellen. Von dieser Eigenschaft wird der Wert des Knotens der obersten Ebene (Knoten, die die Gruppenfelder darstellen) in jeder Gruppe dargestellt. Mit dieser Eigenschaft können Sie einen anderen Namen angeben.

Der Standardwert ist GroupLabel.

Konstruktor.