LDicomDS::GetPresStateImageRefBySOPInstance

#include "Ltdic.h"

pDICOMELEMENT LDicomDS::GetPresStateImageRefBySOPInstance(pszSOPInstanceUID)

L_TCHAR * pszSOPInstanceUID;

/* SOP Instance UID of the image */

Returns a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module".

Parameter

Description

pszSOPInstanceUID

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

Returns

!NULL

SUCCESS

NULL

An error occurred.

Comments

This function will return a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module". A NULL pointer will be returned if the item could not be found.

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::GetPresStateImageRefSOPInstance, LDicomDS::GetPresStateImageRefCount, LDicomDS::FindFirstPresStateRefSeriesItem, LDicomDS::FindNextPresStateRefSeriesItem, Class Members

Topics:

Working with DICOM Annotations

 

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

Example

L_INT LDicomDS_GetPresStateImageRefBySOPInstanceExample(LDicomDS& PresStateDS, L_TCHAR* pszSOPInstanceUID) 
{
   L_TCHAR        szText[256] = TEXT("");
   pDICOMELEMENT  pElement = PresStateDS. GetPresStateImageRefBySOPInstance(pszSOPInstanceUID); 
   if (pElement) 
   {
      pElement = PresStateDS.GetChildElement(pElement, TRUE); 
      if (pElement) 
      {
         pElement = PresStateDS.FindFirstElement(pElement, TAG_REFERENCED_SOP_CLASS_UID, TRUE); 
         L_TCHAR*  pszClassUID = PresStateDS.GetStringValue(pElement, 0, 1); 
         if (pszClassUID) 
         {
          wsprintf(szText, TEXT("Image Referenced SOP class UID is: %s "), pszClassUID); 
          MessageBox( NULL, szText, TEXT("Note"), MB_OK);
        }
      }
   }
   return DICOM_SUCCESS;
}