Edit Tree Items:Add Item Method

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help
LabVIEW 2020 Help

Short Name: Edit Tree Items.Add Item

Requires: Base Development System

Class: TreeControl Methods

To Use: Create a method.

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 typeNameRequiredDescription
Parent TagNoUnique 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 PositionNoSets 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. If the value you wire to this input is greater than the number of child items under the parent item, the method places the new item under the last child item.
Left Cell StringNoText to display in the leftmost cell for the new item. The default is an empty string.
Child TextNoArray of strings to display in the remaining cells for the new item. The default is an array of empty strings.
Child TagNoUnique 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. You cannot create a tag that begins with TREE_. All tags that begin with TREE_ are reserved for use by LabVIEW. If the tag you wire to the method begins with TREE_, LabVIEW prepends an underscore (_) to create a valid tag for the new item. If the tag you wire to the method begins or ends with white space or non-printing characters, such as a tab or new line, LabVIEW removes the white space or non-printing characters.
Child Only?NoIf TRUE, you cannot indent other items under the new item. The default is FALSE. This property is similar to the Child-Only Item item on the shortcut menu of a tree control.

Remarks

The following table lists the characteristics of this method.

Data type
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

WAS THIS ARTICLE HELPFUL?

Not Helpful