(仅限 Flex 数据可视化组件)
mx.controls.advancedDataGridClasses
public class AdvancedDataGridColumnGroup
继承AdvancedDataGridColumnGroup Inheritance AdvancedDataGridColumn Inheritance CSSStyleDeclaration Inheritance EventDispatcher Inheritance Object

使用 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 语法expanded隐藏 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

另请参见

mx.controls.AdvancedDataGrid
mx.controls.AdvancedDataGrid.columnGroup


公共属性
 属性定义方
  children : Array
定义列组中列的 AdvancedDataGridColumn 实例 Array。
AdvancedDataGridColumnGroup
  childrenDragEnabled : Boolean = true
指定是否可以拖动子列以在组中对其重新定位。
AdvancedDataGridColumnGroup
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheriteddataField : String
与列关联的数据提供程序项目中字段或属性的名称。
AdvancedDataGridColumn
 InheriteddataTipField : String
数据提供程序中显示为数据提示的字段名称。
AdvancedDataGridColumn
 InheriteddataTipFunction : Function
指定在数据提供程序每个项目上运行的回调函数,以确定其数据提示。
AdvancedDataGridColumn
 InheriteddefaultFactory : Function
此函数(如果不是 null)通常由 MXML 编译器自动生成。
CSSStyleDeclaration
 Inheritededitable : Boolean = true
指示列中的项目是否可进行编辑的标志。
AdvancedDataGridColumn
 InheritededitorDataField : String = "text"
项目编辑器的属性名称,其中包含列表项目的新数据。
AdvancedDataGridColumn
 InheritededitorHeightOffset : Number = 0
项目编辑器相对于项目渲染器大小的高度(以像素为单位)。
AdvancedDataGridColumn
 InheritededitorUsesEnterKey : Boolean = false
指示项目编辑器是否使用 Enter 键的标志。
AdvancedDataGridColumn
 InheritededitorWidthOffset : Number = 0
项目编辑器相对于项目渲染器大小的宽度(以像素为单位)。
AdvancedDataGridColumn
 InheritededitorXOffset : Number = 0
项目编辑器左上角相对于项目左上角的 x 位置(以像素为单位)。
AdvancedDataGridColumn
 InheritededitorYOffset : Number = 0
项目编辑器左上角相对于项目左上角的 y 位置(以像素为单位)。
AdvancedDataGridColumn
 Inheritedfactory : Function
此函数(如果不是 null)通常由 MXML 编译器自动生成。
CSSStyleDeclaration
 Inheritedformatter : Formatter
mx.formatters.Formatter 子类的实例。
AdvancedDataGridColumn
 InheritedheaderRenderer : IFactory
显示列标题的项目渲染器实例的类工厂。
AdvancedDataGridColumn
 InheritedheaderText : String
此列的标题文本。
AdvancedDataGridColumn
 InheritedheaderWordWrap : *
设置为 true,可在列标题文本不适合一行时换行。
AdvancedDataGridColumn
 InheritedimeMode : String
指定 IME(输入法编辑器)模式。
AdvancedDataGridColumn
 InheriteditemEditor : IFactory
列可编辑时,用于列的项目编辑器实例的类工厂。
AdvancedDataGridColumn
 InheriteditemRenderer : IFactory
显示列中每个项目数据的项目渲染器实例的类工厂。
AdvancedDataGridColumn
 InheritedlabelFunction : Function
确定此列中显示文本的函数。
AdvancedDataGridColumn
 InheritedminWidth : Number
列的最小宽度,以像素为单位。
AdvancedDataGridColumn
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 InheritedrendererIsEditor : Boolean = false
指示项目渲染器也是项目编辑器的标志。
AdvancedDataGridColumn
 Inheritedresizable : Boolean = true
如果允许用户调整列宽大小,则设置为 true。
AdvancedDataGridColumn
 InheritedshowDataTips : *
设置为 true 可以在列中显示数据提示。
AdvancedDataGridColumn
 Inheritedsortable : Boolean = true
设置为 true 表示用户可以单击此列的标题以对数据提供程序排序。
AdvancedDataGridColumn
 InheritedsortCompareFunction : Function
对列中的数据进行排序时调用的回调函数。
AdvancedDataGridColumn
 InheritedsortDescending : Boolean = false
指示列排序是按升序排序(设置为 false),还是按降序排序(设置为 true)。
AdvancedDataGridColumn
 InheritedstyleFunction : Function
呈现每个单元格时调用的回调函数。
AdvancedDataGridColumn
 Inheritedvisible : Boolean
如果为 true,则列可见。
AdvancedDataGridColumn
 Inheritedwidth : Number
列的宽度(以像素为单位)。
AdvancedDataGridColumn
 InheritedwordWrap : *
设置为 false 可对此列中的行文本换行(如果行中的文本不适合一行);如果为 undefined,则使用 AdvancedDataGrid 控件的 wordWrap 属性。
AdvancedDataGridColumn
受保护的属性
 属性定义方
 Inheritedoverrides : Object
如果运行时在 UIComponent 或 CSSStyleDeclaration 上调用 setStyle() 方法,该对象将存储已设置的名称/值对;它们将覆盖由 defaultFactory 和 factory 属性指定的方法所生成的对象中的名称/值对。
CSSStyleDeclaration
公共方法
 方法定义方
  
构造函数。
AdvancedDataGridColumnGroup
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
清除该 CSSStyleDeclaration 上的样式属性。
CSSStyleDeclaration
 Inherited
克隆此列,并返回一个与此列具有相同属性和样式的新列。
AdvancedDataGridColumn
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
getStyle(styleProp:String):*
获取指定样式属性的值,它完全由该 CSSStyleDeclaration 确定。
CSSStyleDeclaration
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
返回来自指定 Object 的数据提供程序中的数据。
AdvancedDataGridColumnGroup
 Inherited
返回 String,表示项目渲染器基于 dataTipField 和 dataTipFunction 属性显示的给定数据对象的数据提示。
AdvancedDataGridColumn
 Inherited
itemToLabel(data:Object, withFormatting:Boolean = true):String
返回项目渲染器针对给定数据对象显示的 String。
AdvancedDataGridColumn
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
在该 CSSStyleDeclaration 上设置样式属性。
CSSStyleDeclaration
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
样式
 样式 说明 定义方
 Inherited类型: uint 格式: Color CSS 继承: no
列的背景颜色。默认值为 undefined,表示它使用相关联的 AdvancedDataGrid 控件的 backgroundColor 样式值。AdvancedDataGrid 控件的默认值为 0xFFFFFF。.
AdvancedDataGridColumn
 Inherited类型: uint 格式: Color CSS 继承: yes
组件中文本(包括组件标签)的颜色。.
AdvancedDataGridColumn
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用时组件中文本的颜色。.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.
AdvancedDataGridColumn
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。

仅当使用嵌入的高级消除锯齿字体并将 fontAntiAliasType 属性设置为 "advanced" 时,此属性才适用。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.
AdvancedDataGridColumn
 Inherited类型: Number 格式: Length CSS 继承: yes
文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
确定文本是否使用斜体。可识别的值为 "normal""italic"。.
AdvancedDataGridColumn
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。

仅当使用嵌入的高级消除锯齿字体并将 fontAntiAliasType 属性设置为 "advanced" 时,此属性才适用。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
确定文本是否使用粗体。可识别的值为 "normal""bold"。对于 Button 控件,默认值为 "bold"。.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: no
用于控制列标题外观其它方面的 CSS 样式声明的名称。默认值为 undefined,表示它使用相关联的 AdvancedDataGrid 控件的 headerStyleName 样式值。AdvancedDataGrid 控件的默认值为 ".
AdvancedDataGridColumn
 Inherited类型: Boolean CSS 继承: yes
一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入的高级消除锯齿字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。.
AdvancedDataGridColumn
 Inherited类型: Number CSS 继承: yes
各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。.
AdvancedDataGridColumn
 Inherited类型: Number 格式: Length CSS 继承: no
容器的左边界与其内容区域之间的像素数目。此样式无默认值。项目渲染器的 paddingLeft 属性的设置用于确定默认值。.
AdvancedDataGridColumn
 Inherited类型: Number 格式: Length CSS 继承: no
容器的右边界与其内容区域之间的像素数目。此样式无默认值。项目渲染器的 paddingRight 属性的设置用于确定默认值。.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
容器内文本的对齐情况。可能值有:"left""right""center"

大多数控件的默认值都为 left。对于 Button、LinkButton 和 AccordionHeader 组件,默认值为 "center"。对于这些组件,只有将 labelPlacement 属性设置为 "left""right" 时才能识别此属性。如果将 labelPlacement 设置为 "top""bottom",将居中文本及所有图标。

.
AdvancedDataGridColumn
 Inherited类型: String CSS 继承: yes
确定文本是否加下划线。可能值有:"none""underline"。.
AdvancedDataGridColumn
 Inherited类型: Number 格式: Length CSS 继承: yes
文本第一行偏离容器左侧的距离(以像素为单位)。.
AdvancedDataGridColumn
属性详细信息
children属性
public var children:Array

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

childrenDragEnabled属性 
public var childrenDragEnabled:Boolean = true

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

默认值为 true.

构造函数详细信息
AdvancedDataGridColumnGroup()构造函数
public function AdvancedDataGridColumnGroup(columnName:String = null)

构造函数。

参数
columnName:String (default = null) — 与列组相关联的数据提供程序中的字段名称以及此列标题单元格的文本。这等效于设置 dataFieldheaderText 属性。
方法详细信息
itemToData()方法
public function itemToData(data:Object):*

返回来自指定 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 的数据提供程序中的数据。

另请参见