DiscardChanges Method

Applies To
OBinder

Description
This method discards the changes made to the current record.

Usage
oresult DiscardChanges(void)

Remarks
OBound subclass instances allow changes to be made to field values. When those changes are made, the subclass code marks itself as changed with the OBound::Changed method, which in turn marks the current record (of the dynaset that the attached OBinder is managing) as changed with OBinder::Changed.

Sometimes you need to discard changes that have been made. To do this, call DiscardChanges.

After the changes are discarded, all attached bound objects are refreshed with correct values.

Return Value
An oresult indicating whether the operation succeeded (OSUCCESS) or not (OFAILURE).

Example
This example considers handling an OBinder when it is about to be closed.

// Here's an OBinder that we are using to edit a table

OBinder tableedit;

// setup of tableedit goes here (see Workbook for a sample).

// now the user is closing the window. Deal with any changes.

if (tableedit.IsChanged())

{ // the current record has a change in it

// ask the user if they want to save the change

int yesno = Message("Do you want to save the change?");

if (yesno == YES_ANSWER)

tableedit.Update();

else

tableedit.DiscardChanges();

}

Now we can close the window.

By the way, the default behavior when an OBinder is destroyed is for it to Update().

Home

Book List

Contents