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

TcxCustomGridTableItem.Caption Property

Specifies the data item’s caption.

#Declaration

Delphi
property Caption: string read; write;

#Property Value

Type Description
string

The data item caption.

#Remarks

Use the Caption property to specify the required caption for the data item. HeaderAlignmentHorz and HeaderAlignmentVert properties allow you to position the caption within the data item’s header.

#Alternative Data Item Caption

All auxiliary dialogs (Customization Form, Quick Customization, etc.) also use the Caption property value to display the data item. You can use the AlternateCaption property to specify an alternative data item caption for these dialogs.

#Multi-Line Captions

To display a multi-line data item caption, you need to break the caption string into multiple lines with carriage return/line feed characters (use #13#10 in Delphi and "\n" in C++Builder).

A data item header wraps such a caption string if the header height is sufficient to fit all caption lines. You can use the grid View’s OptionsView.HeaderHeight property to set the required height explicitly or set the OptionsView.HeaderAutoHeight property to True to allow the grid View to adjust the header height according to its content.

#Code Example: Display Multi-Line Column Captions

The following code example displays multi-line captions in headers of two unbound banded columns:

  cxGrid1BandedTableView1.OptionsView.HeaderAutoHeight := True;
  cxBandedTableView1Column2.Caption := 'Support' + #13#10 + 'Requests';
  cxBandedTableView1Column3.Caption := 'Last Support' + #13#10 + 'Request';

VCL Data Grid: Multi-Line Captions in Banded Column Headers

See Also