(仅限 Flex 数据可视化组件)
mx.collections
public class SummaryField
继承SummaryField Inheritance Object

SummaryField 类代表 SummaryRow 实例中的一个属性。每个 SummaryRow 实例都指定一个或多个用于创建数据摘要的 SummayField 实例。

使用 dataField 属性指定用于生成摘要的数据字段;使用 label 属性指定为容纳摘要数据而创建的数据字段的名称;使用 operation 属性指定如何为数值字段创建摘要。可以指定下列值之一:SUMMINMAXAVGCOUNT

以下示例基于 AdvancedDataGrid 控件的数据提供程序的两个字段创建摘要行:

<mx:AdvancedDataGrid id="myADG" 
    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:GroupingField name="Territory">
            <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>

另请参见

mx.controls.AdvancedDataGrid
mx.collections.GroupingField
mx.collections.SummaryRow


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  dataField : String
为其计算摘要的数据字段。
SummaryField
  label : String
摘要对象内部使用的属性,它是 SummaryObject 类的一个实例,用于存储摘要信息。
SummaryField
  operation : String = "SUM"
应对子项执行的函数。
SummaryField
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  summaryFunction : Function
指定回调函数以计算自定义数据摘要。
SummaryField
公共方法
 方法定义方
  
SummaryField(dataField:String = null, operation:String = "SUM")
构造函数。
SummaryField
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
dataField属性
public var dataField:String

为其计算摘要的数据字段。

label属性 
public var label:String

摘要对象内部使用的属性,它是 SummaryObject 类的一个实例,用于存储摘要信息。

例如,如果将 label 属性设为“Summary”,则计算的摘要将置于摘要对象中名为“Summary”的属性中。包含摘要数据的 SummaryObject 实例的属性将按以下方式显示:

{Summary:1000}

另请参见

operation属性 
public var operation:String = "SUM"

应对子项执行的函数。可以为数值字段指定下列值之一:SUMMINMAXAVGCOUNT

默认值为 SUM.

summaryFunction属性 
public var summaryFunction:Function

指定回调函数以计算自定义数据摘要。

可将此属性与 SummaryRow.summaryObjectFunction 属性一起使用,后者定义用于收集供在 AdvancedDataGrid 控件中显示的摘要数据的 SummaryObject 类的实例。

该函数签名应如下所示:

function mySummaryFunction(iterator:IViewCursor, dataField:String, operation:String):Object

SUMMINMAXAVGCOUNT 的内置摘要函数都会返回一个包含摘要数据的 Number。

另请参见

构造函数详细信息
SummaryField()构造函数
public function SummaryField(dataField:String = null, operation:String = "SUM")

构造函数。

参数
dataField:String (default = null) — 为其计算摘要的数据字段。
 
operation:String (default = "SUM") — 应对子项执行的函数。可以为数值字段指定下列值之一:SUMMINMAXAVGCOUNT