DicomObjects Reference
DicomObjects Reference / DicomAttribute Object / VariantValue Method
Whether to simply the output for some environments - see remarks below for details.
VariantValue Method
Description
Value of an element, always as a variant, or array of variants, with optional elimination of single-dimension array bounds
Syntax
Visual Basic
Public Function VariantValue( _
   ByVal Simplify As Boolean _
) As Variant
Parameters
Simplify
Whether to simply the output for some environments - see remarks below for details.
Return Type
Variant
Remarks

For non-array data, this method always returns the same result as Value.

The value returned by an attribute’s default Value property is itself always a variant, but for reasons of space and efficiency, the elements of an array are of a fixed, non-variant type.  This method, on the other hand, guarantees that the array elements will themselves also be variants.  This is not very efficient, but is necessary for some scripting languages (e.g. VBScript & MatLab), which can ONLY handle variants.

To further cope with the deficiencies in some languages, which cannot cope with degenerate array dimensions (1..1), this method will eliminate such dimensions completely if the Simplify parameter is TRUE.

See Also