Method Reference (COM)

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.
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