Citrix ICA Vuser Functions (CTRX) > Alphabetical List of Functions > ctrx_execute_on_window

ctrx_execute_on_window

Example: ctrx_execute_on_window General Functions

Specifies handler function on window appearance.

void ctrx_execute_on_window( char *window_name, long handler );
window_name The name of the window that initiates the handler.
handler The function to invoke when the window is displayed.

ctrx_execute_on_window specifies the function to call when a window appears. When a window with name window_name appears, the handler function is invoked. ctrx_execute_on_window is typically used to handle a popup dialog box.

The asterisk wildcard character (*) can be used in window_name.

Put the actions you wish to perform in the handler function, which must have the following prototype:

int handler( char *title);

The name of the window is passed to the handler as title argument..

Note: The lr_rendezvous function is not supported when a ctrx_execute_on_window function is pending.

Return Values

This function has no return value.

Parameterization

No parameterization is available for this function.