IGMedDataElem Object

Description:

This objects represents DICOM Data Element. Use Double, Long and String indexed properties to access values of the data element. See Remarks, below, for additional information.

Interface:

IIGMedDataElem

Members:

Methods
GetIntegerArrayCopy Method	Returns a copy of Data Element data as a new IGIntegerArray object.
OutputDataToString Method	Outputs Data Element values in a readable form.
Resize Method	Changes ItemCount of the Data Element Value.
UpdateIntegerArrayFrom Method	Updates Data Element from an IGIntegerArray object.

Properties
Double Property	This indexed property provides access to the Data Element value item in case if items are of the Float or Double type.
ItemCount Property	This property returns the number of Items stored in the Data Element.
ItemType Property	This property returns the type of Items stored in the Data Element.
Long Property	This indexed property provides access to the Data Element value item in case if items are of the Byte, Short, WORD, Long or DWORD type.
String Property	This indexed property provides access to the Data Element value item in case if items are of the String type.
Tag Property	This property returns the Tag number of the Data Element.
ValueLength Property	This property returns the Value Length, in bytes, of the current Data Element.
ValueMultiplicity Property	This property returns the Value Multiplicity of the current Data Element.
ValueRepresentation Property	This property returns Value Representation of the current Data Element.

Remarks:

IG Medical component indexes Data Element Values as "Items" for unified access to values of various Value Representations. Each Value Representation is mapped to a certain Item Type. All string based Value Representations are mapped to String type. They can be accessed through the String Property. Floating point Value Representations are mapped to Float and Double item types, and can be accessed through the Double Property. Integer Value Representations are mapped to integer types, and can be accessed through the Long Property. The following table lists DICOM Value Representations and their correspondent Item Types:

Value Representation	Description	ItemType	Access through property:
MED_DCM_VR_AE	Application Entity	AM_TID_STRING	String
MED_DCM_VR_AS	Age Sting	AM_TID_STRING	String
MED_DCM_VR_AT	Attribute Tag	AM_TID_DWORD	Long
MED_DCM_VR_CS	Code String	AM_TID_STRING	String
MED_DCM_VR_DA	Date	AM_TID_STRING	String
MED_DCM_VR_DS	Decimal String	AM_TID_STRING	String
MED_DCM_VR_DT	Date Time	AM_TID_STRING	String
MED_DCM_VR_FL	Floating Point Single	AM_TID_FLOAT	Double
MED_DCM_VR_FD	Floating Point Double	AM_TID_DOUBLE	Double
MED_DCM_VR_IS	Integer String	AM_TID_STRING	String
MED_DCM_VR_LO	Long String	AM_TID_STRING	String
MED_DCM_VR_LT	Long Text	AM_TID_STRING	String
MED_DCM_VR_OB	Other Byte String	AM_TID_BYTE	Long
MED_DCM_VR_OF	Other Float String	AM_TID_FLOAT	Double
MED_DCM_VR_OW	Other Word String	AM_TID_WORD	Long
MED_DCM_VR_PN	Person Name	AM_TID_STRING	String
MED_DCM_VR_SH	Short String	AM_TID_STRING	String
MED_DCM_VR_SL	Signed Long	AM_TID_LONG	Long
MED_DCM_VR_SQ	Sequence of Items	AM_TID_VOID	N/A
MED_DCM_VR_SS	Signed Short	AM_TID_SHORT	Long
MED_DCM_VR_ST	Short Text	AM_TID_STRING	String
MED_DCM_VR_TM	Time	AM_TID_STRING	String
MED_DCM_VR_UI	Unique Identifier	AM_TID_STRING	String
MED_DCM_VR_UL	Unsigned Long	AM_TID_DWORD	Long
MED_DCM_VR_US	Unsigned Short	AM_TID_WORD	Long
MED_DCM_VR_UN	Unknown	AM_TID_BYTE	Long
MED_DCM_VR_UT	Unlimited text	AM_TID_STRING	String

For all Value Representations except Other Byte, Other Word and Other Float, one Item corresponds to one Value. For Other Byte, Other Word and Other Float Value Representations, which are arrays and always have Value Multiplicity of one, one item corresponds to one element of the array (Byte, Word or Float).

ItemCount Property and ItemType Property describe the Data Element Value in terms of Items. Refer to these properties before accessing the data value through Double Property, Long Property or String Property.

ValueLength Property and ValueMultiplicity Property represent Value Length and Value Multiplicity terms defined by the DICOM standard.

IG Medical component uses IGMedDataElem object for representing the Current Data Element of a Data Element List. You can change the values of the current Data Element, and change size of the Data Element, but you can not change its Value Representation (and consequently, ItemType Property). If you need to change a type of existing Data Element, remove it from the Element List, and then Insert it again, specifying the new Value Representation.