LDicomDS::AddLayerImageRef

#include "Ltdic.h"

L_UINT16 LDicomDS::AddLayerImageRef(pGraphicAnnSQItem, pszImageSOPInstance)

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_TCHAR* pszImageSOPInstance;

/* SOP Instance UID of the image to be removed*/

Adds a new item under the "Referenced Image Sequence" for the specified item under the "Graphic Annotation Sequence".

Parameter

Description

pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module".

pszImageSOPInstance

SOP Instance UID of the image to be added.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function adds a referenced image to the "Referenced Image Sequence" (0008,1140) in the specified "Graphic Annotation Sequence" (0070,0001) item in the "Graphic Annotation Module". This image should be defined previously in the "Presentation State Module".

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

See Also

Functions:

LDicomDS::GetLayerImageRefCount, LDicomDS::RemoveImageRefFromLayer, LDicomDS::RemoveAllImageRefsFromLayer, LDicomDS::RemoveAllImageRefFromAllLayers, LDicomDS::GetLayerImageRefElement, Class Members

Topics:

Working with DICOM Annotations

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

L_INT LDicomDS_AddLayerImageRefExample(LDicomDS& PresStateDS) 
{
   L_INT          nRet;
   pDICOMELEMENT  pGraphicAnnSQItem = PresStateDS.FindFirstGraphicAnnSQItem();
   L_TCHAR*       pszSOPInstanceUID = PresStateDS.GetPresStateImageRefSOPInstance(PresStateDS.FindFirstPresStateRefSeriesItem(),0); 
   nRet = PresStateDS.AddLayerImageRef(pGraphicAnnSQItem, 
                                pszSOPInstanceUID); 
   if(nRet != DICOM_SUCCESS)
      return nRet;
   if (nRet == DICOM_SUCCESS) 
   {
      MessageBox( NULL, 
                  TEXT("Referenced Image has been added successfully to the Graphic Annotation Sequence item."), 
                  TEXT("Note"), 
                  MB_OK); 
   }
   return nRet;
}