LDicomDS::GetPresStateImageRefSOPInstance

#include "Ltdic.h"

L_TCHAR* LDicomDS::GetPresStateImageRefSOPInstance(pRefSeriesSQItem, uImageIndex)

pDICOMELEMENT pRefSeriesSQItem;

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 the "Presentation State Module".

Parameter

Description

pRefSeriesSQItem

Pointer to an item element under the "Referenced Series Sequence" (0008,1115) in the "Presentation State 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,1115) in one of the items under "Referenced Series Sequence" (0008,1115) in the "Presentation State Module". Use this function along with LDicomDS::GetPresStateImageRefCount in order to enumerate all the referenced images under the specified "Referenced Image Sequence".

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::SetPresStateInfo, LDicomDS::GetPresStateInfo, LDicomDS::AddPresStateImageRefByFileName, LDicomDS::AddPresStateImageRefByDS, LDicomDS::RemovePresStateImageRefBySOPInstance, LDicomDS::RemoveAllPresStateImageRefs, LDicomDS::GetPresStateImageRefCount, LDicomDS::FindFirstPresStateRefSeriesItem, LDicomDS::FindNextPresStateRefSeriesItem, LDicomDS::GetPresStateImageRefBySOPInstance, Class Members

Topics:

Working with DICOM Annotations

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C++ Class Library Help