CLion 2019.1 Help

Viewing Modes

You can view and adjust tool windows in various ways to quickly access them and save space when you work in the editor or other tool windows.

  • From the main menu, select Window | Active Tool Window | View mode and the actual mode option.

  • On the title bar of a tool window, click the Show Options Menu icon, from the list of options, select View Mode and the actual mode option.

  • Right-click a tool window or a title bar and from the list of options, select View Mode and the actual mode option.

    cl ManipulatingToolWindows 2

You can configure a number of general viewing options for tool windows under Window Options on the Appearance & Behavior | Appearance page of CLion settings (Ctrl+Alt+S).

Docked pinned / docked unpinned / undocked mode

You can make a tool window stay open even if your focus is somewhere else, for example, in the editor or other tool window. To achieve that, use the Dock pinned mode when you select your viewing mode.

To close the tool window when you switch focus, use the Dock unpinned or the Undock mode.

docked and undocked modes

In the docked mode, all the sides of a tool window are attached to surrounding elements (the editor, other tool windows, and so on.) In this mode, the tool window and the adjacent elements share the space available in the main window.

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.

Float / Window mode

You can detach a tool window using the Float or the Window mode.

Initially, all the tool windows are in a mode that is "fixed" meaning it stays within the main window.

  • In the Float mode, a tool window can be moved around the screen, but it stays on top of the main CLion window.

  • In the Window mode, a tool window behaves as a separate application window: it can be moved around the screen and get overlapped by the main CLion window.

Always-shown / Auto-hidden mode

These viewing modes are available for the Message Tool Window, which shows the build output.

You may need the build output always visible, or you may want it hidden unless a warning/error occurs. To configure the desired behaviour of the Message tool window, click the Settings icon icons general gearPlain svg and chose from the following options:

  • Always Show on Build (default)
    This option forces the Messages tool window to stay visible for every build. In case it was closed manually, the window will be reopened for the next build.

  • Auto-Hide and Show on Warning/Error
    The Messages tool window will appear only if a warning/error occurred during the compilation and will stay hidden for the successful build. If the window was opened manually, CLion will hide it for the next build.

  • Both disabled
    In this case, CLion will not force the Messages tool window to open unless there is a warning/error. Otherwise, the window will remain in the state you previously forced (opened or closed).

Split mode

This mode has to do with how many windows Dock Pinned 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.

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 have the Docked Pinned selected.

Group Tabs option

If more than one view is available in a tool window, the corresponding views may be shown on separate tabs if the Group Tabs option is selected in Window | Active Window of the main menu.

Wide screen support

CLion makes it possible for the tool windows to use the full width and height of the screen. In the Settings dialog (Ctrl+Alt+S), expand the node Appearance and Behaviour, and in the Appearance page, use the checkboxes Wide screen tool window layout and Side by side layout on the left/right to optimize placement of the tool windows.

Last modified: 20 May 2019

See Also