Specifying tree control node structure properties
The following properties specify the node structure in the tree control.
nodeStatusIconPosSpecify the status icon position in the tree: Left or Right. By default, the status icon appears on the left of the node label. If a node has both a type icon and a status icon, the type icon always appears to the left of the status icon. By default, no status icons appear in the tree.
nodeStatusProperties This property specifies the status icon for a node. By default, no status icon is displayed.
Click the
button to open the
Node Properties dialog and map images to values, and set the status priority order for propagation up the tree.
NThe nodeStatusProperties property is visible only if the nodeStatusColumnName property is non-blank.
You can also use the nodeStatusProperties property to attach a status icon to data. The data attachment must be a three-column table. Typically, a static XML file containing the table is used. The first column must contain string values that match values from the column in the valueTable specified by the nodeStatusColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The third column must contain the non-negative integer priority value.
A static XML file is read once each time you run Dashboard Viewer. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static.
nodeTypeProperties This property specifies the type icon for a node. By default, non-leaf nodes in the tree use a folder image and leaf nodes use a document image.
Click the
button to open the
Node Properties dialog to map images to nodes. Mapping can be based on the node depth in the tree or the type of node.
You can also use the nodeTypeProperties property to attach a type icon to data. The data attachment must be a two-column table. Typically, a static XML file containing the table is used. The first column must contain string values of _node (for non-leaf nodes), _leaf (for leaf nodes), numeric values for depth, or string values that match the node labels, or the values from the column in the valueTable specified by the nodeTypeColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The default assignments are _node, rtvTreeNode16.png and _leaf, rtvTreeLeaf16.png. The column names are not important.
oThe logic for determining which type icon is used is as follows.
If the nodeTypeColumnName property specifies column C, and the value of C in the valueTable row that corresponds to N is V, and there is a row in nodeTypeProperties that assigns value V to image I1, then I1 is used as the type icon for N. Otherwise:
If the label of node
N is
XYZ, and there is a row in the
nodeTypeProperties property that assigns value
XYZ to image
I2, then
I2 is used. Otherwise,
If the depth of node
N is
D, and there is a row in the
nodeTypeProperties property that assigns depth
D to image
I3,
I3 is used. Otherwise,
If
N is a leaf, and the leaf node image is
I4,
I4 is used. If
I4 is blank no type icon appears. Otherwise,
If the non-leaf node image is
I5,
I5 is used. If
I5 is blank no type icon appears.
A static XML file is read once each time you run Dashboard Viewer. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static.
rootNodeLabel Specify whether the tree root node is visible. By default, this property is blank and the root node is not visible.