L_DicomRemoveImageRefFromLayer

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomRemoveImageRefFromLayer(hDS, pGraphicAnnSQItem, pszImageSOPInstance)

HDICOMDS hDS;

/* a DICOM handle */

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

hDS

A DICOM handle.

pGraphicAnnSQItem

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

pszImageSOPInstance

SOP instance UID of the image to be removed.

Returns

DICOM_SUCCESS

The function was successful.

>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:

L_DicomAddLayerImageRef, L_DicomGetLayerImageRefCount, L_DicomRemoveAllImageRefsFromLayer, L_DicomRemoveAllImageRefFromAllLayers, L_DicomGetLayerImageRefElement

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Layers

Example

L_INT DicomRemoveImageRefFromLayerExample(HDICOMDS hPresStateDS)
{
   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS);
   L_TCHAR* pszSOPInstanceUID = L_DicomGetPresStateImageRefSOPInstance(  hPresStateDS,
                                                                        L_DicomFindFirstPresStateRefSeriesItem(hPresStateDS),0);
   if (pszSOPInstanceUID == NULL)
      return DICOM_ERROR_NULL_PTR;
   L_UINT16 nRet = L_DicomRemoveImageRefFromLayer (hPresStateDS,
                                                   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 nRet;
}