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

Parameters

Name Data type Required Description
Tag cstr.png Yes

Unique tag of the item you want to move.

New Parent cstr.png 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 ci32.png 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? cbool.png 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.

Short Name Edit Tree Items.Move Item
Data type No return value
Available in Run-Time Engine Yes
Available in Real-Time Operating System Yes
Settable when the VI is running Yes
Loads the front panel into memory No
Need to authenticate before use No
Loads the block diagram into memory No
Remote access allowed Yes