Window Layouts
Window Layouts allow you to save the size, position, content, and status of many windows. The layout can be applied on demand to open the windows in their saved locations and sizes. 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, 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. Supported windows are listed in Multi-Windows.
Window Layouts are managed through the Window Manager. For more information on accessing the Window Manager, see Window Manager.
Figure 2.6 Window Layouts panel shown with three layouts defined
Using Window Layouts in the Window Manager
Most operations involving layouts are performed from the Window 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 Manager, select the New button to open the Window Layout Editor utility. The following information is tracked for each window as shown in Figure 2.6 and Figure 2.7:
• 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.
De-select 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 Layout menu or the right-click context menu.
Layouts can be rearranged in the Window 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 2.6 to get the screenshot shown below in Figure 2.7
Figure 2.7 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 manager): (Example using Figure 2.7 are listed below)
– The checked items already belong to this layout.
– Unchecked items are open but do not belong to this layout. For example, the Script Manger is open, but is not included in the layout.
– Red items have changes compared to the saved layout.
• Individual items like position or size will be red if different. For example, the Plot Page size has changed.
• The entire row will be highlighted if a window is added to or removed from the layout. For example, the Run Control was not included previously, but now that it is checked, it will be included.
• 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 Manager, apply the selected layout by selecting the Apply button. The Window Manager remains open.
• Layouts can also be applied by a script using the Apply Window Layout script action. See Apply Window Layout in Automation Tools for more information.
• 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 2.8 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 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 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. Additionally, all layouts in the Window 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.
Revised: 07/03/2024