QMedical Command Reference DICOM Data

QMed_GetElementDataAsLong

QMed_GetElementDataAsLong(imageRef; elementRef; itemIndex; elementData):error
	imageRef	Longint	Reference to the image
	elementRef	Longint	Element reference
	itemIndex	Longint	Item index
	elementData	Longint	Element data
	error	Longint	Error result

Returns the content of a data element item as a longint.

The DICOM image file is specified by imageRef. If imageRef is not a valid image reference, error qmed_paramErr is returned. If imageRef is a valid image reference but the image is not in the DICOM format, error qmed_badComponentType is returned.

Parameter elementRef specifies the data element. The element reference must have been previously obtained with a call to QMed_GetElements or QMed_FindElement. If elementRef is not a valid element reference, error qmed_badDataElementRef is returned.

Parameter itemIndex specifies the item index whose data is to be returned. The item index must be greater than 0 and less than or equal to the number of items (multiplicity) of the data element, otherwise error qmed_badElementItemIndex is returned.

Parameter elementData receives the element data casted to a longint. If the element is empty (data size is 0), error qmed_noElementDataErr is returned.

The data element types (value representations) supported by this command are listed in the following table. All other types trigger a qmed_badElementTypeErr error.