virtual L_INT LAnnContainer::Save(pFile, uFormat=ANNFMT_NATIVE, bSelected=TRUE, pSaveOptions=NULL)
Saves annotations in the specified file.
Character string containing the name of the file to save.
Format for saving annotation data. Possible values are:
|ANNFMT_NATIVE||[0x0000] Use LEAD's own format for annotations. NOTE: This format has been replaced by ANNFMT_XML, and is no longer supported.|
|ANNFMT_WMF||[0x0001] Save the file in the Windows WMF format.|
|ANNFMT_ENCODED||[0x0004] Save as a binary format NOTE: This format has been replaced by ANNFMT_XML, and is no longer supported|
|ANNFMT_XML||[0x0005] Save the file in an XML text format. This is LEADs new text-based format which is upward-compatible. It should be used instead of ANNFMT_NATIVE. This is the default value.|
Flag that indicates which objects to save. Possible values are:
|TRUE||Save all objects that have the selected property set to TRUE. For getting and setting the selected property, use the LAnnotation::IsSelected and LAnnotation::SetSelected functions.|
|FALSE||Save only the specified object.|
Pointer to a SAVEFILEOPTION structure that contains optional extended save options. This information is used to add annotation pages or replace annotation pages in a multipage annotation file. Pass NULL to save a one-page annotation file.
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
In version 15.0, the text based format ANNFMT_XML is replacing ANNFMT_NATIVE and ANNFMT_ENCODED. Note that ANNFMT_NATIVE and ANNFMT_ENCODED are no longer supported as options with LAnnContainer::Save, LAnnContainer::SaveOffset, and LAnnContainer::SaveMemory.
For backward compatibility, this latest version of LEADTOOLS can read the discontinued formats (ANNFMT_NATIVE and ANNFMT_ENCODED) with the following functions:
The ANNFMT_XML format offers many advantages over the older annotation formats:
To save only selected objects in a container, set bSelected to TRUE.
To save all objects in a container, set bSelected to FALSE.
The information in the SAVEFILEOPTION structure can be used to add new pages or replace existing pages in a multipage annotation file of type ANNFMT_XML. Note that all the pages of an annotation multipage file must be all of type ANNFMT_XML. An annotation file cannot contain pages of different format types.
To insert new pages to an annotation multipage file:
To replace an existing page in an annotation multipage file:
For an example, refer to LAnnContainer::Load.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies