GetPresentationStateImageReferenceSOPInstance Method

Retrieves the SOP Instance UID for a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module".

Syntax

Visual Basic
C#
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

public string GetPresentationStateImageReferenceSOPInstance( 
   DicomElement refSeriesSQItem,
   int imageIndex
)

'Declaration
 
Public Function GetPresentationStateImageReferenceSOPInstance( _
   ByVal refSeriesSQItem As DicomElement, _
   ByVal imageIndex As Integer _
) As String

'Usage
 
Dim instance As DicomDataSet
Dim refSeriesSQItem As DicomElement
Dim imageIndex As Integer
Dim value As String
 
value = instance.GetPresentationStateImageReferenceSOPInstance(refSeriesSQItem, imageIndex)

public string GetPresentationStateImageReferenceSOPInstance( 
   DicomElement refSeriesSQItem,
   int imageIndex
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomDataSet.GetPresentationStateImageReferenceSOPInstance( 
   refSeriesSQItem ,
   imageIndex 
)

public:
String^ GetPresentationStateImageReferenceSOPInstance( 
   DicomElement^ refSeriesSQItem,
   int imageIndex
)

Parameters

refSeriesSQItem: An item element under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".
imageIndex: The zero-based index of the required SOP Instance UID.

Return Value

The SOP Instance UID of the specified referenced image (SOP Instance).

Remarks

This method 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". Call this method along with GetPresentationStateImageReferenceCount in order to enumerate all the referenced images under the specified "Referenced Image Sequence".

Example

For an example, refer to SetPresentationStateInformation.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DicomDataSet Class
DicomDataSet Members
SetPresentationStateInformation Method
GetPresentationStateInformation Method
AddPresentationStateImageReference(String,Int32[],Int32) Method
AddPresentationStateImageReference(DicomDataSet,Int32[],Int32) Method
RemovePresentationStateImageReference Method
RemoveAllPresentationStateImageReferences Method
GetPresentationStateImageReferenceCount Method
FindFirstPresentationStateReferencedSeriesItem Method
FindNextPresentationStateReferencedSeriesItem Method
GetPresentationStateImageReference Method