# WinMaximize

Enlarges the specified window to its maximum size.

WinMaximize [, WinTitle, WinText, ExcludeTitle, ExcludeText]

#### Parameters

WinTitle | The title or partial title of the target window (the matching behavior is determined by SetTitleMatchMode). If this and the next 3 parameters are omitted, the Last Found Window will be used. If this is the letter A and the next 3 parameters are omitted, the active window will be used. To use a window class, specify ahk_class ExactClassName (shown by Window Spy). To use a process identifier (PID), specify ahk_pid %VarContainingPID%. To maximize a group of windows, specify ahk_group GroupName (WinText, ExcludeTitle, and ExcludeText must be blank in this case). To use a window's unique ID number, specify ahk_id %VarContainingID%. The search can be narrowed by specifying multiple criteria. For example: My File.txt ahk_class Notepad
WinText | If present, this parameter must be a substring from a single text element of the target window (as revealed by the included Window Spy utility). Hidden text elements are detected if DetectHiddenText is ON.
ExcludeTitle | Windows whose titles include this value will not be considered.
ExcludeText | Windows whose text include this value will not be considered.

#### Remarks

Use WinRestore to unmaximize a window and WinMinimize to minimize it.

If a particular type of window does not respond correctly to WinMaximize, try using the following instead:

    PostMessage, 0x112, 0xF030,,, WinTitle, WinText  ; 0x112 = WM_SYSCOMMAND, 0xF030 = SC_MAXIMIZE

This command operates only upon the topmost matching window except when WinTitle is ahk_group GroupName, in which case all windows in the group are affected.

Window titles and text are case sensitive. Hidden windows are not detected unless DetectHiddenWindows has been turned on.

#### Related

WinRestore, WinMinimize

#### Example

    Run, notepad.exe
    WinWait, Untitled - Notepad
    WinMaximize ; use the window found above

    ^Up::WinMaximize, A  ; Assign a hotkey to maximize the active window.