TcxCustomGridTableController.FocusNextRecordWithSelection(Integer,Boolean,Boolean,Boolean,Boolean) Method

Moves focus to and selects the next or previous record.

Declaration

function FocusNextRecordWithSelection(AFocusedRecordIndex: Integer; AGoForward: Boolean; AGoOnCycle: Boolean; AGoIntoDetail: Boolean; ASyncSelection: Boolean = True): Boolean;

Parameters

Name	Type
AFocusedRecordIndex	Integer
AGoForward	Boolean
AGoOnCycle	Boolean
AGoIntoDetail	Boolean
ASyncSelection	Boolean

Returns

Type
Boolean

Remarks

FocusNextRecordWithSelection is similar to the FocusNextRecord method. See its description for more information on parameter values.

The ASyncSelection parameter is optional. It specifies whether the selection should be preserved when moving focus. When this parameter is omitted, it is considered to be True and this implies clearing the previous selection and synchronizing it with the focused record. Set this parameter to False to preserve the selection when navigating.

The FocusNextRecordWithSelection method selects the record it focuses and this deselects all other records. To enable multiple selected records, see the View’s OptionsSelection.MultiSelect property.