TreeControl class/Edit Tree Items.Add Item method

From LabVIEW Wiki
Jump to: navigation, search
VI Server Method Information
Method ID 756A3804
Scope Basic Development Environment
Data Name Edit Tree Items.Add Item
Short Name* Edit Tree Items.Add Item
Long Name* Edit Tree Items:Add Item
* Displayed here in English. Short and Long names appear in the language of the LabVIEW IDE.
Owning Class ID 66
Owning Class Name TreeControl Class
Return Data Type String data type

String

Invoke Node Edit Tree Items:Add Item
Available in Real-Time Operating SystemYes
Available in Run-Time EngineYes (Read/Write)
Loads the block diagram into memoryNo
Loads the front panel into memoryNo
Need to authenticate before useNo
Remote access allowedYes
Settable when the VI is runningYes

Adds an item to the tree control.

This method is similar to the Insert Item Before item on the shortcut menu of a tree control.

Parameters

Data type Name Required Description
String Edit Tree Items:Add Item Yes. Return value.
String Parent Tag No Unique tag of the item under which you want to add the new item. The default is an empty string, which adds the item to the highest level in the hierarchy. Avoid wiring string constants to the input of the Parent Tag parameter. Instead, use a tree control property or method that provides the unique tag of the item under which you want to add the new item.
I32 Child Position No Sets where to place the new item in relation to the item whose tag you wire to Parent Tag. Wire a value of 0 (default) to place the new item directly under the parent item. Wire a value of 1 to place the new item under the first child item, a value of 2 to place the new item under the second child item, and so on. Wire a value of -1 to place the new item under the last child item.
String Left Cell String No Text to display in the leftmost cell for the new item. The default is an empty string.
String Array Child Text No Array of strings to display in the remaining cells for the new item. The default is an array of empty strings.
String Child Tag No Unique tag for the new item. The default is the string you wire to Left Cell String. If an existing tag already uses that string, LabVIEW appends a number to the string to create a unique tag for the new item.
Boolean Child Only? No If TRUE, you cannot indent other items under the new item. The default is FALSE.

Uses

History

Version Change(s)
LabVIEW 2018 More info to come.

See Also

External Links