MoveNextIOD method

Builder Syntax	int __fastcall MoveNextIOD(bool bTree);
Delphi Syntax	function MoveNextElement(bTree: Boolean): Integer;
Overview	Refer to Working with Information Object Definitions.

Remarks

Updates the CurrentIOD property with the item in the IOD Structure that immediately follows the item specified in the CurrentIOD property. The result depends on whether the IOD Structure is evaluated as a tree or a list.

If the IOD Structure is evaluated as a tree structure, this method updates the CurrentIOD property with the next item on the same level and with the same parent as the item in the CurrentIOD property. Please note that the numbering of the items in this illustration is arbitrary and does not imply order.

$image\GetNxtTr.gif$

If the CurrentIOD property contains:	The CurrentIOD property will be updated with:
Item 1	Item 2
Item 3	Item 4
Item 5	Nil (NULL)
Item 6	Item 7

If the IOD Structure is evaluated as a list, the CurrentIOD 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 IOD Structure is evaluated as a list.

$image\GetNtLst.gif$

If the CurrentIOD property contains:	The CurrentIOD 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	Nil (NULL)

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

MoveFirstIOD method

MovePrevIOD method

MoveLastIOD method

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

MoveRootIOD method

MoveParentIOD method

MoveChildIOD method

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