Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDocument

SaveToAPrevDraft

Document Shell

The SaveToAPrevDraft method consolidates the changes in the specified range of drafts.

void SaveToAPrevDraft (in ODDraft from, 
                       in ODDraft to);

from

A reference to the first (most recent) draft in the range.

to

A reference to the last (oldest) draft in the range.

DISCUSSION

If the to parameter is kODNULL, it is set to the draft immediately previous to the from draft. This method copies the content of all the drafts between the from draft (inclusive) and the to draft (exclusive) to the to draft. It then makes all the drafts from the from draft (inclusive) to the to draft (exclusive) empty. The document shell or container application can call the CollapseDrafts method to delete these empty drafts from this document.

For this method to be successful there must be no outstanding drafts between the from draft (exclusive) and the to draft (exclusive). An outstanding draft has a reference count greater than 0, meaning that it is being used by an object.

EXCEPTIONS

kODErrDraftDoesNotExist

Either the from draft does not exist, the to draft does not exist, or the from draft is not a later draft than the to draft.

kODErrOutstandingDraft

There are outstanding drafts between the from draft (exclusive) and the to draft (exclusive).

SEE ALSO

The ODDocument::CollapseDrafts method (page 138).
The ODDraft::SaveToAPrevious method (page 183).