L_DicomRemoveLayerGraphicObjects

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomRemoveLayerGraphicObjects(hDS, pGraphicAnnSQItem)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

Removes all graphical annotation objects, which correspond to the specified item under the "Graphic Annotation Sequence" (0008,1115) in the "Graphic Annotation Module".

Parameter

Description

hDS

A DICOM handle.

pGraphicAnnSQItem

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

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function removes all graphical annotation objects, which correspond to the specified item under the "Graphic Annotation Sequence" (0008,1115) in the "Graphic Annotation 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

See Also

Functions:

L_DicomGetLayerInfo, L_DicomSetLayerInfo, L_DicomRemoveLayerByIndex, L_DicomRemoveLayerByName, L_DicomRemoveAllLayers, L_DicomGetLayerCount, L_DicomGetLayerIndex, L_DicomGetLayerGraphicObjectCount, L_DicomGetLayerTextObjectCount, L_DicomRemoveLayerTextObjects, L_DicomGetLayerElementByIndex, L_DicomGetLayerElementByName

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Layers

Example

L_VOID RemoveAllGraphicObjectsInAnnItem(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet;

 nRet = L_DicomRemoveLayerGraphicObjects(  hPresStateDS,
                                             L_DicomFindFirstGraphicAnnSQItem(hPresStateDS));
 if (nRet == DICOM_SUCCESS)
 {
      MessageBox( NULL, 
                  "Graphic objects have been successfully removed", 
                  "Note", 
                  MB_OK); 
 }
}