Overloads Public Function FindFirstElement( _
   ByVal element As DicomElement, _
   ByVal userTag As Long, _
   ByVal tree As Boolean _
) As DicomElement

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim element As DicomElement Dim userTag As Long Dim tree As Boolean Dim value As DicomElement   value = instance.FindFirstElement(element, userTag, tree)

public DicomElement FindFirstElement( 
   DicomElement element,
   long userTag,
   bool tree
)

public: DicomElement* FindFirstElement( 
   DicomElement* element,
   long userTag,
   bool tree
) 

public:
DicomElement^ FindFirstElement( 
   DicomElement^ element,
   long userTag,
   bool tree
) 

Parameters

element

An item in the Data Set.

userTag

Tag of the item to find.

tree

true to evaluate the Data Set as a tree; false to evaluate the Data Set as a list.

Return Value

If the Data Set is evaluated as a tree structure, this method returns the first item on the same level as element with the same parent as element, that has Tag userTag.

Please note that the numbering of the items of interest in this first illustration is arbitrary and does not imply order.

If the Data Set is evaluated as a list, this method returns the first item in the entire list that has Tag userTag. The search begins at the top of the list.

Please note that the numbering of the items in the following illustration does indicate the order of the items when the Data Set is evaluated as a list.

The following methods will also help you find elements in the Data Set with a specific Tag:

FindLastElement

FindPreviousElement

FindNextElement

The following methods will help you find specific modules in the Data Set:

FindModule

FindModuleByIndex

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Reference