Public Function GetChildElement( _
   ByVal element As DicomElement, _
   ByVal includeVolatile As Boolean _
) As DicomElement

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim element As DicomElement Dim includeVolatile As Boolean Dim value As DicomElement   value = instance.GetChildElement(element, includeVolatile)

public DicomElement GetChildElement( 
   DicomElement element,
   bool includeVolatile
)

public:
DicomElement^ GetChildElement( 
   DicomElement^ element,
   bool includeVolatile
) 

Parameters

element

An item in the Data Set.

includeVolatile

true to retrieve the first child element, volatile or non-volatile; false to retrieve the first non-volatile child element.

Return Value

The following methods will also help you navigate the Data Set:

GetFirstElement

GetLastElement

GetNextElement

GetParentElement

GetRootElement

A volatile element is an element that can be changed or destroyed in the process of inserting or setting an image. A non-volatile element is an element that must be changed manually; it is not changed or destroyed by inserting or setting an image.

For example, a grayscale image has elements DicomTag.SmallestImagePixelValue, DicomTag.LargestImagePixelValue, etc. If the image is changed to a color image, these elements disappear and the following elements appear: DicomTag.RedPaletteColorLookupTableDescriptor, etc. These are volatile elements since they are changed or destroyed when an image is changed or set.

To retrieve a child element that must be changed manually, i.e., is not volatile, set includeVolatile to false. To retrieve a child element that may be either volatile or non-volatile, set includeVolatile to true.

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference