AnnSaveArray method (ILEADRasterAnnotation)

Remarks

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

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

To replace a page in an annotation file, pass SAVE_REPLACE and set lSavePage 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 lSavePage. The new page will be inserted BEFORE the page specified in lSavePage.

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;

In version 14.5, the text based format ANN_FMT_XML is being introduced. It has many advantages over ANN_FMT_NATIVE and ANN_FMT_ENCODED including:

It is both forward- and backward-compatible.

It is human readable.

It can be easily modified using a standard text editor (i.e. notepad.exe).

It can be easily parsed using any standard XML parser.

It can be used with any of the growing number of utilities that work with XML.

For more information, refer to New Annotation Features of Version 14.5.

See Also