GroupingCollection

包	mx.collections
类	public class GroupingCollection
继承	GroupingCollection HierarchicalData EventDispatcher Object
实现	IGroupingCollection

自以下版本起不推荐使用： 4.0: 请使用 GroupingCollection2

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用 GroupingCollection 类，您可以在平面数据中创建要显示在 AdvancedDataGrid 控件中的分组数据。在平面数据中创建 GroupingCollection 实例时，可以指定用于创建层次结构的数据的一个或多个字段。

要使用分组数据填充 AdvancedDataGrid 控件，可以在平面数据中创建 GroupingCollection 类的一个实例，然后将该 GroupingCollection 实例传递给 AdvancedDataGrid 控件的数据提供程序。要指定平面数据的分组字段，可将一个 Grouping 实例传递给 GroupingCollection.grouping 属性。Grouping 实例包含 GroupingField 实例的 Array，每个分组字段一个。

以下示例使用 GroupingCollection 类定义两个分组字段：Region 和 Territory。

  <mx:AdvancedDataGrid id="myADG"    
    <mx:dataProvider> 
      <mx:GroupingCollection id="gc" source="{dpFlat}"> 
        <mx:grouping> 
          <mx:Grouping> 
            <mx:GroupingField name="Region"/> 
            <mx:GroupingField name="Territory"/> 
          </mx:Grouping> 
        </mx:grouping> 
      </mx:GroupingCollection> 
    </mx:dataProvider>  
     
    <mx:columns> 
      <mx:AdvancedDataGridColumn dataField="Region"/> 
      <mx:AdvancedDataGridColumn dataField="Territory"/> 
      <mx:AdvancedDataGridColumn dataField="Territory_Rep"/> 
      <mx:AdvancedDataGridColumn dataField="Actual"/> 
      <mx:AdvancedDataGridColumn dataField="Estimate"/> 
    </mx:columns> 
  </mx:AdvancedDataGrid>

MXML 语法

隐藏 MXML 语法

The <mx.GroupingCollection> inherits all the tag attributes of its superclass, and defines the following tag attributes:

  <mx:GroupingCollection
  Properties 
    grouping="No default"
    source="No default"
    summaries="No default"
  />

This Class has been deprecated and replaced by a new Class GroupingCollection2 which provide faster, improved performance and a new summary calculation mechanism. Class SummaryField has also been deprecated and replaced by a new Class SummaryField2. Properties operation and summaryFunction are not present in the Class SummaryField2. A new property summaryOperation is introduced in SummaryField2.

默认 MXML 属性grouping

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		childrenField : String 指示在数据项中检测子对象所用的字段名。	HierarchicalData
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		grouping : Grouping 指定应用于源数据的 Grouping 实例。	GroupingCollection
		source : Object [覆盖] 包含要分组的平面数据的源集合。	GroupingCollection
		summaries : Array 定义任意根级别数据摘要的 SummaryRow 实例数组。	GroupingCollection

受保护的属性

	属性		由以下参数定义
		timer : flash.utils:Timer 与异步刷新操作相关联的计时器。	GroupingCollection

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		GroupingCollection() 构造函数。	GroupingCollection
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		cancelRefresh():void 如果异步执行刷新，请取消刷新操作并停止构建组。	GroupingCollection
		canHaveChildren(node:Object):Boolean 如果该节点可以包含子项，则返回 true。	HierarchicalData
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getChildren(node:Object):Object 返回表示节点子项的 Object。	HierarchicalData
		getData(node:Object):Object 返回节点中的数据。	HierarchicalData
		getRoot():Object [覆盖] 如果已设置分组属性，则返回 super.source；如果未设置，则返回引用 super.source 的 ICollectionView 实例。	GroupingCollection
		hasChildren(node:Object):Boolean 如果该节点包含子项，则返回 true。	HierarchicalData
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		refresh(async:Boolean = false):Boolean 对该视图应用分组。	GroupingCollection
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		getParent(node:Object):* 返回节点的父项。	GroupingCollection

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

grouping

属性

grouping:Grouping

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定应用于源数据的 Grouping 实例。设置 grouping 属性不会自动刷新视图，因此您必须在设置此属性后调用 refresh() 方法。

实现
public function get grouping():Grouping
public function set grouping(value:Grouping):void

source

属性

source:Object[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

包含要分组的平面数据的源集合。如果源不是一个集合，它将自动封装在一个集合中。

实现
override public function get source():Object
override public function set source(value:Object):void

summaries

属性

public var summaries:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:summaries>
                     <mx:SummaryRow summaryPlacement="last">
                         <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:Grouping>
                     <mx:GroupingField name="Region"/>
                     <mx:GroupingField name="Territory"/>
                 </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>

timer

属性

protected var timer:flash.utils:Timer

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

与异步刷新操作相关联的计时器。您可以使用它来更改计时间隔、暂停刷新或执行其他操作。Timer 实例的 delay 属性的默认值为 1，对应于 1 毫秒。

构造函数详细信息

()

构造函数

public function GroupingCollection()

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

方法详细信息

cancelRefresh

()

方法

public function cancelRefresh():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果异步执行刷新，请取消刷新操作并停止构建组。与异步刷新相对应，此方法仅取消由调用带有 true 参数的 refresh() 方法启动的刷新。

getParent

()

方法

protected function getParent(node:Object):*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回节点的父项。顶级节点的父项为 null。

参数

node:Object — 定义该节点的 Object。

* — 包含作为子项的节点的父节点，如果为顶级节点，则返回 null；如果无法确定父节点，则返回 undefined。

getRoot

()

方法

override public function getRoot():Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果已设置 grouping 属性，则返回 super.source；如果未设置，则返回引用 super.source 的 ICollectionView 实例。

Object — 要返回的对象。

refresh

()

方法

public function refresh(async:Boolean = false):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对该视图应用分组。IGroupingCollection 不会自动检测对组进行的更改，因此设置 group 属性后，必须调用 refresh() 方法更新该视图。

通过调用 refresh(true) 可异步应用 refresh() 方法。

如果同步调用 refresh()，客户端应等待 kind 属性值设置为 CollectionEventKind.REFRESH 的 CollectionEvent 事件，以确保完成 refresh() 方法。

参数

async:Boolean (default = false) — 如果为 true，则定义为异步刷新。默认情况下，为 false，指示同步刷新。

Boolean — 如果 refresh() 方法已完成，则为 true；如果刷新尚未完成，则为 false，这样可以表示这些项目仍未处理。

法律声明 | 在线隐私策略

GroupingCollection - AS3 Flex

包x

语言元素

附录

包 mx.collections

grouping

source

summaries

timer