IDLffDICOM::GetElement

The IDLffDICOM::GetElement function method takes optional DICOM group and/or element arguments and returns an array of DICOM Element numbers for those parameters.

Syntax

Result = Obj->[IDLffDICOM::]GetElement([Group [, Element]] [, REFERENCE=list of element references])

Return Value

Returns an array of integers representing the DICOM Element numbers for the parameters of the Group and Element arguments. If no arguments or keywords are specified, the returned array contains Element numbers for all elements in the object. The effect of multiple keywords and parameters is to AND their results. If no matching elements can be found, the function returns -1.

Arguments

Group

An optional argument representing the value for the DICOM group to search for, i.e. ‘0018’x. If this argument is omitted, then all of the DICOM array elements are returned.

Element

An optional argument specified only if the Group argument has also been specified. Set this argument to the value for the DICOM element to search for, such as ‘0010’x. If this argument is omitted and the Group argument was specified, then all elements of the specified Group are returned.

Keywords

REFERENCE

Set this keyword to a list of element reference values from which to return element number values.

Examples

obj = OBJ_NEW('IDLffDICOM')

read = obj->Read(DIALOG_PICKFILE(FILTER='*'))

 

; Get references to all elements with "patient" in the description:

refs = obj->GetReference(DESCRIPTION='patient')

 

; Get the element numbers of the elements containing "patient":

FOR i = 0, N_ELEMENTS(refs)-1 DO BEGIN

   num = obj->GetElement(REFERENCE=refs[i])

   PRINT,num

ENDFOR

 

; Get the element numbers from the Patient Info group, 0010:

elements = obj->GetElement('0010'x)

PRINT, elements

 

OBJ_DESTROY,obj

Version History

5.2	Introduced