IfWinActive / IfWinNotActive

Checks if the specified window exists and is currently active (foremost).

Deprecated: These control flow statements are not recommended for use in new scripts. Use the WinActive function instead.

IfWinActive , WinTitle, WinText, ExcludeTitle, ExcludeText
IfWinNotActive , WinTitle, WinText, ExcludeTitle, ExcludeText

Parameters

WinTitle, WinText, ExcludeTitle, ExcludeText

If each of these is blank or omitted, the Last Found Window will be used. Otherwise, specify for WinTitle a window title or other criteria to identify the target window and/or for WinText a substring from a single text element of the target window (as revealed by the included Window Spy utility).

ExcludeTitle and ExcludeText can be used to exclude one or more windows by their title or text. Their specification is similar to WinTitle and WinText, except that ExcludeTitle does not recognize any criteria other than the window title.

Window titles and text are case-sensitive. By default, hidden windows are not detected and hidden text elements are detected, unless changed with DetectHiddenWindows and DetectHiddenText. By default, a window title must start with the specified WinTitle or ExcludeTitle to be a match, unless changed with SetTitleMatchMode.

Note: Due to backward compatibility, ExcludeTitle will be interpreted as a command if it exactly matches the name of a command. To work around this, use the WinActive function instead.

Remarks

If either of these control flow statements determines that the active window is a qualified match, the Last Found Window will be updated to be the active window. In other words, if IfWinActive evaluates to true or IfWinNotActive evaluates to false, the Last Found Window will be updated.

An easy way to retrieve the unique ID of the active window is with ActiveHwnd := WinExist("A").

SetWinDelay does not apply to these control flow statements.

WinActive(), IfWinExist / IfWinNotExist, SetTitleMatchMode, DetectHiddenWindows, Last Found Window, WinActivate, WinWaitActive, WinWait, WinWaitClose, #IfWinActive/Exist

Examples

Maximizes the Notepad window found by the IfWinActive statement above.

IfWinActive, Untitled - Notepad
{
    WinMaximize ; Use the window found by IfWinActive.
    Send, Some text.{Enter}
    return
}