User Guide

300 DataGrid component (Flash Professional only)
DataGridColumn class (Flash
Professional only)
ActionScript Class Name mx.controls.gridclasses.DataGridColumn
You can create and configure DataGridColumn objects to use as columns of a data grid. Many
of the methods of the DataGrid class are dedicated to managing DataGridColumn objects.
DataGridColumn objects are stored in an zero-based array in the data grid; 0 is the leftmost
column. After columns have been added or created, you can access them by calling
DataGrid.getColumnAt(index).
There are three ways to add or create columns in a grid. If you want to configure your
columns, it is best to use either the second or third way before you add data to a data grid so
you don’t have to create columns twice.
■ Add a data provider or an item with multiple fields to a grid that has no configured
DataGridColumn objects. This approach automatically generates columns for every field
in the reverse order of the
for..in loop. For example, for a DataGrid instance named
my_dg:
my_dg.dataProvider = [{guitar:"Flying V", name:"maggot"}, {guitar:"SG",
name:"dreschie"}, {guitar:"jagstang", name:"vitapup"}];
■ Use DataGrid.columnNames to create the field names of the desired item fields and
generate DataGridColumn objects, in order, for each field listed. This approach lets you
select and order columns quickly with a minimal amount of configuration. This approach
removes any previous column information. For example, for a DataGrid instance named
my_dg:
my_dg.columnNames = ["guitar","name"];
■ Prebuild the DataGridColumn objects and add them to the data grid by using
DataGrid.addColumn(). This approach is useful, and the most flexible, because it lets
you add columns with proper sizing and formatting before the columns ever reach the grid
(which reduces processor demand). For more information, see “Constructor for the
DataGridColumn class” on page 302. For example, for a DataGrid instance named
my_dg:
// Create column object.
var location_dgc:DataGridColumn = new DataGridColumn("Location");
location_dgc.width = 100;
// Add column to DataGrid.
my_dg.addColumn(location_dgc);