MoveNextKey method (ILEADDicomDS)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short MoveNextKey (BOOL bTree);

Overview

Refer to Working with Key Elements.

Remarks

Updates the CurrentElement property with the key element in the Data Set that immediately follows the key element specified in the CurrentElement property. The result depends on whether the Data Set is evaluated as a tree or a list.

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

image\GetNxtTr.gif

If the CurrentElement property contains:

The CurrentElement property will be updated with:

Item 1

Item 2

Item 3

Item 4

Item 5

NULL

Item 6

Item 7

If the Data Set is evaluated as a list, the CurrentElement property is updated with the next 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\GetNtLst.gif

If the CurrentElement property contains:

The CurrentElement property will be updated with:

Item 14

Item 15

Item 4

Item 5

Item 8

Item 9

Item 19

Item 20

Item 27

Item 28

Item 30

NULL

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

MoveFirstKey method

MovePrevKey method

MoveLastKey method

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

MoveRootKey method

MoveParentKey method

MoveChildKey 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.

See Also

Elements:

MoveFirstKey method, MovePrevKey method, MoveLastKey method, MoveRootKey method, MoveParentKey method, MoveChildKey method

Topics:

Key Elements: Maneuvering Through the DICOM Dir Data Set