AnnSave method (Annotation Control)

C++ Builder example

Delphi example

 

Builder Syntax

int AnnSave(AnsiString szFile, int iFormat, bool fSelected, int iModify, int nSavePage);

Delphi Syntax

Function AnnSave(szFile: String; iFormat: integer; fSelected: Boolean; iModify: Integer; nSavePage: Integer): integer;

Overview

Refer to Implementing Annotations.

Remarks

(Document/Medical only) Saves the specified annotations in a file.

Annotation Files can store multiple pages. This method saves annotations to an annotation file. It can also append, replace, or overwrite pages in an existing annotation file.

To overwrite an existing annotation file, pass SAVE_OVERWRITE for the iModify parameter (nSavePage will be ignored).

To add a page to the end of an annotation file, pass SAVE_APPEND for the iModify argument (nSavePage will be ignored).

To replace a page in an annotation file, pass SAVE_REPLACE and set iSavePage to the page number to be replaced. Note that page numbers are 1-based. Therefore, the first page is page 1, the second page is page 2, etc.

To insert a new page, pass SAVE_INSERT and set iSavePage. The new page will be inserted BEFORE the page specified in iSavePage.

Annotations can also be saved in a Wang-compatible TIFF tag. For more information concerning this option, refer to AnnSaveTag method.

See Also

Elements:

AnnLoad method, AnnSaveTag method

Topics:

Annotations (Document/Medical only): Input and Output