Multi-Window
The Multi-Window is a general window into which other RiverWare windows can be docked. When using RiverWare, you may need to open many windows, and it can be challenging to manage each of the windows individually. The Multi-Window allows you to place windows in a fixed location in a larger window where they can then be moved together and maintain their spatial relationship to one another.
Note: RiverWare 9.1 is the preliminary release of the Multi-Window. You may find quirky or unexpected behavior. Please provide comments to riverware-support@colorado.edu
Overview
The Multi-Window allows you to create a customized view by docking and arranging selected windows within in a single window. Figure 1.7 shows an example of the Multi-Window with four commonly used windows arranged in it.
Figure 1.7 Multi-Window containing the Object Viewer, RPL Set Editor, Run Control, and SCT
Using the Multi-Window
This section describes how to customize the Multi-Window by adding windows and arranging their positions.
Adding a Window to the Multi-Window
To add a window to the Multi-Window, select the Add to Multi-Window button at the top right of the window.
When a window is added to the Multi-Window, it is added as the rightmost window of the top docking area. (The first window added will appear to occupy the entire space of the Multi-Window.) Once added, a window can then be moved to the desired location in the Multi-Window (see Relocating a Window in the Multi-Window).
Supported Window Types
Not all RiverWare windows can be added to the Multi-Window, but most of the primary windows are supported. The list of supported windows is the same as the list of windows supported by the Window Layout Manager (see Supported Window Types) with three exceptions. The Workspace, Workspace Object List, and Diagnostic Output Window cannot be added to the Multi-Window.
Relocating a Window in the Multi-Window
Once added to the Multi-Window, a window can be relocated by clicking on the title bar of the window, dragging to the desired location, and then releasing. While dragging the window, a blue shaded box will show where the window will be placed upon release. If the blue shaded box is not showing, upon release, the window will be removed from the Multi-Window.
The Multi-Window has four docking areas: Left, Right, Top, and Bottom. Within the Left and Right docking areas, windows can be stacked vertically; within the Top and Bottom areas, windows can be side by side.
Note: Some of the docking areas may not be available to dock a window depending on the minimum size of the other windows in the Multi-Window and the size of the window being relocated.
Resizing Windows in the Multi-Window
To resize windows in the Multi-Window, hover over the area between two adjacent windows. The cursor will change to a “splitter.” Then click and drag to resize the windows.
Note: In some cases, the size of a window in the Multi-Window may be restricted by the minimum dimensions of adjacent windows.
Combining Windows in a Tabbed View
Multiple windows can share the same space in the Multi-Window in a tabbed view. When relocating a window, drag it over an existing window in the Multi-Window. When the blue shaded box appears over the existing window, release, and the window will be added as a tab in that location.
Once multiple windows are shown in the same area of the Multi-Window, tabs appear at the bottom of that area for each window. Click on the desired tab to bring that window to the front. The tabs can be re-ordered by clicking and dragging.
Removing Windows from the Multi-Window
There are multiple ways to remove windows from the Multi-Window.
• Click on the “Remove from Multi-Window” button at the top right of the window. This will remove the window from the Multi-Window and leave it open.
• Double-click on the title bar of the window. This will remove the window from the Multi-Window and leave it open.
• Click on the title bar of the window, drag it off of the Multi-Window, and release. This will remove the window from the Multi-Window and leave it open.
• Click on the black X at the top right of the window. This will remove the window from the Multi-Window and close it.
• Close a window by any other means, such as from the File menu on the window.
• From the Edit menu of the Multi-Window, select one of the following two options.
– Remove All Windows
– Remove and Close All Windows
Note: If you close the Multi-Window by selecting File then Close Window or by clicking on the X at the top right of the Multi-Window, it does not empty the Multi-Window of its contents. If you bring up the Multi-Window again, it will still have all of its contents.
Preserving a Multi-Window Layout
The contents and layout within the Multi-Window are not automatically saved within the model; however, the Multi-Window can be included in a Window Layout and will be restored when that Layout is applied.
1. Add windows to the Multi-Window and arrange them as desired.
2. Create a Window Layout as described in Creating Layouts, or edit an existing Layout as described in Editing Layouts. Make sure that the Multi-Window is selected as one of the windows to include in the Layout.
3. Save the model file (see Saving Models).
When the Layout is applied (see Applying Layouts), the Multi-Window will open with all of its windows positioned as specified.
Revised: 07/09/2023