In This Topic ▼

L_DicomGetLayerImageRefElement

Summary

Gets the item element of the specified SOP instance under the "Referenced Image Sequence" (0008,1140) in the specified "Graphic Annotation Sequence" (0070,0001) item.

Syntax

#include "ltdic.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetLayerImageRefElement(hDS, pGraphicAnnSQItem, pszImageSOPInstance)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pGraphicAnnSQItem

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

L_TCHAR* pszImageSOPInstance

SOP Instance UID of the image whose item element is to be retrieved.

Returns

Value	Meaning
!NULL	The function was successful.
NULL	An error occurred. Refer to Return Codes.

Comments

This function retrieves the item element of the specified SOP instance under the "Referenced Image Sequence" (0008,1140) in the specified "Graphic Annotation Sequence" (0070,0001) item.

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.

Example

L_INT DicomGetImageElementInAnnSequenceExample(HDICOMDS hPresStateDS) 
{ 
 
   pDICOMELEMENT pGraphicAnnSQItem  = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS); 
   L_TCHAR* pszSOPInstanceUID        = L_DicomGetPresStateImageRefSOPInstance( hPresStateDS, 
                                                                              L_DicomFindFirstPresStateRefSeriesItem(hPresStateDS),0); 
   pDICOMELEMENT pElement = L_DicomGetLayerImageRefElement (hPresStateDS, 
                                                            pGraphicAnnSQItem,  
                                                            pszSOPInstanceUID); 
   if (pElement) 
   { 
      MessageBox( NULL,  
                  TEXT("Element item found."),  
                  TEXT("Note"),  
                  MB_OK); 
      return DICOM_SUCCESS; 
   } 
   return DICOM_ERROR_NULL_PTR; 
}