TcxCustomGridTableOptionsSelection.UnselectFocusedRecordOnExit Property

Indicates whether to unselect the focused record when the current View loses focus.

Declaration

property UnselectFocusedRecordOnExit: Boolean read; write; default True;

Property Value

Type	Default
Boolean	True

Remarks

When the MultiSelect property is True, a grid View enables you to select multiple records. The focused record in this mode can either be selected or not (when MultiSelect is False, the focused record is always selected). When a user clicks a specific record, it becomes focused and selected at the same time.

If the UnselectFocusedRecordOnExit property is True and no records are selected save the focused one, the record is automatically unselected on exiting the current View (when setting focus to another View or View clone). If several records are selected, the selection of the focused record is not affected.

The selection of the focused record persists if the UnselectFocusedRecordOnExit property is set to False as well.

The default value of the UnselectFocusedRecordOnExit property is True.