TcxControlOptionsView.CellAutoHeight Property

Determines whether the cell height (while the width is fixed) is automatically calculated to accommodate its contents.

Declaration

property CellAutoHeight: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

The CellAutoHeight option assumes that a control represents data in data cells. If the control’s cell width is smaller than the cell content width, the content is clipped. The clipping method for text cells is determined by the CellEndElipsis property. If the CellEndElipsis property is set to true, the text is clipped with the ellipsis.

You can set the CellAutoHeight property to True to allow a cell to automatically change the text lines count (cell height) while the cell width remains unchanged to accommodate the whole text without its clipping.

You can limit the number of text lines by setting the CellTextMaxLineCount property to a value different from zero. The CellTextMaxLineCount value will determine the maximum text lines count within a cell. If the number of text lines within a cell is less than the CellTextMaxLineCount property value, the line count remains unchanged.

Cells containing images adjust their height to accommodate the whole images.

The default value of the CellAutoHeight property is False.