Ways to control the viewing modes
MPS suggests the following means to control the viewing modes:
- Buttons on the title bar of a tool window. Such buttons are available only for the most important viewing modes.
- Context menu options. (The context menus are accessed by right-clicking the tool window buttons or the tool window title bars).
- Options in the Window menu. These are available only if the corresponding tool window is currently active.
All the corresponding controls are toggles.
Fixed / Floating Mode
A tool window may be fixed or floating.
When in the fixed mode, one side of the tool window is attached to one of the tool window bars. The behavior of the opposite side depends on whether the window is docked or undocked.
Initially, all the tool windows are in the fixed mode (i.e. the floating mode is off).
In the floating mode, a tool window becomes independent of all other windows and may be moved around the screen to any place.
When a floating tool window becomes inactive, it may turn semi-transparent under the following conditions:
To switch between the fixed and floating mode, use the Float / Fix button on the title bar, or the Floating Mode toggle in the context or the Window menu.
Docked / Undocked Mode
A tool window in the fixed mode may be docked or undocked.
In the docked mode, all the sides of a tool window are attached to surrounding elements (the editor, other tool windows, etc.) Thus, the tool window and neighbor elements share the space available in the main window.
When a docked tool window becomes inactive, it stays visible or is hidden depending on whether the window is pinned or unpinned.
Initially, all the tool windows are in the docked mode (i.e. the docked mode is on).
When undocked, all the sides of a tool window (except the one at the tool window bar) are detached from surrounding elements. The window moves to the "upper layer" covering the elements it used to share the space with. In one of the directions (along the tool window bar), the window stretches and takes all the available space. In the other direction, one of the window borders becomes loose and can be moved without affecting the sizes of other, underlying elements.
When an undocked tool window becomes inactive, it is automatically hidden.
To switch between the docked and undocked mode, use the Undock / Dock button on the title bar, or the Docked Mode toggle in the context or the Window menu.
Pinned / Unpinned Mode
Pinned tool windows, generally, stay visible when becoming inactive. Unpinned tool windows in such cases are automatically hidden.
Initially, all the tool windows are pinned (i.e. the pinned mode is on).
There may be slight differences in behavior depending on the other viewing modes:
- Undocked tool windows are always hidden when inactive. (In the undocked mode, the tool windows are effectively unpinned.)
- Floating pinned tool windows, when inactive, may become semi-transparent.
To switch between the pinned and unpinned mode, use the Unpin / Pin button on the title bar, or the Pinned Mode toggle in the context or the Window menu.
This mode has to do with how many windows docked to the same tool window bar may be shown at a time (one or two).
Generally, the space along a tool window bar is shared between two groups of docked tool windows.
In one of the groups are the tool windows for which the split mode is off; in the other group are the ones with this mode on.
At each moment of time, only one window from each of the groups may be visible.
Thus, if all the tool windows docked to a tool window bar have the split mode off, only one tool window may be shown at a time. In this case, the tool window which is visible takes all the space available along the tool window bar. So when you make a certain window visible, the previous visible window is automatically hidden.
The same behavior is observed if the split mode is on for all the windows docked to the same tool window bar.
To be able to see two windows simultaneously, the corresponding windows should belong to different groups, that is, one of the windows should have the split mode off and the other one on.
The tool window buttons for the tool windows with different settings of the split mode are grouped and shown at different corners of the corresponding tool window bar. For vertical window bars, the windows with the split mode off have the buttons at the top corner; for the horizontal bars, the buttons for such windows are at the left corner.
To turn the split mode for a docked tool window on or off, use the Split Mode toggle in the context or the Window menu.
This mode controls the way how different layers are shown and selected in "multilayer" tool windows:
If the tabbed content mode is on, the layers are shown as tabs and you can switch between the layers by selecting the necessary
If the tabbed content mode is off, the layers are shown as panes. The necessary layer (pane) is selected from the corresponding
To turn the tabbed content mode on or off, use the Tabbed Content toggle in the context or the Window menu.