Open topic with navigation
|Example: ctrx_set_window_ex||Synchronization Functions|
Waits a specified time for a window to appear in the Citrix client.
int ctrx_set_window_ex( char *window_name, long waitTime, [CONTINUE_ON_ERROR,] CTRX_LAST );
|window_name||The window title.|
|waitTime||The time, in seconds, to wait for window_name to appear|
|CONTINUE_ON_ERROR||A constant, entered as shown without quotes. Overrides the error behavior run-time setting for this step so that script behaves as though the run-time setting was Continue on error.|
|CTRX_LAST||A marker that indicates the end of the argument list.|
When emulating a GUI user, a window must appear before it can be used.
ctrx_set_window_ex is a synchronization function that waits up to waitTime seconds for a window to appear before the Vuser emulates any keyboard or mouse activity in the window.
The window_name argument indicates the name of the window that ctrx_set_window_ex waits for, as it appears in the window's top header frame. The asterisk wildcard character (*) can be used in window_name.
waitTime is the timeout for the window to appear. If window_name does not appear in within this period, ctrx_set_window_ex exits. waitTime does not affect the timeout of other functions, only the call to ctrx_set_window_ex.
If there is a succession of windows appearing in a short period of time, VuGen will only record the last call to ctrx_set_window_ex.
The parameter window_name can be parameterized