| Пакет | 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():intcompareFunction | свойство |
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):voiddescending | свойство |
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):voidname | свойство |
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):voidusingCustomCompareFunction | свойство |
usingCustomCompareFunction:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
True, если ISortField использует пользовательскую функцию средства сравнения.
Реализация
public function get usingCustomCompareFunction():BooleaninitializeDefaultCompareFunction | () | метод |
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