The argument to AddItems is a 3, 4 or 5-element array as follows:
| [1] | Item number | Integer. |
| [2] | New items | Vector of character vectors. |
| [3] | Depth vector | Integer vector. |
| [4] | Picture vector | Integer vector. |
| [5] | Selected picture vector | Integer vector. |
Item number specifies the index of the item to which the child items are to be added.
New items is a vector of character vectors containing the labels for the new child items.
Depth vector is an integer vector specifying the depth of each of the new items relative to the parent item to which they are being added. The first element of this array must be 0. This element may be omitted. If so, it is assumed to be all 0s.
Picture vector and Selected picture vector are optional and specify values of ImageIndex and SelImageIndex respectively for each of the new items.
The new items are inserted with the first one being placed at the same level in the hierarchy as the item specified in element [1].
The result is an integer that reports the index position at which the first of the new items has been inserted.