Grouping  - AS3 Flex

Метод, используемый для сравнения элементов при сортировке. При указании этого свойства Flex игнорирует любые свойства compareFunction, которые указаны в объектах SortField, используемых в этом классе.

Функция сравнения должна иметь следующую подпись:

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

Эта функция должна возвращать следующее:

• -1, если a должно появиться перед b в сортированной последовательности;
• 0, если a равно b;
• 1, если a должно появиться после b в сортированной последовательности.

Для возврата внутренней функции сравнения следует установить это значение равным null.

Массив fields указывает поля объекта для сравнения. Как правило, алгоритм сравнивает свойства до тех пор, пока не будет исчерпан список полей, или не появится возможность возврата ненулевого значения. Например:

        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;
        }

Значение по умолчанию представляет собой внутреннюю функцию сравнения, которая может выполнять сравнение строк, чисел или дат в восходящем или нисходящем порядке, с учетом или без учета регистра. Указывать собственную функцию следует только в том случае, если необходим пользовательский алгоритм сравнения. Обычно он применяется только в том только случае, если в отображении используется вычисленное поле.

Также можно указать отдельные функции сравнения для каждого поля сортировки с помощью свойства compare класса SortField. Подобным образом можно использовать сравнение по умолчанию для одних полей и пользовательское сравнение для других.

Массив объектов GroupingField, определяющий поля, используемые для группировки данных. Порядок объектов GroupingField в массиве определяет приоритетный порядок полей при сортировке.

Значением по умолчанию является null.

Связанные элементы API

Функция обратного вызова для запуска в каждом узле группы при определении объекта группировки. По умолчанию для узлов группы создается новый объект.

Можно ввести функцию groupingObjectFunction, предоставляющую соответствующий объект для узлов группы.

Подпись метода:

      myGroupObjectFunction(label:String):Object

где в label содержится значение, которое будет показано для данного узла группы. Функция возвращает объект, используемый для узлов группы.

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

Имя поля, добавляемого к плоским данным для создания иерархии. Значение верхних узлов (узлов, представляющих поля группы) в каждой группе будет представлено этим свойством. Это свойство следует использовать для указания другого имени.

Значением по умолчанию является GroupLabel.

Конструктор.