Wait For Window or Control

   

[Professional Edition Only]

 

The Wait For Window or Control action allows you to pause a running project until a window or control matching certain criteria has appeared on the screen.

 

Some uses for this tool include:

 

Monitoring a running application in case it pops up an Error or Warning dialog.
Waiting for a process to finish starting up.
Waiting for a process to exit after an operation completes.

 

 

Target Property Page

 

Use the Target Property Page to select the window or control to wait for. This is easiest if you can automatically configure the action by "showing" it a copy of the object you want to wait for.

 

WARNING: Sometimes, FinalBuilder will automatically configure a window to have a simple description such as "ModalDialog" or "MainWindow". These descriptions can be quite ambiguous. It is suggested that you configure the action to wait for a specific button or other control inside the target window, or that you reconfigure the action to match on the window class and/or caption.

 

 

Wait Parameters Property Page

 

 

GUIAutomation_WaitOptions

 

Wait For Process

 

"Wait for the process"

 

If this option is selected and the target process is not running when the action is started, then the action will wait until the process starts running (and then wait for the window/control.)

 

"Fail if process not running"

 

If this option is selected and the target process is not running when the action is started, then the action will fail straight away.

 

 

 

Timeout

 

"Only time out if the process exits"

 

This option disables timeouts for the Wait action, except for when the target process exits.

 

 

"Time out after x seconds/minutes"

 

This option waits for a maximum length of time, and then "times out." You can set the timeout behaviour under "On Timeout":

 

 

 

On Timeout

 

"Do Nothing"

 

If this option is selected, the action will time out and succeed.

 

 

"Fail the action"

 

If this option is selected, then the action will fail if it times out.

 

 

"Set Variable"

 

If this option is selected, then the specified variable will be set to the specified value if the action times out. If the action does not time out, the variable will not be changed.

 

 

 

On Find Window Property Page

 

GUIAutomation_WaitOnFind

 

This property page allows you to choose what to do if the window or control is found.

 

"Do nothing"

 

The action will succeed without doing anything to the window/control.

 

 

"Close window"

 

The action will close the window which contains the target control (or the window itself, if the target is a window.) This is the equivalent of clicking on the "Close" box of the relevant window.

 

 

"Click a standard button..."

 

If the target control is a window or a modal dialog which contains "standard" Windows buttons, then this option will click on the button with the specified name. This is useful for modal warning or error dialogs which may need to be automatically dismissed.

 

Hint: If you need to perform more sophisticated clicking, add a Perform Mouse Click action to the project and place it as a child/sibling of the Wait action.