包 | 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 [只读]
如果此 ISortField 使用自定义比较运算符函数,则为 true。 | ISortField |
方法 | 由以下参数定义 | ||
---|---|---|---|
设置默认比较函数以执行比较时,Sort 类将根据以下三项内容之一来调用帮助器函数:是否已设置自定义比较函数、指定字段的数据类型或 numeric 属性的值。 | ISortField | ||
反转此排序字段的条件。 | ISortField |
arraySortOnOptions | 属性 |
compareFunction | 属性 |
compareFunction:Function
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4.5 |
运行时版本: | Flash Player 9, AIR 1.1 |
用于在对关联集合的项目进行排序时比较两个项目的函数。如果指定了 ISort 对象中的 compareFunction
属性,则 Flex 会忽略 ISort 的 ISortField 对象的所有 compareFunction
属性。
该比较函数必须具有以下签名:
function 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 | 属性 |
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 | 属性 |
initializeDefaultCompareFunction | () | 方法 |
public function initializeDefaultCompareFunction(obj:Object):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4.5 |
运行时版本: | Flash Player 9, AIR 1.1 |
设置默认比较函数以执行比较时,Sort
类将根据以下三项内容之一来调用帮助器函数:是否已设置自定义比较函数、指定字段的数据类型或 numeric 属性的值。如果 numeric
属性为 true,将在排序时执行数字比较。
参数
obj:Object — 包含数据的对象。如果已通过 name 属性设置了字段名称,则将使用该名称访问此对象的数据值。否则,将使用对象本身作为数据值。
|
reverse | () | 方法 |
public function reverse():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4.5 |
运行时版本: | Flash Player 9, AIR 1.1 |
反转此排序字段的条件。例如,如果该字段原来按降序排序,则现在按升序排序。
注意:修改 ISortFields
时不会自动更新 ICollectionView
;而调用 refresh()
方法可更新此视图。
Tue Jun 12 2018, 11:04 AM Z