TcxCustomGridTableController.CreateNewRecord(Boolean) Method

Creates a new record within the View.

Declaration

procedure CreateNewRecord(AtEnd: Boolean); virtual;

Parameters

Name	Type
AtEnd	Boolean

Remarks

You can use the CreateNewRecord method to add a new record within the current View. This method calls either the Insert or Append method of the View’s DataController object depending on the AtEnd parameter. If AtEnd is False, the new record is inserted above the focused one. If AtEnd is True, the new record is inserted at the end. Note that the position of the record can change after entering its cell values if sorting is applied).

The View’s OptionsBehavior.FocusFirstCellOnNewRecord property determines whether the record’s first focusable cell is focused when creating a new record. You can disable focusing a specific cell via the item’s Options.Focusing property.