Data Form and Data Table: _copyRow

Data Form and Data Table: _copyRow

Copies the locked row as a pending row

Delegated to: Data Set Data Model class

Syntax
Details

Syntax

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

Details

The _copyRow 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.

When you copy a row, you are placed on the pending row. If you are using the Data Form, then the _copyRow method copies the currently displayed row. If you are using the Data Table, then you must lock the row to be copied.

The _copyRow method does not actually add the new row to the table. The add is pending until

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,
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.

Chapter Contents
Previous
Next
Top of Page