L_DicomGetTextObjElement

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetTextObjElement(hDS, pGraphicAnnSQItem, uObjIndex)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT uObjIndex;

/* text annotation object index */

Gets the item element of the specified text annotation object.

Parameter

Description

hDS

A DICOM handle.

pGraphicAnnSQItem

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

uObjIndex

Text annotation object index whose item element is to be retrieved.

Returns

!NULL

The function was successful.

NULL

An error occurred. Refer to Return Codes.

Comments

This function retrieves the item element under the "Text Object Sequence" (0070,0008) of the specified text annotation object, if the element could not be found it returns NULL.

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_DicomCreateTextObject, L_DicomRemoveTextObject, L_DicomGetTextObjectInfo, L_DicomSetTextObjectInfo, L_DicomGetTextObjectCount, L_DicomRemoveAllTextObjects, L_DicomConvertLEADAnnObjToDicomAnnObjs, L_DicomConvertDicomAnnObjToLEADAnnObj

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Text Objects

Example

L_INT DicomGetTextObjElementExample(HDICOMDS hPresStateDS)
{
   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS);
   pDICOMELEMENT pElement = L_DicomGetTextObjElement ( hPresStateDS,
                                                      pGraphicAnnSQItem , 
                                                      0);
   if (pElement)
   {
      MessageBox( NULL, 
                  TEXT("Item element for this layer has been found."), 
                  TEXT("Note"), 
                  MB_OK); 
      return DICOM_SUCCESS;
   }
   return DICOM_ERROR_NULL_PTR;
}