Sort  - AS3 Flex

用于在排序时比较项目的方法。如果指定了此属性，Flex 会忽略在此类中使用的 ISortField 对象中指定的所有 compareFunction 属性。

该比较函数必须具有以下签名：

     
         function [name](a:Object, b:Object, fields:Array = null):int
     
      

此函数必须返回以下值：

• -1，如果在已排序序列中 Object a 应显示在 Object b 之前。
• 0，如果 Object a 等于 Object b。
• 1，如果在已排序序列中 Object a 应显示在 Object b 之后。

要返回到内部比较函数，请将此值设置为 null。

fields 数组会指定要比较的对象字段。通常，算法将一直比较属性，直到用尽字段列表或能返回非零值。例如：

        function myCompare(a:Object, b:Object, fields:Array = null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }
      

默认值为可以按升序或降序执行字符串、数字或日期比较的内部比较函数。仅在需要自定义比较算法时指定您自己的函数。这种情况通常仅当在显示中使用计算的字段时出现。

或者，您可以通过使用 ISortField 类的 compareFunction 属性分别为每个排序字段指定比较函数；这样，您可以对一些字段使用默认比较，而对其它字段使用自定义比较。

指定要比较的字段的 ISortField 对象的 Array。在进行排序时，数组中 ISortField 对象的顺序确定字段的优先级顺序。默认排序比较运算符会一直检查数组顺序中的排序字段，直到确定了两个要比较的字段的排序顺序。

默认值为 null。

此属性可用作数据绑定的源。修改此属性后，将调度 fieldsChanged 事件。

相关 API 元素

指示排序是否应是唯一的。如果字段属性中列出的字段指定的任何值或组合值导致不确定或非唯一的排序顺序，则唯一排序会失败；也就是说，在两个或多个项目具有相同排序字段值时会出现此情况。如果排序不唯一，将引发错误。仅当显式指定排序字段时，排序逻辑才使用该 unique 属性值。如果未显式指定排序字段，则具有相同值元素时也不会引发错误。

默认值为 false。

构造函数。

创建一个不带字段集和自定义比较运算符的新 Sort。

查找指定的数组内的指定对象（或插入点 — 如有要求）。如果找到，则返回其索引；如果未找到，则返回 -1。ListCollectionView 类的 findxxx() 方法使用此方法查找所需项目；一般来说，与 findItem() 相比，使用这些函数更易于在基于 ListCollectionView 的对象中查找数据。您可以在写入支持排序的类（如新的 ICollectionView 实现）时直接调用 findItem() 方法。调用该函数前需要对输入项数组进行排序。否则该函数无法正确找到指定值。

参数

返回表明指定的属性是否用于控制排序的布尔值。如果排序使用自定义比较运算符，则函数无法确定确切的答案；在这种情况下，始终返回 true。

参数

检查 fields 数组，对数组中每个 ISortField 对象调用 reverse()。如果该字段原来为降序排序，则现在它将按升序排序，反之亦然。

注意：修改 fields 数组中的对象时不会自动更新 ICollectionView；而调用 refresh() 方法可更新此视图。

对指定的数组（不是副本）应用当前排序。要防止修改数组，请创建一个副本并在 items 参数中使用该副本。

Flex ICollectionView 实现自动调用 sort 方法并确保对基础数据的副本执行排序。

参数

执行查找时返回任何匹配项的索引。

执行查找时返回第一个匹配项的索引。

执行查找时返回最后一个匹配项的索引。