LDicomDS::RemoveTextObject

#include "Ltdic.h"

L_UINT16 LDicomDS::RemoveTextObject(pGraphicAnnSQItem, uTextObjIndex)

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT uTextObjIndex;

/* text object index */

Removes the text annotation object at the specified index.

Parameter

Description

pGraphicAnnSQItem

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

uTextObjIndex

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

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function will remove the text 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

See Also

Functions:

LDicomDS::FindFirstGraphicAnnSQItem, LDicomDS::CreateGraphicAnnSQItem, LDicomDS::CreateTextObject, LDicomDS::GetTextObjectInfo, LDicomDS::SetTextObjectInfo, LDicomDS::GetTextObjectCount, LDicomDS::RemoveAllTextObjects, LDicomDS::GetTextObjElement, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertDicomAnnObjToLEADAnnObj, Class Members

Topics:

Working with DICOM Annotations

 

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

Example

L_INT LDicomDS_RemoveTextObjectExample(LDicomDS& PresStateDS) 
{
   L_INT          nRet;
   pDICOMELEMENT  pGraphicAnnSQItem = PresStateDS.FindFirstGraphicAnnSQItem();
   nRet = PresStateDS.RemoveTextObject(pGraphicAnnSQItem, 0); 
   if(nRet != DICOM_SUCCESS)
      return nRet;
   if (nRet == DICOM_SUCCESS) 
   {
      MessageBox( NULL, 
                  TEXT("Textual Object has been successfully removed!"), 
                  TEXT("Note"), 
                  MB_OK); 
   }
   return DICOM_SUCCESS;
}