Apama 10.15.0 | Building and Using Apama Dashboards | Building Dashboard Clients | Reusing Dashboard Components | Working with multiple display panels | Using old tags to configure the panels in a window | Using border panels
 
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.
Here is an example:
<?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