MoveFirstElement method (ILEADDicomDS)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short MoveFirstElement ( BOOL bTree );

Overview

Refer to Working with Data Sets.

Remarks

Updates the CurrentElement property to the first item in the Data Set. The result depends on whether the Data Set is evaluated as a list or a tree.

If the Data Set is evaluated as a tree structure, this method updates the CurrentElement property with the first item on the same level and with the same parent as the item contained in the CurrentElement property. Please note that the numbering of the items in this first illustration is arbitrary and does not imply order.

image\GetFstTr.gif

 

If the CurrentElement property contains:

The CurrentElement property will be updated with:

Item 1

Item 2

Item 3

Item 4

Item 5

Item 5

Item 6

Item 7

NULL

Item 2

If the Data Set is evaluated as a list, the CurrentElement property is updated with the first item in the list. Please note that the numbering of the items in this illustration does indicate the order of the items when the Data Set is evaluated as a list.

image\GetFtLst.gif

 

If the CurrentElement property contains:

The CurrentElement property will be updated with:

NULL

Item 1

Item 12

Item 1

Item 14

Item 1

Item 22

Item 1

Item 25

Item 1

The following methods will also help you navigate the Data Set as either a tree or a list:

MoveGetLastElement method

MovePrevElement method

MoveNextElement method

If you evaluate the Data Set as a tree, you can also use the following methods to navigate the tree:

MoveRootElement method

MoveParentElement method

MoveChildElement method

Note: Visual Basic users can either check the return value of the method, or capture and process errors to determine whether the MovexxxElement methods have completed successfully. For an example of capturing errors, refer to any of the MovexxxElement method examples.

See Also

Elements:

MoveLastElement method, MovePrevElement method, MoveNextElement method, MoveRootElement method, MoveParentElement method, MoveChildElement method

Topics:

Data Sets: Maneuvering Through a Data Set