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 typeNameRequiredDescription
tagYesUnique tag of the item you want to move.
New ParentNoUnique 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 PositionNoSets 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 ChildrenNoIf 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.

Data typeNo return value
Available in Run-Time EngineYes (Read/Write)
Available in Real-Time Operating SystemYes
Settable when the VI is runningYes
Loads the front panel into memoryNo
Need to authenticate before useNo
Loads the block diagram into memoryNo
Remote access allowedYes