L_DispContainerSaveAnnotation

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSaveAnnotation(hCon, pFileName, nCellIndex, nSubCellIndex, nStartPage, uFlags)

HDISPCONTAINER hCon;

/* handle to the container */

LPTSTR pFileName;

/* output file name */

L_INT nCellIndex;

/* index of the cell */

L_INT nSubCellIndex;

/* index into the image list attached to the cell */

L_INT nStartPage;

/* the page number of a multi-page file */

L_UINT uFlags;

/* reserved for future */

Saves the annotation of the specified cell or sub-cell to a file. This function is available only in the Medical Imaging Suite toolkit.

Parameter

Description

hCon

Handle to the Container.

pFileName

Character string that contains the name of the file to save.

nCellIndex

A zero-based index of the cell for which to save the annotation. Pass -2 to save the annotation of the selected cell.

nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This sub-cell contains the image the annotation that will be saved. Pass -2 to refer to the selected sub-cell. If the cell contains 1 frame then the nSubCellIndex should be 0.

nStartPage

The page number of a multi-page file, which can contain more than one image.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function saves the annotation to an XML file. To load the saved annotation file use L_DispContainerLoadAnnotation.

Required DLLs and Libraries

LTIVW
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_DispContainerSetAnnotationContainer, L_DispContainerAnnToRgn, L_DispContainerGetSelectedAnnotationAttributes, L_DispContainerSetAnnotationCallBack, L_DispContainerGetAnnotationCallBack, L_DispContainerGetAnnotationContainer, L_DispContainerSetAnnotationCreatedCallBack, L_DispContainerLoadAnnotation, DISPCONTAINERANNOTATIONCALLBACK, DISPCONTAINERANNOTATIONCREATEDCALLBACK

Topics:

Image Viewer Cells

 

Image Viewer Functions: Working with Annotations

Example

XXX