Contents
Navigation
Home User Reference Other Resources


The QTPlgDicomValue class allows you to specify the Value Field of a dicom Data Element. Such a field can contain one or more values of that Data Element. The type of data and format of the value(s) contained in a QTPlgDicomValue object is specified by the Value Representation field that has its class counterpart into the and class properties.

For more informations about the values that can be assigned to the property and a detailed explanation of their meaning you should read the Data Structures and Encoding document (PS 3.5) of the official documentation. However, the QTPlugin tries to allow you to deal with data element values without requiring from you a deep knowledge of the standard.

Since version 6.3 of the plugin this class can be used in Console Applications






The QTPlgDicomValue class constructors are called when you create a new instance of the class, while the ˜QTPlgDicomValue class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.
Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. A QTPlgDicomValue object is valid if it referes to a valid atom container structure (that is the value of the property is not 0) and the property is set to a legal value (that is the value returned by the property shall not be ).

The class provides you with the following initializer methods:
(valueFormat as string)
use this constructor to assign to the class instance the Value Representation specified by the two character string passed into the valueFormat; this string must be one of those defined by the DICOM Standard
(group as integer, element as integer)
use this constructor to specify the associates to the Standard Data Element identified by its Group and Element number (the group and element parameters respectively)
a Standard Data Element is a Data Element defined in the DICOM Standard, and therefore listed in the DICOM Data Element Dictionary in PS 3.6
(other as QTPlgDicomValue)
This is the copy constructor. The properties of the object to be copied will be used to initialize the new class instance properties

specifies the type of data associated to the in use; this property returns one of the listed below. Depending on the type of data, you can choose the appropriate class property to get or set the object value(s)
specifies the data type and format of the value(s) the current object can deal with
specifies the string value of the component of the value field. You can use this property only if the value of the class property is .
At time, it is not possible to add to the list more than one string value; this implies that, if you need to deal with value field of a data element with Value Multiplicity greater than 1, you should format appropriately the string by yourself and then add it to the list. This limitation does not affect the other types of data
specifies the integer value of the component of the value field that corresponds to the index i; this index ranges from 0 to –1. You can use this property only if the value of the class property is . If you want to add a new value component to the list pass –1 into the index i.
specifies the double value of the component of the value field that corresponds to the index i; this index ranges from 0 to –1. You can use this property only if the value of the class property is . If you want to add a new value component to the list pass –1 into the index i
specifies a memoryblock as value of the component of the value field that corresponds to the index i; this index ranges from 0 to –1. You can use this property only if the value of the class property is . If you want to add a new value component to the list pass –1 into the index i


the type of data associated to the in use is unknown
the type of data associated to the in use can be represented with a string
the type of data associated to the in use can be represented with an integer
the type of data associated to the in use can be represented with a double
the type of data associated to the in use can be represented with a memoryblock