AdvancedDataGridColumnGroup

包	mx.controls.advancedDataGridClasses
类	public class AdvancedDataGridColumnGroup
继承	AdvancedDataGridColumnGroup AdvancedDataGridColumn CSSStyleDeclaration EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用 AdvancedDataGridColumnGroup 类可指定 AdvancedDataGrid 控件的列组。可指定一个或多个 AdvancedDataGridColumn 类作为 AdvancedDataGridColumnGroup 类的子类，或嵌套 AdvancedDataGridColumnGroup 类来创建嵌套的列组。AdvancedDataGrid.columnGroup 属性采用 AdvancedDataGridColumnGroup 实例 Array 来指定列组。

下例使用 AdvancedDataGridColumnGroup 类定义了名为 Revenues 的列组，其中包含两列：Actual 和 Estimate。

  <mx:AdvancedDataGrid id="myADG"
       dataProvider="{dpFlat}"
       width="100%" height="100%">
       <mx:groupedColumns>
           <mx:AdvancedDataGridColumn dataField="Region"/>
           <mx:AdvancedDataGridColumn dataField="Territory"/>
           <mx:AdvancedDataGridColumn dataField="Territory_Rep"
               headerText="Territory Rep"/>
           <mx:AdvancedDataGridColumnGroup headerText="Revenues">    
               <mx:AdvancedDataGridColumn dataField="Actual"/>
               <mx:AdvancedDataGridColumn dataField="Estimate"/>
           </mx:AdvancedDataGridColumnGroup>    
       </mx:groupedColumns>
  </mx:AdvancedDataGrid>

MXML 语法

隐藏 MXML 语法

You use the <mx.AdvancedDataGridColumnGroup> tag to configure a column group of a AdvancedDataGrid control. You specify the <mx.AdvancedDataGridColumnGroup> tag as a child of the groupedColumns property in MXML. The <mx.AdvancedDataGridcolumn> tag defines the following tag attributes:

  <mx:AdvancedDataGridColumn
  Properties 
    children="No default"
    childrenDragEnabled="true|false"
  />

默认 MXML 属性children

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		children : Array 定义列组中列的 AdvancedDataGridColumn 实例 Array。	AdvancedDataGridColumnGroup
		childrenDragEnabled : Boolean = true 指定是否可以拖动子列以在组中对其重新定位。	AdvancedDataGridColumnGroup
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		dataField : String 与列关联的数据提供程序项目中字段或属性的名称。	AdvancedDataGridColumn
		dataTipField : String 数据提供程序中显示为数据提示的字段名称。	AdvancedDataGridColumn
		dataTipFunction : Function 指定在数据提供程序每个项目上运行的回调函数，以确定其数据提示。	AdvancedDataGridColumn
		defaultFactory : Function 此函数（如果不是 null）通常由 MXML 编译器自动生成。	CSSStyleDeclaration
		draggable : Boolean = true 一个标志，指示是否允许用户将列拖动到新位置。如果为 true，则用户可以将列标题拖动到新位置	AdvancedDataGridColumn
		editable : Boolean = true 指示列中的项目是否可进行编辑的标志。	AdvancedDataGridColumn
		editorDataField : String = "text" 项目编辑器的属性名称，其中包含列表项目的新数据。	AdvancedDataGridColumn
		editorHeightOffset : Number = 0 项目编辑器相对于项呈示器大小的高度（以像素为单位）。	AdvancedDataGridColumn
		editorUsesEnterKey : Boolean = false 指示项目编辑器是否使用 Enter 键的标志。	AdvancedDataGridColumn
		editorWidthOffset : Number = 0 项目编辑器相对于项呈示器大小的宽度（以像素为单位）。	AdvancedDataGridColumn
		editorXOffset : Number = 0 项目编辑器左上角相对于项目左上角的 x 位置（以像素为单位）。	AdvancedDataGridColumn
		editorYOffset : Number = 0 项目编辑器左上角相对于项目左上角的 y 位置（以像素为单位）。	AdvancedDataGridColumn
		enableIME : Boolean [只读] 一个标志，用于指示当组件获得焦点时是否应启用 IME。	AdvancedDataGridColumn
		factory : Function 此函数（如果不是 null）通常由 MXML 编译器自动生成。	CSSStyleDeclaration
		formatter : IFormatter mx.formatters.Formatter 子类的实例。	AdvancedDataGridColumn
		headerRenderer : IFactory 显示列标题的项呈示器实例的类工厂。	AdvancedDataGridColumn
		headerText : String 此列的标题文本。	AdvancedDataGridColumn
		headerWordWrap : * 设置为 true，可在列标题文本不适合一行时换行。	AdvancedDataGridColumn
		imeMode : String 指定 IME（输入法编辑器）模式。	AdvancedDataGridColumn
		itemEditor : IFactory 列可编辑时，用于列的项目编辑器实例的类工厂。	AdvancedDataGridColumn
		itemRenderer : IFactory 显示列中每个项目数据的项呈示器实例的类工厂。	AdvancedDataGridColumn
		labelFunction : Function 确定此列中显示文本的函数。	AdvancedDataGridColumn
		minWidth : Number 列的最小宽度，以像素为单位。	AdvancedDataGridColumn
		overrides : Object 如果运行时在 UIComponent 或 CSSStyleDeclaration 上调用 setStyle() 方法，该对象将存储已设置的名称/值对；它们将覆盖由 defaultFactory 和 factory 属性指定的方法所生成的对象中的名称/值对。	CSSStyleDeclaration
		rendererIsEditor : Boolean = false 指示项呈示器也是项目编辑器的标志。	AdvancedDataGridColumn
		resizable : Boolean = true 如果允许用户调整列宽大小，则设置为 true。	AdvancedDataGridColumn
		selector : CSSSelector 此属性是用于将 CSS 样式声明与组件进行匹配的可能选择器链和条件的基本选择器。	CSSStyleDeclaration
		selectorIndex : int = 0 此 CSSStyleDeclaration 添加到其 StyleManager 的顺序。	CSSStyleDeclaration
		showDataTips : * 设置为 true 可以在列中显示数据提示。	AdvancedDataGridColumn
		sortable : Boolean = true 设置为 true 表示用户可以单击此列的标题以对数据提供程序排序。	AdvancedDataGridColumn
		sortCompareFunction : Function 对列中的数据进行排序时调用的回调函数。	AdvancedDataGridColumn
		sortDescending : Boolean = false 指示列排序是按升序排序（设置为 false），还是按降序排序（设置为 true）。	AdvancedDataGridColumn
		specificity : int [只读] 确定将多个样式声明应用于组件时的优先顺序。	CSSStyleDeclaration
		styleFunction : Function 呈示每个单元格时调用的回调函数。	AdvancedDataGridColumn
		subject : String [只读] 主题描述了可能是此样式声明的匹配项的组件的名称。	CSSStyleDeclaration
		visible : Boolean 如果为 true，则列可见。	AdvancedDataGridColumn
		width : Number 列的宽度（以像素为单位）。	AdvancedDataGridColumn
		wordWrap : * 设置为 false 可对此列中的行文本换行（如果行中的文本不适合一行）；如果为 undefined，则使用 AdvancedDataGrid 控件的 wordWrap 属性。	AdvancedDataGridColumn

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		AdvancedDataGridColumnGroup(columnName:String = null) 构造函数。	AdvancedDataGridColumnGroup
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		clearStyle(styleProp:String):void 清除该 CSSStyleDeclaration 上的样式属性。	CSSStyleDeclaration
		clone():AdvancedDataGridColumn 克隆此列，并返回一个与此列具有相同属性和样式的新列。	AdvancedDataGridColumn
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getStyle(styleProp:String):* 获取指定样式属性的值，它完全由该 CSSStyleDeclaration 确定。	CSSStyleDeclaration
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		itemToData(data:Object):* 返回来自指定 Object 的数据提供程序中的数据。	AdvancedDataGridColumnGroup
		itemToDataTip(data:Object):String 返回 String，表示项呈示器基于 dataTipField 和 dataTipFunction 属性显示的给定数据对象的数据提示。	AdvancedDataGridColumn
		itemToLabel(data:Object, withFormatting:Boolean = true):String 返回项目渲染器为给定数据对象显示的字符串。	AdvancedDataGridColumn
		matchesStyleClient(object:IAdvancedStyleClient):Boolean 确定此样式声明是否基于选择器链的匹配性而应用于给定的组件。	CSSStyleDeclaration
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void 在该 CSSStyleDeclaration 上设置样式属性。	CSSStyleDeclaration
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

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

隐藏继承的事件

显示继承的事件

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

样式

样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。

常见样式

单击此处了解有关样式的更多信息

隐藏继承的样式

显示继承的样式

	说明	由以下参数定义
backgroundColor	类型: uint 格式: Color CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 列的背景颜色.	AdvancedDataGridColumn
color	类型: uint 格式: Color CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本（包括组件标签）的颜色.	AdvancedDataGridColumn
disabledColor	类型: uint 格式: Color CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色.	AdvancedDataGridColumn
fontAntiAliasType	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 `antiAliasType` 属性.	AdvancedDataGridColumn
fontFamily	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称.	AdvancedDataGridColumn
fontGridFitType	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 `gridFitType` 属性.	AdvancedDataGridColumn
fontSharpness	类型: Number CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 `sharpness` 属性.	AdvancedDataGridColumn
fontSize	类型: Number 格式: Length CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度，以像素为单位.	AdvancedDataGridColumn
fontStyle	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体.	AdvancedDataGridColumn
fontThickness	类型: Number CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 `thickness` 属性.	AdvancedDataGridColumn
fontWeight	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体.	AdvancedDataGridColumn
headerStyleName	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于控制列标题外观其他方面的 CSS 样式声明的名称.	AdvancedDataGridColumn
kerning	类型: Boolean CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值，表示是启用 (`true`) 还是禁用 (`false`) 字距调整.	AdvancedDataGridColumn
letterSpacing	类型: Number CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数.	AdvancedDataGridColumn
paddingLeft	类型: Number 格式: Length CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的左边界与其内容区域之间的像素数目.	AdvancedDataGridColumn
paddingRight	类型: Number 格式: Length CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的右边界与其内容区域之间的像素数目.	AdvancedDataGridColumn
textAlign	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式.	AdvancedDataGridColumn
textDecoration	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线.	AdvancedDataGridColumn
textIndent	类型: Number 格式: Length CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离（以像素为单位）.	AdvancedDataGridColumn

属性详细信息

children

属性

public var children:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

定义列组中列的 AdvancedDataGridColumn 实例 Array。

childrenDragEnabled

属性

public var childrenDragEnabled:Boolean = true

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定是否可以拖动子列以在组中对其重新定位。如果为 false，则即使将子列的 AdvancedDataGridColumn.dragEnabled 属性设置为 true，也无法对子列重新排序。

默认值为 true。

构造函数详细信息

()

构造函数

public function AdvancedDataGridColumnGroup(columnName:String = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

columnName:String (default = null) — 与列组相关联的数据提供程序中的字段名称以及此列标题单元格的文本。这等效于设置 dataField 和 headerText 属性。

方法详细信息

itemToData

()

方法

public function itemToData(data:Object):*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回来自指定 Object 的数据提供程序中的数据。

如果行数据包含套嵌的对象，则此方法非常有用。例如，行由数据提供程序中的下列数据定义：

      row = { name:"Adobe", address : {
                                        street  : "345 Park Avenue", 
                                        city    : "San Jose",
                                        state   : "CA 95110",
                                        country : "USA"
                                      }
                       }

您可以将“address”字段分配给 AdvancedDataGridColumnGroup 实例的 dataField 属性。调用 itemToData(row) 可以返回地址对象。

此方法与 AdvancedDataGridColumn.itemToLabel() 方法类似。

参数

data:Object — 数据提供程序元素。

* — 指定 Object 的数据提供程序中的数据。

AdvancedDataGridColumnGroup - AS3 Flex

类 x

children

childrenDragEnabled

AdvancedDataGridColumnGroup

itemToData