Using tree panels
The tags described in this topic are deprecated. They will be removed in a future release. You should change to the new tags. See
Using new tags to configure the panels in a window.
With tree panels, you define the contents of a tree-structured navigation pane by specifying an xml file (navtree.xml in this example) as the value of the navtreedata attribute in an RTViewNavTreePanel element:
<?xml version="1.0" ?>
<panels xmlns="www.sl.com" version="1.0">
<BorderPanel>
<RTViewPanel region="north" name="title_panel" display="title_panel"/>
<CardPanel region="center">
<RtViewPanel title=" Overview " name="main" display="main_panel"/>
</CardPanel>
<RtViewNavTreePanel region="west" width="192" height="480"
lineStyle="Angled" navtreedata="navtree.xml">
</RtViewNavTreePanel>
</BorderPanel>
</panels>
The file that you specify for the navtreedata attribute must be in XML, and must start with the following:
<?xml version="1.0" ?>
<navtree xmlns="www.sl.com" version="1.0">
The navtreedata file must end with the following:
</navtree>
The following tags are supported:
Tag | Description |
node | Add a node to the navigation tree. |
treefont | Set the font used in the navigation tree. |
treecolor | Set font and background color in the navigation tree. Specify in hexadecimal RGB format: # rrggbb (for example, #00FFFF for cyan) or the following: black, white, red, blue, green, yellow, cyan, magenta, gray, lightGray, darkGray, orange, pink. |
The node tag supports the following attributes:
Attribute | Description |
display | Name of the display (.rtv) file. |
label | Label for this node in the navigation tree. Defaults to display name if no label is set. Specify the font and color of the label using HTML. For example, to draw a green label using a 50-point italic monospaced font: label="<html><p style= 'font-family:monospaced;font-style:italic; font-size:50;color:green'> Your Label Goes Here" HTML font settings specified here override treecolor and treefont settings for this node. |
mode | If the attribute value is keepalive, the display is kept in memory the entire time the application is running. |
subs | Substitutions to apply to the display. Substitutions are optional and must use the following syntax: $subname:subvalue $subname2:subvalue2 If a substitution value contains a single quote, it must be escaped using a / : $filter:Plant=/'Dallas/' If a substitution value contains a space, it must be enclosed in single quotes. Do not escape these single quotes: $subname:subvalue $subname2:'sub value 2' A substitution string cannot contain any of the following characters: : | . tab space , = < > ' " & / \ { } [ ] ( ) |
The treefont tag supports the following attributes:
Attribute | Description |
name | Specifies the font family name. |
style | Can be set to plain, bold, italic, or bold italic. |
size | Font point size. |
The treecolor tag supports the following attributes:
Attribute | Description |
text | Specifies the font color for tree labels. |
background | Specifies the background color for the tree and non-selected tree labels. |
selection | Specifies the background color for a selected tree label. |
Here is an example:
<?xml version="1.0" ?>
<navtree xmlns="www.sl.com" version="1.0">
<node label="Nav Tree Example">
<node label="Main Displays" display="main_panel">
<node label="100 Displays">
<node label="Panel 101" mode="keepalive" display="med_panel"
subs="$title:101">
</node>
<node label="Panel 102" mode="keepalive" display="med_panel"
subs="$title:102">
</node>
<node label="Panel 103" mode="keepalive" display="med_panel"
subs="$title:103">
</node>
</node>
<node label="200 Displays">
<node label="Panel 201" display="med_panel" subs="$title:201">
</node>
<node label="Panel 202" display="med_panel" subs="$title:202">
</node>
<node label="Panel 203" display="med_panel" subs="$title:203">
</node>
</node>
</node>
</node>
</navtree>
Nodes can be nested. You can only specify one top-level node.