Core Function WinWait

WinWait ( <title>, <text>, <timeout> )

Description

Waits until the requested window exists.

Parameters

Title

The title of the window.

Text

Optional; The text of the window to read.

Timeout

Optional; Timeout in seconds.

Return Value

Success: Returns 1.

Failure: Returns 0 if timeout occurred.

Remarks

The window is polled every 250 milliseconds or so.

See "WinTitleMatchMode" in Opt.

Example

// Wait for the window "Untitled" to exist
Run("notepad");
WinWait("Untitled");
 
// Wait a maximum of 5 seconds for "Untitled" to exist
WinWait("Untitled", "", 5);