Grouping  - AS3 Flex

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

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

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

此函数必须返回以下值：

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

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

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

        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;
        }

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

或者，您可以使用 SortField 类的 compare 属性为每个排序字段指定单独的比较函数。这样，您可以对某些字段使用默认比较，而对其他字段使用自定义比较。

指定用于对数据进行分组的字段的 GroupingField 对象 Array。在进行排序时，Array 中 GroupingField 对象的顺序确定字段的优先级顺序。

默认值为 null。

相关 API 元素

在每个组节点上运行以确定分组对象的回调函数。默认情况下，将为组节点创建新 Object。

您可以提供 groupingObjectFunction，它可以为组节点提供合适的对象。

方法签名为：

      myGroupObjectFunction(label:String):Object

其中 label 包含将为该组节点显示的值。该函数返回将用于组节点的 Object。

      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

添加到平面数据以创建层次结构的字段的名称。每个组中顶部节点（表示组字段的节点）的值由此属性提供。使用此属性指定一个不同的名称。

默认值为 GroupLabel。

构造函数。