###Function###
WinActivate

###Description###
Activates (gives focus to) a window.

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


###Parameters###
@@ParamTable@@
title
	The title of the window to activate. See <a href="../intro/windowsadvanced.htm">Title special definition</a>.
text
	[optional] The text of the window to activate.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1. 
Failure:	Returns 0 if window is not found. 
@@End@@


###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###
@@IncludeExample@@
