Data Set Data Model: _addRow

Data Set Data Model: _addRow

Adds a pending row

Syntax
Details

Syntax

CALL SEND (object-id, '_addRow');

The _addRow method is an editing method and is not valid when

browsing a table or when the NOADD option is specified in the _setDataset method, or
Addition/Duplication Allowed is disabled under the Table Characteristics of Data Form or Data Table.

If there is an attached viewer, you are placed on the pending row.

The _addRow method does not actually add the new row to the table. The add is pending until one of the following occurs:

the row is committed to the table by using
- the _commitNewRow method, or
- the Commit New Row item on the pop-up menu
the current row is changed, for example, by vertically scrolling, or using _setKey or _setWhere
the frame is ended (if there is an attached viewer),
a new row is added or copied, or
a WHERE clause is issued.

To cancel the pending row, use the _reread or _rereadAll method, or use the Cancel Row Edits item on the pop-up menu.