Edit Tree Items:Move Item Method

Short Name: Edit Tree Items.Move Item

Requires: Base Development System

Class: TreeControl Methods

To Use: Create a method.

Moves an existing item to a new position in the tree control.

Parameters

Data type	Name	Required	Description
	tag	Yes	Unique tag of the item you want to move.
	New Parent	No	Unique tag of the item under which you want to move the item. The default is an empty string, which moves the item to the leftmost level in the hierarchy.
	New Position	No	Sets where to place the item in relation to the item whose tag you wire to New Parent. Wire a value of 0 (default) to place the item above the first child item, wire a value of 1 to place the item above the second child item, and so on. Wire a value of –1 to place the item under the last child item. If the value you wire to this input is greater than the number of child items under the parent item, the method places the item under the last child item.
	Carry Children	No	If TRUE, the method moves any child items with the item you want to move. If FALSE (default), the method moves the child items under the parent item of the item you want to move.

Remarks

The following table lists the characteristics of this method.