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. 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);
  
  

Property summary for the DataGridColumn class

The following table lists the properties of the DataGridColumn class.