Пакет | mx.collections |
Интерфейс | public interface ISortField |
Средство реализации | SortField, SortField |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
ISortField
определяет интерфейс для классов, которые используются с классами ISort
и предоставляет информацию, необходимую для сортировки определенных полей или свойств в представлении коллекции.
Свойство | Определено | ||
---|---|---|---|
arraySortOnOptions : int [только для чтения]
Это вспомогательное свойство используется на внутреннем уровне методами findItem() и sort(). | ISortField | ||
compareFunction : Function
Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. | ISortField | ||
descending : Boolean
Указывает, следует ли сортировать данное поле в порядке убывания. | ISortField | ||
name : String
Имя поля для сортировки. | ISortField | ||
numeric : Object
Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение. | ISortField | ||
usingCustomCompareFunction : Boolean [только для чтения]
True, если для ISortField указана пользовательская функция средства сравнения. | ISortField |
Метод | Определено | ||
---|---|---|---|
Вспомогательная функция, которую вызывает класс Sort, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства. | ISortField | ||
Задает обратный порядок критериев для данного поля сортировки. | ISortField |
arraySortOnOptions | свойство |
arraySortOnOptions:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Это вспомогательное свойство используется на внутреннем уровне методами findItem()
и sort()
. Другое использование этого свойства не поддерживается. Возвращает -1, если ISortField не может использоваться в классе Sort
для сортировки поля (отсутствует compareFunction или имя). В противном случае возвращает битовую маску параметров сортировки.
Реализация
public function get arraySortOnOptions():int
compareFunction | свойство |
compareFunction:Function
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. При указании свойства compareFunction
для объекта ISort Flex игнорирует любые свойства compareFunction
объектов ISortField в ISort.
Функция сравнения должна иметь следующую подпись:
функция myCompare(a:Object, b:Object):int
Эта функция возвращает следующие значения:
- -1, если
a
должно появиться доb
в сортированной последовательности; - 0, если
a
равноb
; - 1, если
a
должно появиться послеb
в сортированной последовательности.
Реализация
public function get compareFunction():Function
public function set compareFunction(value:Function):void
descending | свойство |
descending:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, следует ли сортировать данное поле в порядке убывания.
Значение по умолчанию равно false
(в порядке возрастания).
Реализация
public function get descending():Boolean
public function set descending(value:Boolean):void
name | свойство |
numeric | свойство |
numeric:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, что если сортируемое поле содержит числовые значения (number/int/uint
) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.
Это свойство используется в классе SortField
, если не указана пользовательская функция сравнения.
Если для этого свойства установлено значение true
, то используется встроенная функция числового сравнения. Перед сравнением каждому элементу данных присваивается функция Number()
.
Если для этого свойства установлено значение false
, то используется встроенная функция сравнения строк. Перед сравнением каждому элементу данных присваивается функция String()
.
Если это свойство равно null
, то анализируется первый элемент данных для определения, является он числом или строкой, после чего сортировка продолжается на основании этого анализа.
Значением по умолчанию является null.
Реализация
public function get numeric():Object
public function set numeric(value:Object):void
usingCustomCompareFunction | свойство |
usingCustomCompareFunction:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
True, если ISortField
использует пользовательскую функцию средства сравнения.
Реализация
public function get usingCustomCompareFunction():Boolean
initializeDefaultCompareFunction | () | метод |
public function initializeDefaultCompareFunction(obj:Object):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вспомогательная функция, которую вызывает класс Sort
, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства. Если свойство numeric
имеет значение true, то при сортировке будет выполняться числовое сравнение.
Параметры
obj:Object — Объект , содержащий данные. Если для указания имени поля использовалось свойство Name, то это имя будет использоваться для доступа к значению данных из этого объекта. В противном случае в качестве значения данных будет использован непосредственный объект.
|
reverse | () | метод |
public function reverse():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает обратный порядок критериев для данного поля сортировки. Например, если поле сортировалось в порядке убывания, оно будет отсортировано в порядке возрастания.
ПРИМЕЧАНИЕ. ICollectionView
не обновляется автоматически при изменении ISortFields
; для обновления представления следует вызвать метод refresh()
.
Tue Jun 12 2018, 11:34 AM Z