WinHide

Hides the specified window.

WinHide WinTitle, WinText, ExcludeTitle, ExcludeText

Parameters

WinTitle

Type: String, Integer or Object

A window title or other criteria identifying the target window. See WinTitle.

WinText

Type: String

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

Type: String

Windows whose titles include this value will not be considered.

ExcludeText

Type: String

Windows whose text include this value will not be considered.

Error Handling

A TargetError is thrown if the window could not be found, except if the group mode is used.

Remarks

Use WinShow to unhide a hidden window (DetectHiddenWindows can be either On or Off to do this).

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

The Explorer taskbar may be hidden/shown as follows:

WinHide "ahk_class Shell_TrayWnd"
WinShow "ahk_class Shell_TrayWnd"

WinShow, SetTitleMatchMode, DetectHiddenWindows, Last Found Window, Win functions

Examples

Opens Notepad, waits until it exists, hides it for a short time and unhides it.

Run "notepad.exe"
WinWait "Untitled - Notepad"
Sleep 500
WinHide ; Use the window found by WinWait.
Sleep 1000
WinShow ; Use the window found by WinWait.