MoveNext Method

Description:

Moves the Current Index to the next Data Element in the current level, or in the Data Element List, depending on the LevelOp parameter.

The LevelOp parameter tells the method how to move when the Current Element is positioned within a SQ Data Element. Set it to one of the two following constants:

MED_DCM_MOVE_LEVEL_FIXED: This setting tells the method to move only within the same level as the previous Current DE. Any SQs and all of their Data Elements will be skipped over. If you are in an SQ you can only move within the SQ.
MED_DCM_MOVE_LEVEL_FLOAT: This setting tells the method to move up or down as needed to get to the next DE. If the next DE is an SQ the Current DE moves down into it. At the end of the SQ the Current DE moves back to the lower levels (for example, from Level 2 to Level 1).

For Sequences, the Delimiter is assumed to be on a deeper level than the opening tag. For example, if SQ is on level 0, then the corresponding delimiter is on level 1.

Note that Sequence and Sequence Item delimiters are located on a deeper level than the Sequence or Sequence Item opening tag. For example, if SQ tag is located on level 0, then corresponding delimiter is on level 1.

Syntax:

      MoveNext(LevelOp As enumIGMedLevelOption)

Parameters:

Name	Description
LevelOp	This parameter tells the method how to move the Current Element is positioned within an SQ.

Return Value:

Returns the number of Data Elements remaining until the end is reached. If the returned value is 0, you are now at last DE, if the returned value is -1, you have attempted to move past the last DE.

Bits Per Pixel:

N/A

Sample:

Med