IDLffDICOM::GetChildren

The IDLffDICOM::GetChildren function method is used to find the member element references of a DICOM sequence. It takes as an argument a scalar reference to a DICOM element representing the parent of the sequence.

Syntax

Result = Obj->[IDLffDICOM::]GetChildren(Reference)

Return Value

Returns an array of references to the elements of the object that are members of that sequence. The scalar parent reference is possibly obtained by a previous call to GetReference or any method that generates a reference list. Any member of a sequence may also itself be the parent of another sequence. If the scalar reference argument is not the parent of a sequence, the method returns -1.

Arguments

Reference

A scalar reference to a DICOM element that is known to be the parent of a DICOM sequence.

Keywords

None

Examples

obj = OBJ_NEW('IDLffDICOM')

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

 

; Get a list of references to all elements that are sequences:

refs = obj->GetReference(VR='SQ')

 

; Cycle through the returned list and print out the immediate

; children references and descriptions of each sequence:

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

   IF (refs[i] NE -1) THEN $

      BEGIN

         children = obj->GetChildren(refs[i])

         FOR j = 0, N_ELEMENTS(children)-1 DO $

            BEGIN

               PRINT,children[j]

                 PRINT,obj->GetDescription(REFERENCE=children[j])

         ENDFOR

   ENDIF

ENDFOR

OBJ_DESTROY,obj

Version History

5.2	Introduced