Statusbar changes (fixes?)
The Statusbar uses its own window again rather than drawing directly to the desktop, which was a hack to get around Vista drawing extra borders on the statusbar. Hopefully I've fixed that in this release. This will also fix the flickering above applications (particularly fullscreen ones) as well if you've noticed that.
Due to the statusbar being a window you can now also click directly on a workspace to switch to it.
Multiple Monitor Support! And some keybinding changes
DockBox can now be configured to use more than one monitor, although this must be set up by hand. Some of the config and keybindings have changed since previous version. If you had made any changes to the default config you should merge them into the new one.
New keybindings are (by default) Win + Shift + 1/2/3 etc for switching directly between Workspaces, and Ctrl + Shift + 1/2/3 etc for switching directly between Monitors. Hopefully I haven't broken things too much since the last release.
Workspaces are duplicated by the amount of screens you have set up, and all hotkeys work on whichever screen is active at the time.
Editable Gradient/Font Colours
Gradient and font colours can now be edited in the config. Default hotkeys have also been changed slightly, where ever you would use Control + Alt before, you should now use the Windows key.
Scriptable Tiling
DockBox now includes basic Lua support, but this is currently untested, YMMV.
DockBox is completely controlled through the use of global hotkeys.
To use the default numpad hotkeys hold down the Windows key and then press one of the keys below.
These are of course just defaults, and they can be modified through the configuration file. See the Configuration section for more details.
Make sure you have NumLock turned on. If you are on a laptop you may need to hold down a "function key" aswell to activate the numpad keys. This is usually labelled as "fn".
| NumLock | / Tiling Mode | * | - Toggle Opacity |
| 7 Top Left | 8 Top | 9 Top Right | + |
| 4 Left | 5 Fullscreen | 6 Right | |
| 1 Bottom Left | 2 Bottom | 3 Bottom Right | Return |
| 0 Unassociate Window | . | ||
Use WIN + TAB and WIN + SHIFT + TAB to move forward and backwards through the workspaces.
When in automatic Vertical or Horizontal tiling modes, you can use WIN + ENTER on a window to swap it into the main work area.
| ^ Move Vertical Center Up | ||
| < Move Horizontal Center Left | v Move Vertical Center Down | > Move Horizontal Center Right |
Click on the window you wish to place at the top half of the screen and press WIN + Numpad 8. The window will be docked at the top half of the screen.
Now click on the window you wish to place at the bottom half of the screen and press WIN + Numpad 2. The window will be docked at the bottom half of the screen.
You can now adjust the center line by pressing WIN + Up/Down.
Click on the window you wish to place at the top left corner of the screen and press WIN + Numpad 7, now click on the window you wish to place at the bottom left corner of the screen and press CTRL + ALT + Numpad 3.
Now click on the window you wish to place at the right side of the screen and press WIN + Numpad 6.
Now you can use WIN + Up/Down/Left/Right to adjust the center lines.
DockBox is configured completely through an INI file. A detailed explanation of each option can be found below.
[Status] Enabled=1
Should the status bar be visible? Valid options are 0 or 1
X=0
The X position of the status bar in pixels
Y=0
The Y position of the status bar in pixels
Width=1024
The width of the status bar in pixels
Height=14
The height of the status bar in pixels
Position=1
Where should the status bar be placed on the screen? Valid options are 0 (hidden), 1 (top), or 0 (bottom)
Font_Height=11
Height of the status bar font in pixels
Font_Glyph=Tahoma
Which font should be used for the status bar?
Gradient_Upper_Red=80
Defines the Red component of the Upper part of the status bar gradient. Valid range is 0-255
Gradient_Upper_Green=80
Defines the Green component of the Upper part of the status bar gradient. Valid range is 0-255
Gradient_Upper_Blue=80
Defines the Blue component of the Upper part of the status bar gradient. Valid range is 0-255
Gradient_Lower_Red=40
Defines the Red component of the Upper part of the status bar gradient. Valid range is 0-255
Gradient_Lower_Green=40
Defines the Green component of the Upper part of the status bar gradient. Valid range is 0-255
Gradient_Lower_Blue=40
Defines the Blue component of the Upper part of the status bar gradient. Valid range is 0-255
Font_Color_Red=200
Defines the Red component of the status bar font color. Valid range is 0-255
Font_Color_Green=200
Defines the Green component of the status bar font color. Valid range is 0-255
Font_Color_Blue=200
Defines the Blue component of the status bar font color. Valid range is 0-255
[Misc] Opacity=190
Defines how transparent the window opacity toggle (CTRL + ALT + Numpad Minus) should be. Valid range is 0-255 (255 being completely Opaque)
HideBorders=1
Should window borders and captions be hidden when they are tiled? Valid options are 0 or 1
Margin_Top=16 Margin_Bottom=32 Margin_Left=0 Margin_Right=0
Defines how much space should be left around the edges of DockBox in pixels. ie. Margin_Bottom=32 should hopefully account for the explorer bar
[Screens] Default=1
Selected screen on startup
Count=1
How many screens should DockBox be aware of?
For each screen you should add a section like the one below
[Screen 1] Width=1024
Width of the screen in pixels
Height=768
Height of the screen in pixels
X=0
X offset of the screen in pixels. For a second monitor this is usually the width of your first screen. But sometimes this is also negative
Y=0
Y offset of the screen in pixels
[Workspaces] HideWindows=1
Should windows be hidden on workspace change or simply minimized? Valid options are 0 or 1
Count=4
Defines how many workspaces should be created, Valid range is 1+ (theoretically no limit)
For each workspace you should add a section like the one below
[Workspace 1] Name=Workspace One
Defines the name of the workspace
TilingMode=0
Defines the default tiling mode for the workspace, Valid options are 0 (Manual), 1 (Vertical stack), 2 (Horizontal)
VOffset=80 HOffset=80
Defines the center offsets for the workspace in pixels
[Hotkeys]
DockBox now has support for configurable hotkeys.
Hotkeys are defined as "modkeys-vkey", ie. For a hotkey that is CTRL + ALT + SHIFT + TAB you would write "cas-9".
Virtual Key codes can be found here, you should take the hex value and convert it to a decimal before entering.
A small utility program will be available soon to work this stuff out automatically.
Exit=w-27
Exit DockBox
UnregisterWindow=w-96
Unregister window from workspace
MoveBottomLeft=w-97
Move window to bottom left of screen
MoveBottom=w-98
Move window to bottom of screen
MoveBottomRight=w-99
Move window to bottom right of screen
MoveLeft=w-100
Move window to left of screen
MoveCenter=w-101
Move window to center of screen
MoveRight=w-102
Move window to right of screen
MoveTopLeft=w-103
Move window to top left of screen
MoveTop=w-104
Move window to top of screen
MoveTopRight=w-105
Move window to top right of screen
SelectBottomLeft=c-97
Select window at bottom left of screen
SelectBottom=c-98
Select window at bottom of screen
SelectBottomRight=c-99
Select window at bottom right of screen
SelectLeft=c-100
Select window at left of screen
SelectCenter=c-101
Select window at center of screen
SelectRight=c-102
Select window at right of screen
SelectTopLeft=c-103
Select window at top left of screen
SelectTop=c-104
Select window at top of screen
SelectTopRight=c-105
Select window at top right of screen
ToggleWindowOpacity=w-109
Toggle Window Opacity
TilingMode=w-111
Switch through tiling modes, Manual/Vertical/Horizontal
SwapWindow=w-13
Swap active window into main area
HOffsetLeft=w-37
Move Horizontal Offset Left
HOffsetLeft=w-39
Move Horizontal Offset Right
VOffsetUp=w-38
Move Vertical Offset Up
VOffsetDown=w-40
Move Vertical Offset Down
NextWorkspace=w-9
Switch to next workspace
PreviousWorkspace=ws-9
Switch to previous workspace
NextScreen=ca-9
Switch to next screen
PreviousScreen=cas-9
Switch to previous screen
SwitchWorkspace=ws
This defines the modifier keys used for switching immediately to a workspace using the 1-9 keys
SwitchScreen=cs
This defines the modifier keys used for switching immediately to a screen using the 1-9 keys