Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxGridTableView.CreateColumn Method

Creates a new column and adds it to the Columns collection.

#Declaration

Delphi
function CreateColumn: TcxGridColumn;

#Returns

Type Description
TcxGridColumn

The created column.

#Remarks

Call the CreateColumn function to create a new unbound column. The Columns property provides indexed access to all columns in the unbound Table grid View.

#Code Example: Create an Unbound Column

The following code example creates an unbound Table View column, assigns an in-place spin editor to it, and limits the editor’s input value range:

uses cxSpinEdit;
// ...
var
  AColumn: TcxGridColumn;
  ASpinEditProperties: TcxSpinEditProperties;
begin
  AColumn := cxGrid1TableView1.CreateColumn;  // Creates a new unbound column
  AColumn.DataBinding.ValueType := 'Currency'; // Changes the column value type to "Currency"
  AColumn.PropertiesClass := TcxSpinEditProperties; // Assigns an in-place spin editor
  ASpinEditProperties := AColumn.Properties as TcxSpinEditProperties;
  ASpinEditProperties.MinValue := 0;  // Sets the minimum edit value
  ASpinEditProperties.MaxValue := 1000; // Sets the maximum edit value
  ASpinEditProperties.Circular := True; // Loops value changes within the defined range
end;

VCL Data Grid: A Column with an In-Place Spin Editor

#Grid Column Deletion

To delete a grid column, release it directly in code (call the Free procedure in Delphi or use the delete keyword in C++Builder):

  cxGrid1TableView1Column1.Free;
See Also