# Function Reference

WinWaitActive

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

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

Parameters

title | The title of the window to check. See Title special definition.
text | [optional] The text of the window to check.
timeout | [optional] Timeout in seconds

Return Value

Success: | Returns 1.
Failure: | Returns 0 if timeout occurred.

Remarks

None.

Related

WinActive, WinExists, WinWait, WinWaitClose, WinWaitNotActive, WinWaitDelay (Option)

Example

;Wait for the window "Untitled" to exist and be active
WinWaitActive("Untitled")
;Wait a maximum of 5 seconds for "Untitled" to exist and be active
WinWaitActive("Untitled", "", 5)