abandonRecord( )

Topic group Related topics Example

Abandons changes to the current record.

Syntax

<oRef>.abandonRecord( )

<oRef>

An object reference to the form.

Property of

Form, SubForm

Description

Use abandonRecord( ) for form-based data handling with tables in work areas. When using the data objects, abandonRecord( ) has no effect; use the rowset’s abandon( ) method instead.

Form-based data buffering lets you manage the editing of existing records and the appending of new records. The temporary record created by beginAppend( ) and editing changes to the current record are not written to the table until there is navigation off the record, or until saveRecord( ) is called. Each work area has its own separate edit buffer. For example, if you beginAppend( ) in two separate work areas, you must call abandonRecord( ) while each work area is selected to abandon the changes.

Before calling abandonRecord( ), you can use isRecordChanged( ) to determine if changes have been made. If so, you may want to confirm the action before proceeding.