L_DicomCreateGraphicAnnSQItem

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomCreateGraphicAnnSQItem(hDS, nIndex, pszLayerName)

HDICOMDS hDS;	/* a DICOM handle */
L_UINT32 nIndex;	/* index value */
L_CHAR* pszLayerName;	/* layer name */

Adds a new item under the "Graphic Annotation Sequence".

Parameter	Description
hDS	A DICOM handle.
nIndex	Index value that indicates where to insert a TAG_ITEM data element in a sequence. The index is zero based, so if you want to insert a TAG_ITEM data element as the first item in the sequence, set this to 0. The value ELEMENT_INDEX_MAX indicates to add the TAG_ITEM data element to the end of the sequence.
pszLayerName	Value of the attribute "Graphic Layer " (0070, 00202), under the newly created item.

Returns

0	SUCCESS
>0	An error occurred. Refer to Return Codes.

Comments

This function will add a new item under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module". If the sequence doesn’t already exist, then this function will create it first and then add the new item.

Required DLLs and Libraries

LTDIC

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_DicomFindNextGraphicAnnSQItem, L_DicomGetLayerName, L_DicomSetLayerName, L_DicomAddLayerImageRef, L_DicomGetLayerImageRefCount, L_DicomRemoveImageRefFromLayer, L_DicomRemoveAllImageRefsFromLayer, L_DicomRemoveAllImageRefFromAllLayers, L_DicomGetLayerImageRefElement
Topics:	Working with DICOM Annotations
	Dicom Annotations: Graphic Objects

Example

L_VOID CreateAnnSequenceItem(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet = L_DicomCreateGraphicAnnSQItem ( hPresStateDS,
                                                   0,
                                                   "New Layer");
   if (nRet == DICOM_SUCCESS)
   {
     MessageBox( NULL,
                  "The Item has been created successfully.",
                  "Note",
                  MB_OK);
   }
}