###Function###
WinWaitActive

###Description###
Pauses execution of the script until the requested window is active.


###Syntax###
WinWaitActive ( "title" [, "text" [, timeout]] )


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


###ReturnValue###
@@ReturnTable@@
Success:	Returns handle to the requested window.
Failure:	Returns 0 if timeout occurred.
@@End@@


###Remarks###
None.

###Related###
WinActive, WinExists, WinWait, WinWaitClose, WinWaitNotActive, WinWaitDelay (Option), ProcessWait


###Example###
@@IncludeExample@@
