Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / DICOM Toolkit / IDLffDicomExQuery::GetValue

IDLffDicomExQuery::GetValue

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

See Also


IDLffDicomExQuery::MC_Status, IDLffDicomExQuery::Read, IDLffDicomExQuery::SetValue



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us