TcxCustomGridTableController.GoToNext(Boolean,Boolean) Method

Moves focus to the record following the current one.

Declaration

function GoToNext(AGoIntoDetail: Boolean; ASyncSelection: Boolean = True): Boolean;

Parameters

Name	Type
AGoIntoDetail	Boolean
ASyncSelection	Boolean

Returns

Type
Boolean

Remarks

You can use the GoToNext method to focus the record following the currently active one. The AGoIntoDetail parameter is in effect when GoToNext is applied to a master View. If the current record is a master row (a TcxGridMasterDataRow object) and its detail is opened, the AGoIntoDetail parameter set to True makes a grid View move focus to the first detail record. If AGoIntoDetail is False, focus is moved to the next master row following the current one.

If the View allows appending records (the OptionsData.Appending property is set to True), the GoToNext method appends a new record when the current record is the last one within the View.

The ASyncSelection parameter is optional. It allows you to specify whether the selection should be preserved when moving focus. If 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 if you need to preserve the selection when navigating.

If the method was a success, it returns True.