GetStringValuePtr Method

Gets a pointer to a string value that is stored in the Value Field of the specified element.

Syntax

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

public IntPtr GetStringValuePtr( 
   DicomElement element,
   int index
)

'Declaration
 
Public Function GetStringValuePtr( _
   ByVal element As DicomElement, _
   ByVal index As Integer _
) As IntPtr

'Usage
 
Dim instance As DicomDataSet
Dim element As DicomElement
Dim index As Integer
Dim value As IntPtr
 
value = instance.GetStringValuePtr(element, index)

public IntPtr GetStringValuePtr( 
   DicomElement element,
   int index
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomDataSet.GetStringValuePtr( 
   element ,
   index 
)

public:
IntPtr GetStringValuePtr( 
   DicomElement^ element,
   int index
)

Parameters

element: An item in the Data Set.
index: The zero-based index of the string value to retrieve, when more than one value is stored in the Value Field.

Return Value

A pointer to a string value stored in the Value Field of the specified Data Element. It is null if The length of the Value Field is 0, the method was called for the incorrect Value Representation type, or the method was called for a folder (sequence) element.

Remarks

The method can be used to get one string value at a time. Therefore, if multiple values are stored in the Value Field, the method needs to be called multiple times to get all the values. This method can be called only if the Value Representation of the Data Element is:

For more information about Value Representations, refer to Default Value Representation Table.

Example

For an example, refer to SetIntValue(DicomElement,IntPtr,Int32).

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