Adds items after all existing items in the tree control.
This method returns an error if you set an item to an indent level that has no parent item.
Parameters
Name
Required
Description
Items
No
An array of clusters that describe the items you want to add.
Name
Description
Left Cell String
Text to display in the leftmost cell for the new item. The default is an empty string.
Child Text
Array of strings to display in the remaining cells for the new item. The default is an array of empty strings.
Child Tag
Unique tag for the new item. The default is the string you wire to Left Cell. 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, LabVIEW removes the white space.
Item Indent
The level in the hierarchy at which to place the new item. Wire a value of 0 (default) to place the new item at the highest level in the hierarchy, wire a value of 1 to indent the new item one level, and so on. If the value you wire to this input would indent the new item more than one level under its parent item, the method returns an error.
Child Only?
If 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.
Glyph Index
An integer representing the glyph index associated with the item.
Left Cell String—Text to display in the leftmost cell for the new item. The default is an empty string.
Child Text—Array of strings to display in the remaining cells for the new item. The default is an array of empty strings.
Child Tag—Unique tag for the new item. The default is the string you wire to Left Cell. 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, LabVIEW removes the white space.
Item Indent—The level in the hierarchy at which to place the new item. Wire a value of 0 (default) to place the new item at the highest level in the hierarchy, wire a value of 1 to indent the new item one level, and so on.
If the value you wire to this input would indent the new item more than one level under its parent item, the method returns an error.
Child Only?—If 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.
Glyph Index—An integer representing the glyph index associated with the item.
output
No
Tags for the new items.
Remarks
The following table lists the characteristics of this method.
Available in Run-Time Engine and Real-Time Operating System