| Package | mx.controls.advancedDataGridClasses |
| Class | public class AdvancedDataGridColumnGroup |
| Inheritance | AdvancedDataGridColumnGroup  AdvancedDataGridColumn CSSStyleDeclaration EventDispatcher Object |
| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
AdvancedDataGrid.columnGroup property
takes an Array of AdvancedDataGridColumnGroup instances to specify the column groups.
The following example uses the AdvancedDataGridColumnGroup class to define a column group named Revenues that contains two columns: Actual and 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 Syntax
Show MXML Syntax
Hide MXML SyntaxYou 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"
/>
Default MXML Propertychildren
See also
Public Properties
| Property | Defined By | ||
|---|---|---|---|
| children : Array
An Array of AdvancedDataGridColumn instances that define the columns
of the column group. | AdvancedDataGridColumnGroup | ||
| childrenDragEnabled : Boolean = true
Specifies whether the child columns can be dragged to reposition them in the group. | AdvancedDataGridColumnGroup | ||
 | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
| dataField : String
The name of the field or property in the data provider item associated
with the column. | AdvancedDataGridColumn | |
| dataTipField : String
The name of the field in the data provider to display as the data tip. | AdvancedDataGridColumn | |
| dataTipFunction : Function
Specifies a callback function to run on each item of the data provider
to determine its data tip. | AdvancedDataGridColumn | |
| defaultFactory : Function
This function, if it isn't null,
is usually autogenerated by the MXML compiler. | CSSStyleDeclaration | |
| draggable : Boolean = true
A flag that indicates whether the user is allowed to drag
the column to a new position
If true, the user can drag the
the column headers to a new position
| AdvancedDataGridColumn | |
| editable : Boolean = true
A flag that indicates whether the items in the column are editable. | AdvancedDataGridColumn | |
| editorDataField : String = "text"
The name of the property of the item editor that contains the new
data for the list item. | AdvancedDataGridColumn | |
| editorHeightOffset : Number = 0
The height of the item editor, in pixels, relative to the size of the
item renderer. | AdvancedDataGridColumn | |
| editorUsesEnterKey : Boolean = false
A flag that indicates whether the item editor uses Enter key. | AdvancedDataGridColumn | |
| editorWidthOffset : Number = 0
The width of the item editor, in pixels, relative to the size of the
item renderer. | AdvancedDataGridColumn | |
| editorXOffset : Number = 0
The x location of the upper-left corner of the item editor,
in pixels, relative to the upper-left corner of the item. | AdvancedDataGridColumn | |
| editorYOffset : Number = 0
The y location of the upper-left corner of the item editor,
in pixels, relative to the upper-left corner of the item. | AdvancedDataGridColumn | |
| enableIME : Boolean [read-only]
A flag that indicates whether the IME should
be enabled when the component receives focus. | AdvancedDataGridColumn | |
| factory : Function
This function, if it isn't null,
is usually autogenerated by the MXML compiler. | CSSStyleDeclaration | |
| formatter : Formatter
An instance of a subclasses of mx.formatters.Formatter. | AdvancedDataGridColumn | |
| headerRenderer : IFactory
The class factory for item renderer instances that display the
column header for the column. | AdvancedDataGridColumn | |
| headerText : String
Text for the header of this column. | AdvancedDataGridColumn | |
| headerWordWrap : *
Set to true to wrap the text in the column header
if it does not fit on one line. | AdvancedDataGridColumn | |
| imeMode : String
Specifies the IME (input method editor) mode. | AdvancedDataGridColumn | |
| itemEditor : IFactory
A class factory for the instances of the item editor to use for the
column, when it is editable. | AdvancedDataGridColumn | |
| itemRenderer : IFactory
The class factory for item renderer instances that display the
data for each item in the column. | AdvancedDataGridColumn | |
| labelFunction : Function
A function that determines the text to display in this column. | AdvancedDataGridColumn | |
| minWidth : Number
The minimum width of the column, in pixels. | AdvancedDataGridColumn | |
| overrides : Object
If the setStyle() method is called on a UIComponent or CSSStyleDeclaration
at run time, this object stores the name/value pairs that were set;
they override the name/value pairs in the objects produced by
the methods specified by the defaultFactory and
factory properties. | CSSStyleDeclaration | |
| prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | |
| rendererIsEditor : Boolean = false
A flag that indicates that the item renderer is also an item editor. | AdvancedDataGridColumn | |
| resizable : Boolean = true
Set to true if the user is allowed to resize
the width of the column. | AdvancedDataGridColumn | |
| selector : CSSSelector
This property is the base selector of a potential chain of selectors
and conditions that are used to match CSS style declarations to
components. | CSSStyleDeclaration | |
| showDataTips : *
Set to true to show data tips in the column. | AdvancedDataGridColumn | |
| sortable : Boolean = true
Set to true to indicate that the user can click on the
header of this column to sort the data provider. | AdvancedDataGridColumn | |
| sortCompareFunction : Function
A callback function that gets called when sorting the data in
the column. | AdvancedDataGridColumn | |
| sortDescending : Boolean = false
Indicates whether the column sort is
in ascending order, false,
or descending order, true. | AdvancedDataGridColumn | |
| specificity : int [read-only]
Determines the order of precedence when applying multiple style
declarations to a component. | CSSStyleDeclaration | |
| styleFunction : Function
A callback function that is called when rendering each cell. | AdvancedDataGridColumn | |
| subject : String [read-only]
The subject describes the name of a component that may be a potential
match for this style declaration. | CSSStyleDeclaration | |
| visible : Boolean
If true, the column is visible. | AdvancedDataGridColumn | |
| width : Number
The width of the column, in pixels. | AdvancedDataGridColumn | |
| wordWrap : *
Set to false to wrap the text in a row of this column
because it does not fit on one line
If undefined, the AdvancedDataGrid control's wordWrap property
is used. | AdvancedDataGridColumn | |
Public Methods
| Method | Defined By | ||
|---|---|---|---|
AdvancedDataGridColumnGroup(columnName:String = null)
Constructor. | AdvancedDataGridColumnGroup | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | EventDispatcher | |
|
Clears a style property on this CSSStyleDeclaration. | CSSStyleDeclaration | |
|
Clone this column and return a new Column with the
same properties and styles as this one. | AdvancedDataGridColumn | |
|
Dispatches an event into the event flow. | EventDispatcher | |
|
Gets the value for a specified style property,
as determined solely by this CSSStyleDeclaration. | CSSStyleDeclaration | |
|
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | |
|
Indicates whether an object has a specified property defined. | Object | |
|
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
Returns the data from the data provider for the specified Object. | AdvancedDataGridColumnGroup | ||
|
Returns a String that the item renderer displays as the data tip for the given data object,
based on the dataTipField and dataTipFunction properties. | AdvancedDataGridColumn | |
|
Returns the String that the item renderer displays for the given data object. | AdvancedDataGridColumn | |
|
Determines whether this style declaration applies to the given component
based on a match of the selector chain. | CSSStyleDeclaration | |
|
Indicates whether the specified property exists and is enumerable. | Object | |
|
Removes a listener from the EventDispatcher object. | EventDispatcher | |
|
Sets the availability of a dynamic property for loop operations. | Object | |
|
Sets a style property on this CSSStyleDeclaration. | CSSStyleDeclaration | |
|
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
|
Returns the string representation of the specified object. | Object | |
|
Returns the primitive value of the specified object. | Object | |
|
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher | |
Styles
Styles are either common or associated with a specific theme. If the style is common, it can be used with any theme. If a style is associated with a specific theme, it can only be used if your application uses that theme.
Common Styles
Property Detail
children | property |
public var children:Array| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
An Array of AdvancedDataGridColumn instances that define the columns of the column group.
childrenDragEnabled | property |
public var childrenDragEnabled:Boolean = true| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Specifies whether the child columns can be dragged to reposition them in the group.
If false, child columns cannot be reordered even if
the AdvancedDataGridColumn.dragEnabled property is set
to true for a child column.
The default value is true.
Constructor Detail
AdvancedDataGridColumnGroup | () | Constructor |
public function AdvancedDataGridColumnGroup(columnName:String = null)| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Constructor.
ParameterscolumnName:String (default = null)dataField
and headerText properties.
|
Method Detail
itemToData | () | method |
public function itemToData(data:Object):*| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the data from the data provider for the specified Object.
This method is useful when the data for a row contains nested Objects. For example, a row is defined by the following data in the data provider:
row = { name:"Adobe", address : {
street : "345 Park Avenue",
city : "San Jose",
state : "CA 95110",
country : "USA"
}
}
You then assign the "address" field to the dataField property
of the AdvancedDataGridColumnGroup instance. A call to itemToData(row)
then returns the address object.
This method is similar to the
AdvancedDataGridColumn.itemToLabel() method.
Parameters
data:Object — The data provider element.
|
* — The data from the data provider for the specified Object.
|
See also
Thu May 20 2010, 02:19 AM -07:00