Collapse All Expand All

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

Platforms

Win32, x64, Linux.

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;
}