Sort  - AS3 Flex

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

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

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

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

• -1, если в отсортированной последовательности объект А должен предшествовать объекту B.
• 0, если объект А совпадает с объектом B.
• 1, если в отсортированной последовательности объект А должен следовать за объектом 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;
        }
      

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

Также для каждого поля сортировки можно указать отдельную функцию сравнения с помощью используемого в классе ISortField свойства compareFunction. При этом для одних полей используется сравнение по умолчанию, а для других - пользовательское сравнение.

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

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

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие fieldsChanged .

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

Указывает, должна ли сортировка быть уникальной. Уникальная сортировка завершается ошибкой, если какое-либо значение или объединенное значение, указанные в полях, перечисленных в свойствах полей, приводят к неопределенной или неуникальной последовательности сортировки, т. е. если два и более элемента имеют идентичные значения полей сортировки. Если сортировка не является уникальной, вызывается ошибка. Логика сортировки использует значение свойства unique только в случае, когда поля сортировки указаны явным образом. Если ни одно из полей сортировки не указано явным образом, ошибка не выводится даже при наличии элементов с идентичными значениями.

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

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

Создает новую сортировку без установленных полей и пользовательского устройства сравнения.

Поиск указанного объекта в пределах определенного массива (или места вставки при запросе); при обнаружении возвращается индекс, в противном случае – -1. Используемые в классе ListCollectionView методы findxxx() применяют этот способ для определения запрашиваемого элемента. Как правило, проще использовать эти функции вместо findItem() для поиска данных в объектах на основе ListCollectionView. Метод findItem() можно вызвать непосредственно при создании класса, например новой реализации ICollectionView, который поддерживает сортировку. Перед вызовом этой функции необходимо выполнить сортировку входного массива элементов. В противном случае эта функция не сможет правильно определить указанное значение.

Параметры

Возвращает значение, показывающее используется ли указанное свойство для управления сортировкой. Если сортировка использует пользовательское средство сравнения, то функция не может определить окончательный ответ и всегда возвращает значение true.

Параметры

Проходит через массив fields и вызывает reverse() для каждого объекта ISortField в массиве. Поле по нисходящей теперь становится полем по восходящей и наоборот.

Примечание. ICollectionView не обновляется автоматически при изменении объектов в массиве fields; для обновления представления следует вызвать метод refresh().

Применяет текущую сортировку к указанному массиву (не копии). Для предотвращения изменения массива следует создать копию в параметре items.

Реализации ICollectionView в Flex автоматически вызывают метод sort и обеспечивают выполнение сортировки в копии основных данных.

Параметры

При нахождении возвращает индекс любого соответствующего элемента.

При выполнении поиска возвращает индекс первого совпадающего элемента.

При выполнении поиска возвращает индекс последнего совпадающего элемента.