{{>toc}}

h1. Switchbar

!switchbar.png!

The Switchbar shows all open windows and allows switching the active window.

_See also [[/switchbar]], [[$switchbar]], [[Switchbar Options]]._

h2. Hiding the Switchbar

The Switchbar can be hidden by clicking [[Menubar_Control|Menubar]] -> View -> Switchbar or by typing [[/switchbar]] off or by changing [[Options Dialog|Options]] -> [[Windows Options|Windows]] -> [[Windows_Options#Enable-Switchbar|Enable Switchbar]] or by right-clicking the Switchbar and then clicking *Hide Switchbar*.

h2. Switchbar position

The Switchbar can be moved to the top/bottom/left/right of the main window by right-clicking the Switchbar then clicking *Position*.

h2. Locking bars

[[Menubar_Control|Menubar]]/[[Toolbar_Control|Toolbar]]/[[Switchbar_Control|Switchbar]]/[[Treebar_Control|Treebar]] can be locked so they can't be moved by right-clicking any bar and then click *Lock Bars*.

Locking bars also removes the header from the [[Monitor Panels]].

h2. Window Menu

Right-clicking a window in the Switchbar shows the window menu.

Pressing the %(key)SHIFT% while right-clicking shows the [[Scripting_Menus|scripted window menu]] instead.

h2. Window Order

The order which windows appear in the Switchbar can be changed in [[Options Dialog|Options]] -> [[Windows Options|Windows]] -> [[Windows_Options#Window-Order|Window order]].

h2. Closing Windows

Windows can be closed by using the middle mouse button when clicking a window or by pressing %(key)SHIFT% when left-clicking a window.

This can be disabled in [[Options Dialog|Options]] -> [[Windows_Options#Allow-closing-windows-with-middle-mouse-clickshift-click|Windows]].

h2. Window colors

Tab text colors can be set in [[Options Dialog|Options]] -> [[Colors Options|Colors]].

Normal color - The text color for the active window.
Inactive color - The text color for any inactive window.
Highlights color - The text color for any window which has a highlighted message.
Message color - The text color for any window which has a new message.
System color - The text color for any window which has a new system message.

h2. Background Color

The Switchbar background color can be set in [[Options Dialog|Options]] -> [[Colors Options|Colors]].

_Note: [[Colors_Options#Override-Windows-theme-colors|Override Windows theme colors]] must be enabled._

h2. Window Icons

The window icons can be changed in [[Options DIalog|Options]] -> [[Icons Options|Icons]].

Hiding the window icons from the Switchbar can be done in the [[Switchbar Options]].

h2. Font

The font can be changed in [[Options DIalog|Options]] -> [[Fonts_Options|Fonts & Sizes]] or by using the [[/font]] command.

h2. Background image

A background image for the Switchbar can be set in [[Options DIalog|Options]] -> [[Backgrounds_Options|Backgrounds]] or by using the [[/background]] command.

h2. Button Background Image

A background image for the buttons can be set in [[Options DIalog|Options]] -> [[Backgrounds_Options|Backgrounds]] or by using the [[/background]] command.