LDicomDS::GetLayerImageRefSOPInstance

#include "Ltdic.h"

L_TCHAR *LDicomDS::GetLayerImageRefSOPInstance (pGraphicAnnSQItem, uImageIndex)

pDICOMELEMENT pGraphicAnnSQItem;	/* pointer to a DICOMELEMENT structure */
L_UINT uImageIndex;	/* index of the required image*/

Returns the SOP Instance UID for a referenced image (SOP Instance) under the "Referenced Image Sequence" in a certain graphic annotation item inside the "Graphic Annotation Module".

Parameter	Description
pGraphicAnnSQItem	Pointer to an item element under the "Graphic Annotation Sequence" (0007,0001) in the "Graphic Annotation Module".
uImageIndex	Index of the image(SOP Instance).

Returns

!NULL	SUCCESS
NULL	An error occurred.

Comments

This function will return the "SOP Instance UID" for a referenced image (SOP Instance) under the "Referenced Image Sequence" (0008,1140) in one of the items under the "Graphic Annotation Sequence" (0007,0001) in the "Graphic Annotation Module". Use this function along with LDicomDS::GetLayerImageRefCount in order to enumerate all the referenced images under a certain "Graphic Annotation Sequence" 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

See Also

Functions:	LDicomDS::AddLayerImageRef, LDicomDS::GetLayerImageRefCount, LDicomDS::RemoveImageRefFromLayer, LDicomDS::RemoveAllImageRefsFromLayer, LDicomDS::RemoveAllImageRefFromAllLayers, Class Members, LDicomDS::GetLayerImageRefSOPInstance, LDicomDS::GetLayerImageRefElement
Topics:	Working with DICOM Annotations
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

L_INT LDicomDS_GetLayerImageRefSOPInstanceExample(LDicomDS& PresStateDS) 
{
   L_INT          nRet;
   L_UINT         uImageCount; 
   L_TCHAR        szText[250] = TEXT("");
   pDICOMELEMENT  pAnnSQItem = PresStateDS. FindFirstGraphicAnnSQItem ();
   nRet = PresStateDS.GetLayerImageRefCount(pAnnSQItem, &uImageCount); 
   if (nRet == DICOM_SUCCESS)
   {
      L_TCHAR*  pszInstanceUID = PresStateDS.GetLayerImageRefSOPInstance(pAnnSQItem, uImageCount - 1); 
      if (pszInstanceUID) 
      {
       wsprintf(szText, TEXT("Image Referenced SOP Instance UID is: %s "), pszInstanceUID); 
         MessageBox( NULL, szText, TEXT("Note"), MB_OK);
      }
   }
   return nRet;
}