SortField  - AS3 Flex

Это вспомогательное свойство используется на внутреннем уровне методами findItem() и sort(). Другое использование этого свойства не поддерживается. Возвращает -1, если ISortField не может использоваться в классе Sort для сортировки поля (отсутствует compareFunction или имя). В противном случае возвращает битовую маску параметров сортировки.

Указывает, должна ли сортировка для данного поля зависеть от регистра.

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

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

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

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

функция myCompare(a:Object, b:Object):int

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

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

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

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

Указывает, следует ли сортировать данное поле в порядке убывания.

Значение по умолчанию равно false (в порядке возрастания).

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

Имя поля для сортировки.

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

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

Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.

Это свойство используется в классе SortField, если не указана пользовательская функция сравнения.

Если для этого свойства установлено значение true, то используется встроенная функция числового сравнения. Перед сравнением каждому элементу данных присваивается функция Number().

Если для этого свойства установлено значение false, то используется встроенная функция сравнения строк. Перед сравнением каждому элементу данных присваивается функция String().

Если это свойство равно null, то анализируется первый элемент данных для определения, является он числом или строкой, после чего сортировка продолжается на основании этого анализа.

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

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

True, если ISortField использует пользовательскую функцию средства сравнения.

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

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

Параметры

Задает обратный порядок критериев для данного поля сортировки. Например, если поле сортировалось в порядке убывания, оно будет отсортировано в порядке возрастания.

ПРИМЕЧАНИЕ. ICollectionView не обновляется автоматически при изменении ISortFields; для обновления представления следует вызвать метод refresh().