Data Set Data Model: _copyRow

Data Set Data Model: _copyRow

Copies the locked row as a pending row

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.

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

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

If there is an attached viewer, then you are placed on the pending row. If you are using the Data Form and the attached viewer is the form editor, then the _copyRow method copies the currently displayed row. If you are using the Data Table and the attached viewer is the table editor, then you must lock the row to be copied.

Chapter Contents
Previous
Next
Top of Page