IDLffDicomExQuery::GetValue

The IDLffDicomExQuery::GetValue function method obtains a tag value within a DICOM Network Service message request.

For an example of using this method see IDLffDicomExQuery::Read.

Syntax

Result = Obj.[IDLffDicomExQuery::]GetValue ( MessageID, Tag, [, STATUS=variable] )

Return Value

This method returns the tag value for the given message ID and tag, converted to the corresponding IDL type. The value will be one of the following:

A scalar value for an attribute with one value.
A vector of values for attributes with multiple values.
A long integer if the attribute is a sequence.

Arguments

MessageID

Set this argument to an integer giving the message request ID which contains the desired tag value.

This message ID will typically come from a call to IDLffDicomExQuery::Read.

Tag

Set this argument to the desired DICOM group/element tag number. Tag can be specified either as a string or as a hexadecimal integer. For example, to return the value of DICOM tag 0020,1206 you would specify Tag as either "0020,1206" or 0x00201206.

Keywords

STATUS

Set this keyword to a named variable in which the status code for the operation will be returned. If STATUS is not specified then any error messages will be output to the screen and IDL will halt execution.

Tip: The status code can be converted to a human-readable string using the IDLffDicomExQuery::MC_Status method.

Version History

8.6.1

Introduced