IDL Reference Guide: File Format Object Classes

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