Page History
...
The AddItems property adds new items to the existing tree. Specifically, it allows you to add new child items to an existing item. The DestItem parameter is the key of the item to which the new items should be added. Set it to "" if want to add the items to the Root Item. The NewItems parameter is formatted as an @FM delimited array of tree items. Each field in the array represents a single new item, and the multivalue structure for each field is as follows:
| Pos | Name | Type | Description | <1, 1>Default | ||
|---|---|---|---|---|---|---|
<1> | Level | Integer | The item's level in the tree | |||
<2> | <1, 2>Key | Text | The item's unique key | |||
<1, 3><3> | Data | Text | The item's data | "" | ||
<4><1, 4> | Data Type | |||||
<1, 4, <4, 1> | Type | Option | The item's data type, used to make sorting most accurate and efficient | Text | ||
<1<4,4, 2> | Format | Formatted String | The item's data format, used to present the data to the user | "" | ||
<5><1, 5> | Class | Text | The item's class, an application specific string that can used for classification purposes | "" | ||
<6><1, 6> | Image | Formatted String | The item's image, either a file or a key pointing to a global image | "" | ||
<7><1, 7> | Colors | |||||
<1, 7, <7, 1> | Text Color | Color | The color of the item's text | WindowText | ||
<1<7,7, 2> | Background | Color Fill | The item's background | Window | ||
<1, 8><8> | Font | Font | The font used to render the item's data | Tahoma, 8 pt. | ||
<9><1, 9> | Alignment | |||||
<1, 9, <9, 1> | Horizontal | Option | The horizontal alignment of the item's data | Left | ||
<9, <1, 9, 2> | Vertical | Option | The vertical alignment of the item's data | Center | ||
<1, 10><10> | Sort | Option | The item's sort setting | None | ||
<11><1, 11> | Check Box | Option | The item's check box setting | None | ||
<12><1, 12> | Expandable | Boolean | Whether or not the item can be expanded or collapsed by the user | 1 | ||
<13><1, 13> | Height | Integer | The item's height | 16 | ||
<14><1, 14> | Hyperlink | Boolean | Whether or not the item displays hyperlink feedback to the user | 0 | ||
<1, 15><15> | Selectable | Boolean | Whether or not the item can be selected by the user | 1 | ||
<16> | Swatch Color | Color Fill | A custom colored rectangle that appears at the beginning or end of an item | None | ||
<17> | Swatch Position | Option | The position of the swatch, if there is one: Left or Right | Left | ||
<18> | Swatch Size | |||||
<18, 1> | Width | Integer | The swatch width, in pixels, if there is one | 13 | ||
<18, 2> | Height | Integer | The swatch height, in pixels, if there is one | 13 | ||
<19> | Fields | List of user defined fields and their values: each value has the following format: | "" | |||
<19, x, 1> | Field Name | Text | The unique field name | "" | ||
<19, x, 2> | Field Value | Text | The field's value | "" | ||
The first two values, Level and Key, must be included for every item. All other values are optional.
Level
The first value of every item is its level within the tree. The level will be used to determine where the item fits within the hierarchy. If an item's level is greater than the item preceding it, then it becomes that item's child. Since the SRP Tree Control is a true hierarchy, the levels will be interpreted in terms of relativity, not actual value. For example, if you set item 1 to level 1 and item 2 to level 8, item 2 will still be a direct child of item 1. It's important to note that the level is relative to the destination item's level. That is, a new item at level 1 will be added as a direct child of the destination item, not as a child of the Root Item.
...
See the Item property for more details on each of the possible values in the data structure.
Example
| Code Block |
|---|
// Assume a tree with boys and girls organized into teams // Add a couple boys and girls to the blue team NewItems = "" NewItems<-1> = 1:@VM:"Grace":@VM:"Grace":@VM:@VM:"Girl" NewItems<-1> = 1:@VM:"Kaylee":@VM:"Kaylee":@VM:@VM:"Girl" NewItems<-1> = 1:@VM:"Alexander":@VM:"Alexander":@VM:@VM:"Boy" NewItems<-1> = 1:@VM:"Nathan":@VM:"Nathan":@VM:@VM:"Boy" Send_Message(@Window:".OLE_TREE", "OLE.AddItems", "BlueTeam", NewItems) |
...
