# Function Reference

WinActivate

Activates (gives focus to) a window.

WinActivate ( "title" [, "text"] )

Parameters

title | The title of the window to activate. See Title special definition.
text | [optional] The text of the window to activate.

Return Value

Success: | Returns 1.
Failure: | Returns 0 if window is not found.

Remarks

You can use the WinActive function to check if WinActivate succeeded. If multiple windows match the criteria, the window that was most recently active is the one activated. WinActivate works on minimized windows. However, a window that is "Always On Top" could still cover up a window you Activated.

Related

WinClose, WinSetState, WinTitleMatchMode (Option)

Example

WinActivate("Untitled - Notepad", "")