TreeControl class/Edit Tree Items.Add Item method
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 |
Invoke Node | |
Available in Real-Time Operating System | Yes |
Available in Run-Time Engine | Yes (Read/Write) |
Loads the block diagram into memory | No |
Loads the front panel into memory | No |
Need to authenticate before use | No |
Remote access allowed | Yes |
Settable when the VI is running | Yes |
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 |
---|---|---|---|
Edit Tree Items:Add Item | Yes. Return value. | ||
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. | |
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.
| |
Left Cell String | No | Text to display in the leftmost cell for the new item. The default is an empty string. | |
Child Text | No | Array of strings to display in the remaining cells for the new item. The default is an array of empty strings. | |
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. | |
Child Only? | No | If TRUE, you cannot indent other items under the new item. The default is FALSE. |
Uses
Specific use cases for this method. |
History
History information is needed. What changes have occurred over previous versions? |
Version | Change(s) |
---|---|
More info to come. |
See Also
Add links to internal wiki pages that would also help. |
External Links
Add links to external resources that would also help. |