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