Skip to main content

TcxGridTableOptionsView.DataRowHeight Property

Specifies the height of a data row (in pixels).

Declaration

property DataRowHeight: Integer read; write; default 0;

Property Value

Type Default
Integer 0

Remarks

By default, the height of the data rows is calculated based upon the height of the in-place editors that are used within the grid. For the text editors the height is determined by their current font settings (the grid’s Font property). If the CellAutoHeight property is set to False, each data row will have its height set to a size sufficient to display the cells according to the height of the in-place editors they correspond to. If the CellAutoHeight property is set to True, each data row may span several lines of text depending upon the contents of the cells within the row.

Any value other than 0 assigned to the DataRowHeight property overrides the CellAutoHeight property setting. The height of a data row in this case is the number of pixels specified by the DataRowHeight property. Whenever this property value exceeds the default value, the contents of cells are automatically shown in all data rows in the manner of multi-line columns. Note that a grid View that uses the image combo box control as an in-place editor is a special case. Refer to the CellAutoHeight property description for details on how the View calculates the editor’s cell height.

In a Banded Table View, the DataRowHeight and CellAutoHeight properties are in effect only when columns are arranged in a single row within the View and column headers occupy a single line (i.e. their Position.LineCount property is set to 1).

The DataRowHeight property automatically updates by multiplying its current value by the DPI-aware form’s scaling factor every time it changes. You can set the OptionsCustomize.DataRowSizing property to True to allow end-users to change the height of data rows.

The DataRowHeight property’s default value is 0.

See Also