L_DicomFindFirstGraphicAnnSQItem

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomFindFirstGraphicAnnSQItem(hDS)

HDICOMDS hDS;

/* a DICOM handle */

Retrieves the first item under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module".

Parameter

Description

hDS

A DICOM handle.

Returns

!NULL

A pointer to a DICOMELEMENT structure that contains the first item under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module".

NULL

No items were found

Comments

This function returns the first item under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module". Use this function along with L_DicomFindNextGraphicAnnSQItem in order to enumerate all the items under the "Graphic Annotation Sequence" (0070,0001) 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_DicomFindNextGraphicAnnSQItem, L_DicomGetLayerName, L_DicomSetLayerName, L_DicomCreateGraphicAnnSQItem, L_DicomAddLayerImageRef, L_DicomGetLayerImageRefCount, L_DicomRemoveImageRefFromLayer, L_DicomRemoveAllImageRefsFromLayer L_DicomRemoveAllImageRefFromAllLayers, L_DicomGetLayerImageRefElement

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Graphic Objects

Example

L_INT DicomFindFirstGraphicAnnSQItemExample(HDICOMDS hPresStateDS)
{
   pDICOMELEMENT pGraphicAnnSQItem;

   pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS);
   while (pGraphicAnnSQItem != NULL)   
   {
      // Do something !
      pGraphicAnnSQItem = L_DicomFindNextGraphicAnnSQItem(hPresStateDS, pGraphicAnnSQItem);
   }

   return DICOM_SUCCESS;
}