LDicomDS::RemoveImageRefFromLayer

#include "Ltdic.h"

L_UINT16 LDicomDS::RemoveImageRefFromLayer(pGraphicAnnSQItem, pszImageSOPInstance)

pDICOMELEMENT pGraphicAnnSQItem;	/* pointer to a DICOMELEMENT structure */
L_TCHAR* pszImageSOPInstance;	/* Referenced image SOP instance UID */

Removes a referenced image from the "Referenced Image Sequence" in the specified "Graphic Annotation Sequence" item.

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 removed.

Returns

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

Comments

This function removes a referenced image from the "Referenced Image Sequence" (0008,1140) in the specified "Graphic Annotation Sequence" (0070,0001) 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

See Also

Functions:	LDicomDS::AddLayerImageRef, LDicomDS::GetLayerImageRefCount, LDicomDS::RemoveAllImageRefsFromLayer, LDicomDS::RemoveAllImageRefFromAllLayers, LDicomDS::GetLayerImageRefElement, Class Members, LDicomDS::GetLayerImageRefSOPInstance
Topics:	Working with DICOM Annotations
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

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