L_DicomRemoveGraphicObject

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomRemoveGraphicObject(hDS, pGraphicAnnSQItem, uGraphicObjIndex)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT uGraphicObjIndex;

/* graphic object index */

Removes the graphic annotation object at the specified index.

Parameter

Description

hDS

A DICOM handle.

pGraphicAnnSQItem

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

uGraphicObjIndex

Zero-based index of the graphic annotation object to be removed.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function will remove the graphical annotation object at the specified index in the specified "Graphic Annotation Sequence" (0070,0001) item. The index is zero-based.

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_DicomFindFirstGraphicAnnSQItem, L_DicomCreateGraphicAnnSQItem, L_DicomCreateGraphicObject, L_DicomGetGraphicObjectInfo, L_DicomSetGraphicObjectInfo, L_DicomGetGraphicObjectCount, L_DicomRemoveAllGraphicObjects, L_DicomGetGraphicObjPointCount, L_DicomGetGraphicObjElement, L_DicomConvertLEADAnnObjToDicomAnnObjs, L_DicomConvertDicomAnnObjToLEADAnnObj

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Graphic Objects

Example

L_INT DicomRemoveGraphicObjectExample(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet = L_DicomRemoveGraphicObject (  hPresStateDS,
                                                L_DicomFindFirstGraphicAnnSQItem(hPresStateDS), 
                                                0);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL, 
                  TEXT("Graphical Object has been successfully removed!"), 
                  TEXT("Note"), 
                  MB_OK);
   }
   return nRet;
}