L_DicomCreateGraphicAnnSQItem

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomCreateGraphicAnnSQItem(hDS, nIndex, pszLayerName)

HDICOMDS hDS;

/* a DICOM handle */

L_UINT32 nIndex;

/* index value */

L_TCHAR* 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 doesnt 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_INT DicomCreateGraphicAnnSQItemExample(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet = L_DicomCreateGraphicAnnSQItem ( hPresStateDS,
                                                   0,
                                                   TEXT("New Layer"));
   if (nRet == DICOM_SUCCESS)
   {
     MessageBox( NULL, 
                  TEXT("The Item has been created successfully."), 
                  TEXT("Note"), 
                  MB_OK);
   }
   return nRet;
}