AddNewMode Property

The AddNewMode property returns a value that describes the location of the current cell with respect to the grid's AddNew row.

Syntax

TDBGrid.AddNewMode

Values

Run Time

0 - No AddNew pending	dbgNoAddNew
1 - Current cell in AddNew row	dbgAddNewCurrent
2 - AddNew pending	dbgAddNewPending

Remarks

Read-only at run time. Not available at design time.

If the AllowAddNew property is True, the last row displayed in the grid is left blank to permit users to enter new records. If the AllowAddNew property is False, the blank row is not displayed, and AddNewMode always returns 0.

When AllowAddNew is True, the AddNewMode property returns one of the following values:

dbgNoAddNew	The current cell is not in the last row, and no AddNew operation is pending.
dbgAddNewCurrent	The current cell is in the last row, but no AddNew operation is pending.
dbgAddNewPending	The current cell is in the next to last row as a result of a pending AddNew operation initiated by the user through the grid's user interface, or by code as a result of setting the Value or Text properties of a column.

Note

This property is valid in both bound and unbound modes.