Window Layouts
When using RiverWare, you may need to open many windows or dialog boxes. For a repeating task or activity, it is common to open the same windows and place them in the same location and size each time. The Window Layout Manager assists with this task. This tool allows you to save and restore window layouts, where each window layout describes a set of windows and the appearance and content of each window. In this section, we refer to windows and content; for example the Object Viewer is a window while the specific objects that are shown in the viewer, such as Big Lake, is the content. Some windows have content that can change and some do not.
Note: This tool was first released in RiverWare 8.4 and is under development. Not all windows are supported by the tool yet, as described in
Supported Window Types; more will be added in the future. Further limitations and some possible future enhancements are noted below. Please provide feedback and comments to RiverWare-Support@Colorado.edu.
Overview
The Window Layout Manager is accessed from:
• the workspace Windows and then Window Layout Manager menu.
• the Windows Layout Manager button
on the workspace toolbar
Figure 1.4 shows the layout manager for a sample model with three user defined layouts for various purposes.
Figure 1.4 Window Layout Manager shown with three layouts defined
Using the Window Layout Manager
Most operations involving layouts are performed from the Window Layout Manager including creating and applying layouts. All layouts are currently saved in the model file and can be exported to and imported from an external file to share between models. This section describes these operations in detail.
Creating Layouts
Layouts are based on the size and position of windows. Thus, the first step is to open the desired windows, move them to the desired location, and resize as necessary. For those windows with specific content, like the object or slot viewer, open the desired items.
Then, in the
Window Layout Manager, select the
Create button to open the
Window Layout Editor dialog box. The following information is tracked for each window as shown in
Figure 1.4 and
Figure 1.5:
• Name: The title of the window. Mouse over the name to see the full name and any specific information, such as the name of the SCT or Plot Page.
• Position: The pixel coordinates from the top-left corner of the screen to the top-left corner of the window.
• Size: The size, in pixels, of the window.
• Screen: The number of the screen on which the window resides. These numbers correspond to the main display, not necessarily the screen numbers used when identify the displays in the system settings.
• State: Normal, Minimized, or Maximized
Specify the desired name for the new layout.
Uncheck any windows you do not wish to include. They will turn red as changes are made.
Specify whether to Close all windows before applying layout. When checked, when the layout is applied, first all windows will be closed and then the layout is applied. The close behavior is identical to shift-clicking the Close Windows button (i.e. the lightning bolt). This feature allows you to switch between layouts, closing all other windows before applying the new layouts. The default is that the toggle is checked.
When satisfied, select OK and a new layout with the given name will be created.
Within the Layout Manager, layouts can be renamed or deleted using the Rename Layout or Delete Layout options, respectively, in the File menu or the right-click context menu.
Layouts can be rearranged in the Window Layout Manager by using the Up and Down arrows next to the list. This order will be maintained on subsequent model load.
Editing Layouts
To change an existing layout, select the layout and use the
Edit button. For example, we clicked Edit for the “Planning and Analysis” layout in
Figure 1.4 to get the screenshot shown below in
Figure 1.5Figure 1.5 Window Layout Editor Dialog
The editor shows
• The layout Name text field. Modify the text to rename the layout.
• A list of all windows that are open (and supported by the window layout manager):
– The checked items belong to this layout.
– Unchecked items are open but do not belong to this layout.
– Red items have changes compared to the saved layout. Individual items like position or size will be red if different. The entire row will be highlighted if a window is added to or removed from the layout. For example, The RPL Set Editor was saved in a Normal State at a different size, but now it is minimized and 583X383 pixels.
• The controls to Close all windows before applying layout. When checked, when the layout is applied, first all windows will be closed and then the layout is applied. The close behavior is identical to shift-clicking the Close Windows button (i.e. the lightning bolt). This feature allows you to switch between layouts, closing all other windows before applying the new layout.
Check or uncheck windows to add or remove them from the layout. They will change to red as they are changed.
Select OK and the confirmation to accept the changes.
Applying Layouts
There are four ways to apply a layout, that is, restore the specified windows to the state in which they were saved.
• Apply button: In the Window Layout Manager, apply the selected layout by selecting the Apply button. The Window Layout Manager remains open.
• Apply and Close button: In the Window Layout Manager, apply the selected layout by selecting the Apply and Close button. The Window Layout Manager then closes.
• On the workspace, use the Workspace menu and then select the layout from the Apply Layouts section of the menu. The following figure shows an example from the test model.
Figure 1.6 Screenshot of Windows menu showing Apply Layout operation
The following lists the limitations on applying layouts:
• Applying a layout closes windows that are not part of a layout according to the Close all windows before applying layout option described above. If not checked, applying layouts only modifies or shows those windows that are part of the layout.
• Due to the wide range of possible monitor configurations (number of monitors, arrangement, orientation, resolution, etc.), windows may not be restored exactly as saved. Such problems may arise if a layout was created on a setup using multiple monitors with very high resolution and restored on a setup with fewer monitors or lower resolution. If the Window Layout Manager determines that a window would be positioned completely off-screen and not accessible, then it will instead open the window in a default state. A warning will then be displayed.
• The Window Layout Manager will attempt to populate windows with the specified contents, such as objects or slots. If the contents cannot be located in the current model, then warnings will be displayed.
Layout Persistence
All layouts are saved in the model file when the model is saved.
Note: In the future, layouts may be saved on a per-user basis or as a file that could be loaded when RiverWare or the model opens.
Additionally, all layouts in the Window Layout Manager may be exported to and imported from an external XML file.
• Export: Use the File and then Export Layouts menu. Specify a file name and select Save. Currently, all layouts are exported. This may be enhanced in the future.
• Import: Use the File and then Import Layouts menu. Locate the file containing the exported layouts and select Open. If there are any naming conflicts during import, imported layouts will be automatically renamed by appending a number on the end of the name.
Supported Window Types
The following windows are currently supported by the Window Layout Manager; additional window types may be added in future releases.
• Accounting
– Edit Account
– Exchange Balance
– Object Account Summary
• Diagnostics Output Window
• DMI dialogs:
– DMI Manager
– Dataset Manager
– Name Map Manager
– DMI Editor, for Control File-Executable DMIs
– Trace Directory DMI Editor
– Database DMI Editor
• Ensemble Data Tool
• Multi-Window - includes the layout of the Multi-Window - the windows included and their positions - when the layout is saved
• Object Viewer - with or without objects open
• Open Object
• Plot Page
– RPL Rule, Function, Goal, Method Editor
– RPL Function Editor
– RPL Viewer - with or without RPL items open
– RPL Set Editor and Group Editor
– RPL Palette
– RPL Debugger
• Run Control
• Scripts
– Script Dashboard
– Script Manager
• SCT
• Slot Dialogs
– Open Slot
– Slot Viewer (Series) - with or without slots shown
– Slot Viewer (Scalar) - with or without slots shown
• Workspace. Note Compact mode is also supported.
• Workspace Object List