LDicomDS::CreateGraphicAnnSQItem

#include "Ltdic.h"

L_UINT16 LDicomDS::CreateGraphicAnnSQItem(nIndex, pszLayerName)

L_UINT32 nIndex;

/* index value */

L_CHAR* pszLayerName;

/* layer name */

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

Parameter

Description

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, 0002), 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:

LDicomDS::FindNextGraphicAnnSQItem, LDicomDS::GetLayerName, LDicomDS::SetLayerName, LDicomDS::AddLayerImageRef, LDicomDS::GetLayerImageRefCount, LDicomDS::RemoveImageRefFromLayer, LDicomDS::RemoveAllImageRefsFromLayer, LDicomDS::RemoveAllImageRefFromAllLayers, LDicomDS::GetLayerImageRefElement, Class Members

Topics:

Working with DICOM Annotations

Example

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