SelectionOptions

EhLib TeamLess than 1 minute

TDataGridEh.SelectionOptions

property SelectionOptions: TDataGridSelectionOptionsEh;

published

Use the subproperties of the SelectionOptions property to set display options for the selected area of the grid.

The SelectionOptions property is of type TDataGridSelectionOptionsEh and contains the following subproperties:

SelectionOptions.AllowedSelections

property AllowedSelections: TDataGridEhAllowedSelections 
  default [TDataGridEhSelectionType.RecordBookmarks..TDataGridEhSelectionType.All];

Specifies the allowed types of selection of areas in the grid.

SelectionOptions.RowSelect

property RowSelect: Boolean default False;

Specifies that when navigating in a grid, it is necessary to select the entire record instead of selecting the current cell alone.

SelectionOptions.KeepSelection

property KeepSelection: Boolean default False;

Specifies that the selected area should not be cleared when the current cell position changes.

SelectionOptions.DataCellSelectionTime

property DataCellSelectionTime: TDataCellSelectionTimeEh 
  default TDataCellSelectionTimeEh.OnMouseMove;

Determines when the grid goes into multi-select mode for records or multiple cells.

The TDataCellSelectionTimeEh.OnMouseMove value specifies that the grid will only start adding values to the SelectedRows list when the user clicks and starts selecting multiple records in the grid.

The TDataCellSelectionTimeEh.OnMouseDown value specifies that the grid will add a record to the SelectedRows section the first time the record is clicked (in RowSelect mode).

SelectionOptions.RowHighlight

property RowHighlight: Boolean default True;

Specifies that the entire current record should be highlighted. In this case, the current cell will be highlighted with a darker color, and all other cells of the current record with a less dark color.

SelectionOptions.AlwaysShow

property AlwaysShow: Boolean default True;

Specifies that the current Cell or Row in the grid should always be highlighted regardless of whether the grid has input focus or not.