Method WinWaitActive

AutoIt X

Method 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.
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, WinWaitDelay (Option), WinWaitNotActive

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