IDLffDICOM::GetChildren

Syntax | Return Value | Arguments | Keywords | Examples | Version History

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