Creating row-node format tree controls
In the row-node format tree control, there is one row in the table for each node in the tree, including the top-level node rather than just one row for each of the leaf nodes as with the row-leaf format.
There are two columns in the table that help define the tree structure:
One of the table columns contains a node ID string and is identified by the
nodeIdColumnName property. By default, the node ID string is used as the node label in the tree. The node ID string must be unique among all nodes with the same parent. Or, if the
uniqueNodeIdFlag property is checked, each node ID string must be unique in the entire tree.
Another table column contains the ID of the parent node, which is identified by the
parentIdColumnName property.
To create the same tree as the row-leaf format example in the previous topic, a table representation of the tree control using the row-node format would be as follows:
Node | Parent |
app0 | <blank> |
1000 | app0 |
1004 | app0 |
1008 | app0 |
app1 | <blank> |
1001 | app1 |
1005 | app1 |
The <blank> entries represent an empty string, which indicates that nodes app0 and app1 have no parent, making them top-level nodes in the tree.
Set the tree control properties as follows:
valueTable property to attach to the table that contains the data to be displayed
valueTableFormat property to the
Row-Node format
nodeIdColumnName property to
Node parentIdColumnName property to
Parent The result is a tree structure with two top-level nodes labeled app0 and app1. Node app0 has three child nodes labeled 1000, 1004, 1008. Node app1 has two child nodes, labeled 1001 and 1005.
To add another tree level for the AgentName, as in the the Row-Leaf format example in the previous topic, modify the table as follows:
Node | Parent |
Agent1 | <blank> |
app0 | Agent1 |
1000 | app0 |
1004 | app0 |
1008 | app0 |
Agent2 | <blank> |
app0 | Agent2 |
1000 | app0 |
1004 | app0 |
app1 | Agent2 |
1001 | app1 |
1005 | app1 |
Also, uncheck the uniqueNodeIdFlag property to allow for node IDs that are not unique, such as the app0 and 1000 nodes in the example, which are used in multiple tree levels. Because some of the rows are also identical, the order of the table rows is important. For example, this row appears twice in the table: 1000 app0. In each case the 1000 app0 row comes after a unique parent row: first under app0 Agent1 and then under app0 Agent2. The tree uses this information to determine where to place the node for 1000 in each case.
The tree now has two top-level nodes labeled Agent1 and Agent2, each with two child nodes, app0 and app1.
By default, the node ID string is used as the node label in the tree. If a different column in the table must provide the label, specify the name of that column in the nodeLabelColumnName property.
In the row-node format, each branch of the tree can have a different depth, while in the row-leaf format all branches typically have the same depth, which is the number of columns specified in the nodeIndexColumnNames property.
To modify tree control icons or configure tree control icon behavior, see
Configuring tree control icons.