ColumnOptions

TDataGridEh.ColumnOptions

property ColumnOptions: TDataGridColumnOptionsEh;

published

Use the subproperties of the ColumnOptions property to set the default value for the properties of all grid columns.

The ColumnOptions property is of type TDataGridColumnOptionsEh and contains the following subproperties:

ColumnOptions.DynaColumnOptions.MinInitWidth

property DynaColumnOptions.MinInitWidth Integer default 40;

Sets the minimum width of a dynamically created column when the column width is automatically calculated upon creation and when records first appear in the grid.

ColumnOptions.DynaColumnOptions.MaxInitWidth

property DynaColumnOptions.MaxInitWidth Integer default 400;

Sets the maximum width of a dynamically created column when the column width is automatically calculated upon creation and when records first appear in the grid.

ColumnOptions.DynaColumnOptions.UseTitleToInitWidth

property DynaColumnOptions.UseTitleToInitWidth: Boolean

Specifies whether to take into account the text in the header when calculating the width of dynamic columns.

ColumnOptions.DynaColumnOptions.UseDataRowsToInitWidth

property DynaColumnOptions.UseDataRowsToInitWidth: Boolean

Specifies whether text in grid data rows should be taken into account when calculating the width of dynamic columns.

ColumnOptions.ColSizeUnit

property ColSizeUnit: TGridColSizeUnitEh default TGridColSizeUnitEh.Pixels

Specifies default value of the ColSizeUnit property for every column the grid.
The TGridColSizeUnitEh type can have the following values:

• Pixels - the value is specified in pixels.
• Weight - the value is specified in weight/percentage units.

ColumnOptions.AllowResize

property AllowResize: Boolean default True;

Determines whether the user can resize columns with the mouse.

ColumnOptions.AllowMove

property AllowMove: Boolean default True;

Determines whether the user can move columns with the mouse.

ColumnOptions.AllowShowEditor

property AllowShowEditor: Boolean default True;

Determines whether the grid can open a cell's text editor. Typically, the grid opens the text editor when the user presses F2, Enter, or an alphanumeric key on the keyboard. A similar property can also be set for a specific column.

ColumnOptions.Fill

property Fill: TBrush;

Sets cell fill properties for all grid columns.

ColumnOptions.Font

property Font: TFont;

Sets the font properties for all grid columns.

ColumnOptions.FontColor

property FontColor: TAlphaColor;

Sets the font color for all grid columns.

ColumnOptions.HeightAutoExpand

property HeightAutoExpand: Boolean default False;

Specifies whether to automatically increase the height of the cell and row to accommodate all cell contents.

ColumnOptions.HorzAlign

    property HorzAlign: TTextAlign default TTextAlign.Leading;

Specifies the default horizontal alignment of cell contents in all grid columns.

ColumnOptions.HorzLinesColor

    property HorzLinesColor: TAlphaColor;

Specifies the color of the horizontal dividing lines in the Data section. If the value is not specified, the color will be taken from the GridLineOptions.BrightColor property.

ColumnOptions.HorzLinesVisible

    property HorzLinesVisible: Boolean;

Specifies whether to draw horizontal lines in the Data section of the grid. If the value is not specified, the value will be taken from the GridLineOptions.HorzLinesVisible property.

ColumnOptions.Padding

    property Padding: TBounds;

Specifies the margins from the cell border to the data display section.
The default value is (2, 2, 2, 2).

ColumnOptions.Tooltips

    property Tooltips: Boolean default True;

Specifies whether to display the full value of a cell in a separate hint window when the full contents of a cell are not fully visible in the cell.

ColumnOptions.Trimming

    property Trimming: TTextTrimming default TTextTrimming.Character;

Specifies the method of text truncation when the text does not fit into the cell. Can take the following values: Simple truncation, truncation by the nearest letter with display of ellipsis, truncation by the nearest word with display of ellipsis..

ColumnOptions.VertAlign

    property VertAlign: TTextAlign default TTextAlign.Leading;

Specifies the default vertical alignment of cell contents in all grid columns.

ColumnOptions.VertLinesColor

    property VertLinesColor: TAlphaColor;

Specifies the color of the vertical dividing lines in the Data section. If the value is not specified, the color will be taken from the GridLineOptions.BrightColor property.

ColumnOptions.VertLinesVisible

    property VertLinesVisible: Boolean;

Specifies whether to draw vertical lines in the Data section of the grid. If the value is not specified, the value will be taken from the GridLineOptions.VertLinesVisible property.

ColumnOptions.WordWrap

property WordWrap: Boolean default False;

Specifies whether text should wrap to a new line if it does not fit within the cell width.