Pauses execution of the script until the requested window is active.
WinWaitActive "title", ["text"], [timeout]
Parameters
title | The title of the window to check. |
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
AutoIt polls for a window match every 250 milliseconds or so.
Related
WinActive, WinExists, WinWait, WinWaitClose, WinWaitNotActive, WinWaitDelay (Option)
Example
Set oAutoIt = WScript.CreateObject("AutoItX3.Control")
'Wait for the window "Untitled" to exist and be active
oAutoIt.WinWaitActive "Untitled"
'Wait a maximum of 5 seconds for "Untitled" to exist and be active
oAutoIt.WinWaitActive "Untitled", "", 5