With Multiple Display Panels you can deploy several displays, arranged in separate panels, within a single window. This option is not available in the Display Builder, but is supported in all Enterprise RTView deployments .

See demos/multipanels for examples of using Multiple Display Panels.

Configuring Multiple Display Panels
By default, the Display Viewer Application, Display Viewer Applet and Display Server read the PANELS.ini file to populate panels with the specified displays. If the panel configuration file is not found in the current directory, the Display Viewer and Display Server applications will search under lib in your installation directory.

In the Display Viewer Application and Display Viewer Applet, you may specify a different panel configuration file on the command line or in an applet parameter:

    command line: -panelconfig:filename
    applet parameter: name= panelconfig value=filename

NOTE:  To run the Display Viewer Application without a panel configuration file, when PANELS.ini is present in the current directory or the lib directory, use the above command line argument with no file name.

In the Display Server, you may specify a different panel configuration in the URL:

    http://host:8080/rtvdisplay/panels.jsp?file=filename.

NOTE: PANELS.ini formats and associated tags supported in previous releases are still supported. However, the new tags listed below cannot exist in the same PANELS.ini file with any older tags.
 

Tag	Description	Attributes
		Name	Description
rtvLayout	The rtvLayout tag can appear only once in PANELS.in and expects each child tag to specify a region (i.e. north, south, east, west, or center) in order to determine the location of each child panel. Typically, an rtvLayout will contain one of the following combinations: A main rtvDisplayPanel with region="center", plus either an rtvAccordionPanel or rtvTreePanel with region="west" or "east", and possibly other secondary rtvDisplayPanels in other regions. A main rtvTabbedDisplayPanel with region="center", and possibly other secondary rtvDisplayPanels in other regions. NOTE: The tags listed below can only be used within the rtvLayout tag. PANELS.ini formats and associated tags supported in previous releases are still supported. However, tags listed below cannot exist in the same PANELS.ini file with any older tags. Alternately, it is possible to use style sheets to specify colors, fonts, and other properties of the navigation panels and controls.	dividers	If true, then a draggable divider is drawn between each child panel. Default is false.
		title	Set the title of the main window.
rtvDisplayPanel	Create a panel containing the specified display.	display	Set the location of this CardPanel if it is in a BorderPanel. Valid values are: west, east, center, north and south.
		name	Corresponds to Window Name entered in the Drill Down Properties dialog. When using tabbed panels, if the name is not specified, a name is constructed internally using the display name and substitutions to make it easy to drill down between tabs. In this case, when you drill down from a tab using the Current Window option and the specified display with the specified substitutions is already loaded in another tab, the Display Viewer will switch to that tab.
		region	Position of panel in rtvLayout: west, east, center, north or south.
		subs	Specify initial substitutions for this panel. 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 the following: TabbedPanel Add a JTabbedPane to the main window. . Set the position of the tab. Valid arguments are left, right, top and bottom. NOTE: This argument is ignored by the Display Server. Tabs are always in the top position.  preload Select whether to preload displays at startup. Set to false to only load one display at a time, beginning with the display for first tab. By default, displays for all tabs are loaded at startup and are never unloaded. title , ; = < > ' " & / \ { } [ ] ( ) NOTE: Substitutions set in Application Options will apply to all displays.
rtvAccordionPanel	Create a panel containing an accordion control for display navigation. The accordion control assumes there is a rtvDisplayPanel in the center region and sends its navigation commands to that panel. NOTE: rtvAccordionPanel contents cannot be more then two levels deep (not including the root node). If deeper nesting is required, use rtvTreePanel instead.	navdata	Name of the navigation tree definition file. This XML file should describe content of the accordion control.
		width	Width (in pixels) of the panel. Default is 125.
		region	Position of panel in rtvLayout: west, east, center, north and south. Default is center.
rtvTreePanel	Create a panel containing a tree control for display navigation. The tree control assumes there is a DisplayPanel in the center region and sends its navigation commands to that panel.	navdata	Name of the navigation tree definition file. This XML file should describe content of the tree.
		width	Width (in pixels) of the panel. Default is 125.
		region	Position of panel in rtvLayout: west, east, center, north and south. Default is center.
rtvTabbedDisplayPanel	Create a panel with tabs for navigation.	tabs	Name of the tab definition file. This XML file should describe content of the tabs.
		display	Name of display (.rtv) file to load into the panel.
		subs	Specify initial substitutions for this panel. 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 the following: : | . tab space , ; = < > ' " & / \ { } [ ] ( ) NOTE: Substitutions set in Application Options will apply to all displays.
		region	Position of panel in rtvLayout: west, east, center, north and south. Default is center.
		placement	Position of tabs: top or bottom. Default is top.

Example 1
This example of PANELS.ini uses the new tags to create a title panel at the top, an accordion panel on the left, and a main display panel in the center, with draggable dividers between all the panels:

<?xml version="1.0" ?>

<panels xmlns="www.sl.com" version="1.0">

<rtvLayout title="Accordion Example" dividers="true">

    <rtvDisplayPanel region="north" name="title_panel" display="title.rtv"/>

    <rtvAccordionPanel region="west" width="200" navdata="navtree.xml"/>

    <rtvDisplayPanel region="center" name="main_panel" display="chart_main.rtv"/>

</rtvLayout>

</panels>

Example 2
This example of PANELS.ini uses the new tags to create a tabbed display panel at the top, and a title panel at the bottom:

<?xml version="1.0" ?>

<panels xmlns="www.sl.com" version="1.0">

<rtvLayout title="Tab Example">

    <rtvTabbedDisplayPanel region="center" tabs="navtabs.xml" display="stock_chart"/>

    <rtvDisplayPanel region="south" name="title_panel" display="title.rtv"/>

</rtvLayout>

</panels>

Style Sheets

Within the rtvLayout tag, style sheets can be used to specify colors, fonts and other properties of the navigation panels and controls. For detailed information about using style sheets, go to Building Displays>Style Sheets.

The following style class names and associated properties are supported in a panels configuration file, such as in the following example:

rtnav {bgColor: 7; fgColor: 12; }
rtnav-state-default {bgColor: 256; font: 1; }
rtnav-state-selected {bgColor: #4c5d65; font: 7;}
rtnav-state-hover {bgColor: #004157; }
rtnav-accordion {buttonWidth: 200;}

NOTE: If a property is specified for more than one class name, the value set for the class name with highest precedence applied. Class names (with the exception of rtnav-accordion) are listed below in order of precedence, from lowest to highest:

 

Style Class Name	Description	Properties
rtnav	Properties specified for this class are applied to all the navigation panels and controls (i.e. tabs, trees, and accordion).	bgColor	Background and foreground (text) colors. Specify color index number from the RTView color palette or RGB value (in #rrggbb format where rr, gg, bb are the red, green, and blue intensities in hexadecimal values between 00 and ff).
		fgColor
		font	Font style for navigation controls. Specify index number, as follows: 1 sans-serif 2 monospaced bold 3 monospaced 4 serif 5 monospaced italic 6 serif bold 7 sans-serif bold 8 sans-serif italic 9 serif bold italic 10 serif italic 11 sans-serif bold italic 12 monospaced bold italic
		fontSize	Font size (in pixels) for navigation controls. NOTE: Unless the font property is specified, fontSize is ignored
		bgGradientFlag	Select gradient fill or solid fill for tabs or accordion control. Default value is true. Set to false for solid fill.
rtnav-state-default:	Properties for this class are applied to all navigation controls that are in the default (i.e. unselected) state.	bgColor	Background and foreground (text) colors. Specify color index number from the RTView color palette or RGB value (in #rrggbb format where rr, gg, bb are the red, green, and blue intensities in hexadecimal values between 00 and ff).
		fgColor
		font	Font style for navigation controls. Specify index number, as follows: 1 sans-serif 2 monospaced bold 3 monospaced 4 serif 5 monospaced italic 6 serif bold 7 sans-serif bold 8 sans-serif italic 9 serif bold italic 10 serif italic 11 sans-serif bold italic 12 monospaced bold italic
		fontSize	Font size (in pixels) for navigation controls. NOTE: Unless the font property is specified, fontSize is ignored
		bgGradientFlag	Select gradient fill or solid fill for tabs or accordion control. Default value is true. Set to false for solid fill.
rtnav-state-hover	Properties for this class are applied to the navigation control that the mouse cursor is currently positioned over (affects tab and accordion controls only, and only in the Thin Client)	bgColor	Background and foreground (text) colors. Specify color index number from the RTView color palette or RGB value (in #rrggbb format where rr, gg, bb are the red, green, and blue intensities in hexadecimal values between 00 and ff).
		fgColor
		font	Font style for navigation controls. Specify index number, as follows: 1 sans-serif 2 monospaced bold 3 monospaced 4 serif 5 monospaced italic 6 serif bold 7 sans-serif bold 8 sans-serif italic 9 serif bold italic 10 serif italic 11 sans-serif bold italic 12 monospaced bold italic
		fontSize	Font size (in pixels) for navigation controls. NOTE: Unless the font property is specified, fontSize is ignored
		bgGradientFlag	Select gradient fill or solid fill for tabs or accordion control. Default value is true. Set to false for solid fill.
rtnav-state-selected	Properties for this class are applied to all navigation controls that are in the selected state (e.g. the selected tab in a tabbed panel).	bgColor	Background and foreground (text) colors. Specify color index number from the RTView color palette or RGB value (in #rrggbb format where rr, gg, bb are the red, green, and blue intensities in hexadecimal values between 00 and ff).
		fgColor
		font	Font style for navigation controls. Specify index number, as follows: 1 sans-serif 2 monospaced bold 3 monospaced 4 serif 5 monospaced italic 6 serif bold 7 sans-serif bold 8 sans-serif italic 9 serif bold italic 10 serif italic 11 sans-serif bold italic 12 monospaced bold italic
		fontSize	Font size (in pixels) for navigation controls. NOTE: Unless the font property is specified, fontSize is ignored
		bgGradientFlag	Select gradient fill or solid fill for tabs or accordion control. Default value is true. Set to false for solid fill.
rtnav-accordion	Properties for this class are applied to the accordion navigation controls.	buttonWidth	Width (in pixels) of all buttons in the accordion. Default is 160.
		spacing	Vertical space (in pixels) between buttons. Default is 5.
		indent	Left indent (in pixels) of leaf buttons in the accordion. Default is 10.

Viewing Multiple Display Panels

Display Viewer Applet
At startup, the Display Viewer Applet reads the panel configuration from the directory where it is hosted to populate panels with the specified displays. The display specified in your rtv_filename applet parameter will not be loaded.

Display Viewer Application
At startup, the Display Viewer Application reads the panel configuration from the directory where it is started to populate panels with the specified displays. If the panel configuration file is not found in the current directory, the Display Viewer will search under lib in your installation directory. When viewing multiple display panels in the Display Viewer, you cannot open displays using the command line or the File>Open dialog.

Display Server
At startup, the Display Server reads the panel configuration from the directory where it is started to populate panels with the specified displays. If the panel configuration file is not found in the current directory, the Display Server will search under lib in your installation directory. See the Display Server section for more details on viewing multiple display panels.