Using border 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.

Use the BorderPanel tag to add a border panel to the main window. This tag supports the following attribute:

Attribute	Description
minWidth	Set the minimum width for a BorderPanel, in pixels. The default value is 300. The minimum height is determined by the minWidth and the overall aspect ratio of the panels contained in the BorderPanel. The minWidth attribute can be used to prevent the Dashboard Viewer from being resized so small that the displays in the BorderPanel are unreadable.

Use RTViewPanel or RTViewNavTreePanel subelement to specify .rtv files for the center, north, south, east, and west panels.

<?xml version="1.0" ?>
<panels xmlns="www.sl.com" version="1.0">
<BorderPanel title="Test of Border Panels">
  <RTViewPanel region="north" name="north_panel" display="long_panel"
    subs="$title:'North Panel'"/>
  <RTViewPanel region="center" name="center_panel" display="small_panel"
    subs="$title:'Center Panel'"/>
  <RTViewPanel region="west" name="west_panel" display="small_panel"
    subs="$title:'West Panel'"/>
  <RTViewPanel region="east" name="east_panel" display="small_panel"
    subs="$title:'East Panel'"/>
  <RTViewPanel region="south" name="south_panel" display="long_panel"
    subs="$title:'South Panel'"/>
</BorderPanel>
</panels>

When you create displays for use in border panels, the height and width of each display must be set in relation to the other displays. Displays in the west, east and center must all be equal in height. The width of the display in the north and south, must equal the combined width of the displays in the west, east and center. You will need to increase the width of the display in the north and south by the border width for each border that divides the west, center and east panels. To set the height and width of a display in the Dashboard Builder, select File | Background Properties and set the Model Width and Model Height. If you are using a background image for your display, create the image so that the height and width of the image are one pixel larger than the size you want the display to be.

The following shows dimensions of display (.rtv) files set to fit accurately in multiple display panels:

Display Name	Display Location	Model Width	Model Height
small_panel.rtv	center	320	240
small_panel.rtv	east	320	240
small_panel.rtv	west	320	240
long_panel.rtv	north	962	120
long_panel.rtv	south	962	120