| 包 | 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):voiddescending | 属性 | 
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):voidusingCustomCompareFunction | 属性 | 
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