TcxGridTableOptionsView.HeaderAutoHeight Property

Specifies if the grid View automatically adjusts the height of data item headers to display all captions in full.

Declaration

property HeaderAutoHeight: Boolean read; write; default False;

Property Value

Type	Default	Description
Boolean	False	False Default. Data item headers may crop corresponding captions if they do not fit into the header area. True The grid View automatically adjusts the height of data item headers to display all captions in full. The HeaderEndEllipsis property has no effect.

Remarks

Set the HeaderAutoHeight property to True to automatically adjust the height of data item headers according to their content. This option is useful if you need to display multi-line captions as demonstrated in the following code example.

Code Example: Display Multi-Line Column Captions

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

Delphi

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

C++

  cxGrid1BandedTableView1->OptionsView->HeaderAutoHeight = true;
  cxBandedTableView1Column2->Caption = "Support" + "\n" + "Requests";
  cxBandedTableView1Column3->Caption = "Last Support" + "\n" + "Request";

Default Value

The HeaderAutoHeight property’s default value is False.