AnnSaveArray method (Main Control)

Visual Basic example
Visual C++ 4.0 example

Syntax short AnnSaveArray(VARIANT *pvMem, short iFormat, BOOL bSelected, short iModify, long iSavePage);

Overview: Refer to Implementing Annotations.

Remarks

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

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 (iSavePage will be ignored).

To add a page to the end of an annotation file, pass SAVE_APPEND for the iModify argument (iSavePage 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.

To see the correct data types, refer to the code example for your development system.

To load annotations from a file in memory, refer to the AnnLoadArray method.

This method can also be used in ASP.

To determine the size, use the following:

Size = UpperBound of the VARIANT – LowerBound of the VARIANT + 1;