|Example||Citrix Synchronization Functions|
Waits until a window is created or becomes active.
int ctrx_sync_on_window( char *window_name, eWindowEvent event, long x_start, long y_start, long width, long height, char *filename, [CONTINUE_ON_ERROR,] CTRX_LAST );
|window_name||The window title.|
|event||The event indicating success: CREATE or ACTIVE.|
|x_start||The horizontal distance in pixels of the window's left edge from the left edge of the ICA client window.|
|y_start||The vertical distance in pixels of the window's top edge from the top edge of the ICA client window.|
|width||The width in pixels of the window.|
|height||The height in pixels of the window.|
|filename||The name of the image file containing a screen shot of the window. This file is located in the script directory under \data\snapshots.|
|CONTINUE_ON_ERROR||A constant, entered as shown without quotes. Overrides the error behavior runtime setting for this step so that script behaves as though the runtime setting was Continue on error.|
|CTRX_LAST||A marker that indicates the end of the argument list.|
ctrx_sync_on_window is a synchronization function that waits for a window to become created or active.
For objects that are never truly active, such as menus, use the CREATE event to synchronize your actions. For regular windows, specify the ACTIVE event, which occurs after the CREATE event. This insures that the window is stable.
The asterisk wildcard character (*) can be used in window_name.
No parameterization is available for this function.
In the following example, the test run waits for the ICA Administrator toolbar to become active.
ctrx_set_connect_opt(NETWORK_PROTOCOL, "TCP/IP + HTTP"); ctrx_connect_server("plato", "test", lr_unmask("3de476be2c6b6455"), "plato", CTRX_LAST); ctrx_wait_for_event("LOGON"); ctrx_sync_on_window("ICA Administrator Toolbar", ACTIVATE, 768, 0, 33, 573, "129c54d64c9679ea1a0cb8bb02c2a981", CTRX_LAST ); ctrx_sync_on_window("2_233_205_344", CREATE, 2, 233, 205, 344, "060460d39afede68e26c5a8437a94a83", CTRX_LAST );