Attaching a tree control icon to data
For convenience, both the type icon and the status icon can be attached to data. The type icon and status icon have different data table requirements. Typically, an attachment to a static XML file containing the appropriate tables is used. The following describes the data table format requirements:
Type icon — To attach the type icon to data, use the
nodeTypeProperties property. 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
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.
Status icon — To attach the status icon to data, use the
nodeStatusProperties property. 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
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. For details, see Creating XML Sources.