SwitchLevel method: Node class

Syntax

SwitchLevel(NewLevelNumber)

Description

The SwitchLevel methods enables you to move a node down from one level to another.

NewLevelNumber must specify a valid level number. For trees in which the Level Use parameter is set to Strictly Enforce Levels, the new level must be at least one level lower than the node’s parent level.

If the level specified by NewLevelNumber doesn't exist, it's automatically generated and added to the tree.

Parameters

Parameter	Description
NewLevelNumber	Specify the level number to where you want the node moved.

Returns

A zero (0) if node is moved successfully, a different error number otherwise.