MoveChildElement method
Builder Syntax |
int __fastcall MoveChildElement(void); |
Delphi Syntax |
function MoveChildElement: Integer; |
Overview |
Refer to Working with Data Sets. |
Remarks
Updates the CurrentElement property to the first child of the item specified in the CurrentElement property.
This method requires that the Data Set is evaluated as a tree structure.
The child is the offspring one level lower than the specified item. If the specified item has no child items, the CurrentElement property will be set to Nil (NULL). For example:
If the CurrentElement property contains: |
The CurrentElement property will be updated with: |
Item 1 |
Nil (NULL) |
Item 2 |
Item 3 |
Item 4 |
Item 5 |
Item 6 |
Nil (NULL) |
The following methods will also help you navigate the Data Set:
Note: You 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, MoveParentElement method |