WindowPad  v1.52

Configuration

All configuration is currently done by editing WindowPad.ini.

Hotkeys

Hotkeys are defined in the [Hotkeys] section or [Hotkeys: ...] sections (see Hotkeys.) The syntax for these sections is:

Hotkey = Command, Params

Hotkey may be any valid AutoHotkey hotkey. Only commands specifically defined in the script as labels are supported.

Options

TitleMatchMode: Defines the default title matching mode for the script.

If WindowPad is #included in another script, WindowPad_Init() must be called from the auto-execute section for this option to work.

[Options]
TitleMatchMode=2

Exclude Windows

WindowPad hotkeys are disabled for windows listed in this section.

[Exclude Windows]
Window=Virtual PC
Window=ahk_class TSSHELLWND
; TSSHELLWND is the window class of Remote Desktop.

Gather Exclusions

Windows may be excluded from "gathering" either by title or by process.

In the following example, either section may be used to prevent GatherWindows from affecting Windows Vista's side bar.

[Gather: Exclude Windows]
Window=ahk_class SideBar_AppBarWindow
Window=ahk_class SideBar_HTMLHostWindow
Window=ahk_class BasicWindow

[Gather: Exclude Processes]
Process=sidebar.exe

GatherWindows

Gathers windows onto a single monitor.

GatherWindows, WinTitle
GatherWindows, Monitor

Parameters

WinTitle	Gather windows onto the monitor which contains this window. See Window Titles.
Monitor	A monitor number, where 1 is the first monitor.

Hotkeys

Enables or disables a set of hotkeys.

Hotkeys, Section, Options

Parameters

Section

The name of a hotkey set defined in WindowPad.ini, excluding the Hotkeys: prefix.

Options

Any option or string of options compatible with AutoHotkey's Hotkey command. For instance, On or Off. The word Toggle to toggle each hotkey in the set. Specify D%time% to indicate that the hotkey that launched this command must be held for at least %time% seconds before the hotkey set is enabled. If no options are specified, the hotkeys will be automatically disabled when the hotkey that launched this command is released.

Example

In the following example, the hotkey set is enabled if CapsLock is held for 0.2 seconds, and automatically disabled when CapsLock is released:

[Hotkeys]
CapsLock = Hotkeys, Active Window, D0.2

[Hotkeys: Active Window]
z = WindowPadMove, -1, +1,  0.5, 0.5
x = WindowPadMove,  0, +1,  1.0, 0.5
...

MaximizeToggle

Maximizes or restores a window.

MaximizeToggle, WinTitle

Parameters

WinTitle

Indicates which window to maximize or restore. See Window Titles.

Minimize

Minimizes a window.

Minimize, WinTitle

Parameters

WinTitle

Indicates which window to minimize. See Window Titles.

Restore

Restores a window.

Restore, WinTitle

Parameters

WinTitle

Indicates which window to restore. See Window Titles.

Send

Analogous to AutoHotkey's Send command.

Send, Keys

Remarks

The comma is required.

Unminimize

Restores the most recently minimized window.

Unminimize

Version History

Version 1.52:

• Added [Options] section to WindowPad.ini, TitleMatchMode option.
• Added [Exclude Windows] to WindowPad.ini, to make hotkeys context-sensitive.

Version 1.51:

• Introduced WindowPad_Init(IniPath).
• Added D option to Hotkeys command.
• Added commands: Minimize, Unminimize, Restore

Version 1.5 (beta):

• Changed SetWinDelay,-1 to SetWinDelay,0 to possibly improve reliability.
• New system for customizing hotkeys (via WindowPad.ini) Allows any key to be a trigger.
• GatherWindows: fixed restoring maximizing windows that are already on the destination monitor.
• GatherWindows now centers windows that don't appear to be on-screen.

Version 1.13:

• Applied bobbo's hack for moving maximized windows.

Version 1.12:

• Added two methods to exclude windows from GatherWindows(): GatherExclude window group (exclude by title, class, etc.) ProcessGatherExcludeList (exclude by process name)

Version 1.11:

• Fixed compatiblity issue with screens that don't align at the top.

Version 1.1:

• "Gather windows" hotkeys (NumpadDiv and NumpadMult)
• NumpadDot to move window to next monitor
• Added more EasyKey combos (for symmetry)
• Original functionality of EasyKey is retained (on key-release)
• SetWinDelay, -1 to reduce lag when making multiple moves (quickly)

Version 1:

• intial release

Window Titles

When a WindowPad command accepts a window title as a parameter, it may include:

• Any standard AutoHotkey WinTitle. For instance, Untitled - Notepad and ahk_class Notepad are both acceptable. A specifies the active window.
• P indicates the window below the active window in the z-order, which is usually but not always the previously active window.
• M indicates the window under the mouse cursor.

WindowPadMove

Simultaneously moves and resizes a window, based on a "pad" concept.

WindowPadMove, X, Y [, WidthFactor, HeightFactor, WinTitle ]

Parameters

X	-1 (left), 0 (center) or +1 (right)
Y	-1 (up), 0 (center) or +1 (down)
WidthFactor	A number between 0.0 and 1.0, where 0.5 is half of the screen's width.
HeightFactor	A number between 0.0 and 1.0, where 0.5 is half of the screen's height.
WinTitle	Indicates which window to move. See Window Titles.

Remarks

[ Brackets denote optional parameters. ]

WindowScreenMove

Moves a window between monitors (screens.)

WindowScreenMove, Monitor, WinTitle

Parameters

Monitor	Next, Previous or a monitor number, where 1 is the first monitor. N, P and Prev are also acceptable.
WinTitle	Indicates which window to move. See Window Titles.