background image
<< Setting Wait State and Delay Options | Setting Delay Options for Commands and Keystrokes >>
<< Setting Wait State and Delay Options | Setting Delay Options for Commands and Keystrokes >>
The Error Recovery tab
Setting GUI Playback Options
9-7
Setting Wait State Options
During playback, Robot waits for windows (including dialog boxes) to appear
before executing a user action or verification point command. You can specify how
often Robot checks for the existence of a window and how long it waits before it
times out.
For example, suppose that Robot is playing back a script with the following lines:
StartApplication "MyVBApp.exe"
Window SetContext, "Name=Form1",""
Pushbutton Click, "Name=Command5"
This example specifies that Robot should start an application, find a window on the
desktop named "Form1", find a pushbutton named "Command5", and generate a
click on that button. However, suppose Robot gets to the
SetContext
line in the
script and fails to find a window named "Form1". This may not necessarily be an
error -- the application may not yet have started up and created the window. In this
case, Robot keeps looking for the window for a specified period of time.
By default, if Robot cannot find a window during playback, it waits for 2 seconds
and then looks for it again. If it still cannot find the window after 30 seconds, it
times out and returns a command failure indication to the script. Script execution
continues or stops based on the On script command failure setting in the Error
Recovery tab of the GUI Playback Options dialog box.
You can change the default values for the retry time and the timeout by changing
the wait state options.
To set the wait state options:
1. Open the GUI Playback Options dialog box. (See Setting GUI Playback Options
on page 9-3.)
2. Click the Wait State tab.
3. To specify how often Robot checks for the existence of a window, type a
number in the Retry test every box.
4. To specify how long Robot waits for a window before it times out, type a
number in the Timeout after box.
5. Click OK or change other options.