MoveParentElement method (ILEADDicomDS)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short MoveParentElement ();

Overview

Refer to Working with Data Sets.

Remarks

Updates the CurrentElement property with the parent of the item specified in the CurrentElement property.

This method requires that the Data Set is evaluated as a tree structure.

The parent is the ancestor one level higher than the specified item. If the specified item is a Level 0 item, this method will set the CurrentElement property to 0. Please note that the numbering of the items in this illustration is arbitrary and does not imply order.

image\GetPrnt.gif

If the CurrentElement property contains:

The CurrentElement property will be updated with:

Item 1

NULL

Item 2

Item 3

Item 4

Item3

Item 5

Item 6

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

MoveFirstElement method

MoveLastElement method

MoveNextElement method

MoveRootElement 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:

MoveFirstElement method, MoveLastElement method, MoveNextElement method, MovePrevElement method, MoveRootElement method, MoveChildElement method

Topics:

Data Sets: Maneuvering Through a Data Set