In This Topic ▼

L_DicomCreateGraphicAnnSQItem

Summary

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

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomCreateGraphicAnnSQItem(hDS, nIndex, pszLayerName)

Parameters

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.

L_TCHAR* pszLayerName

Value of the attribute "Graphic Layer " (0070, 00202), under the newly created item.

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
>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 does not 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

Platforms

Win32, x64, Linux.

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; 
}