Pauses execution of the script until the requested window is active.
WinWaitActive ( "title" [, "text" [, timeout = 0]] )
| title | The title/hWnd/class of the window to check. See Title special definition. |
| text | [optional] The text of the window to check. Default is an empty string. See Text special definition. |
| timeout | [optional] Timeout in seconds if the window is not active. Default is 0 (no timeout). |
| Success: | a handle to the requested window. |
| Failure: | 0 if timeout occurred. |
The window is polled every 250 milliseconds or so.
ProcessWait, WinActive, WinExists, WinWait, WinWaitClose, WinWaitDelay (Option), WinWaitNotActive
Example()
Func Example()
; Run Notepad
Run("notepad.exe")
; Wait 10 seconds for the Notepad window to appear.
WinWaitActive("[CLASS:Notepad]", "", 10)
; Wait for 2 seconds to display the Notepad window.
Sleep(2000)
; Close the Notepad window using the classname of Notepad.
WinClose("[CLASS:Notepad]")
EndFunc ;==>Example