GroupingField  - AS3 Flex

如果此字段的排序不区分大小写，则设置为 true。

默认值为 false。

用于在对关联集合的项目进行排序时比较两个项目的函数。如果指定了 Grouping 对象中的 compareFunction 属性，则 Flex 会忽略 GroupingField 对象的所有 compareFunction 属性。

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

function myCompare(a:Object, b:Object):int

此函数必须返回以下值：

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

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

如果此字段的排序应为降序排序，则设置为 true。

默认值为 false。

确定此组的标签的函数。默认情况下，组显示数据中字段的文本，该文本与 name 属性指定的字段匹配。但是，有时您希望基于数据中的多个字段对项目进行分组，或基于不是简单 String 字段的内容进行分组。在这种情况下，可使用 groupingFunction 属性指定回调函数。

回调函数可能会将数字格式的月转换为字符串格式的月，或基于某些条件而不是字段的实际值将多个项目分为一个组。

对于 GroupField，方法签名具有以下格式：

groupingFunction(item:Object, field:GroupField):String

其中 item 包含数据项目对象，field 包含 GroupField 对象。

      private function groupFunc(item:Object, field:GroupingField):String
      {
          return item[field.name].toString().substr(0, 1);
      }
      

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

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

方法签名为：

      myGroupObjectFunction(label:String):Object

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

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

要排序的字段的名称。

默认值为 null。

指定当要进行排序的字段包含数值 (Number/int/uint) 或数值的字符串表示形式时，比较运算符是否使用数值比较。如果此属性为 false，将使用字符串比较对具有数字字符串表示形式的字段排序，因此 100 应在 99 之前，因为字符串值“1”比字符串值“9”小。

默认值为 false。

用于定义组级别摘要的 SummaryRow 实例的数组。指定一个或多个 SummaryRow 实例以定义数据摘要，如以下示例所示：

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:Grouping>
                     <mx:GroupingField name="Region">
                       <mx:summaries>
                           <mx:SummaryRow summaryPlacement="group">
                             <mx:fields>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Min Actual" operation="MIN"/>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Max Actual" operation="MAX"/>
                             </mx:fields>
                           </mx:SummaryRow>
                         </mx:summaries>
                     </mx:GroupingField>
                 </mx:Grouping>
             </mx:GroupingCollection>
         </mx:dataProvider>        
         
         <mx:columns>
             <mx:AdvancedDataGridColumn dataField="Region"/>
             <mx:AdvancedDataGridColumn dataField="Territory_Rep"
                 headerText="Territory Rep"/>
             <mx:AdvancedDataGridColumn dataField="Actual"/>
             <mx:AdvancedDataGridColumn dataField="Estimate"/>
             <mx:AdvancedDataGridColumn dataField="Min Actual"/>
             <mx:AdvancedDataGridColumn dataField="Max Actual"/>
         </mx:columns>
      </mx:AdvancedDataGrid>  
      

相关 API 元素

构造函数。