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

ctrx_get_text

Example: ctrx_get_text Information Retrieval Functions

Retrieves the text in a rectangle.

int ctrx_get_text( char *window_name, long xpos, long ypos, long width, long height, char *filename, char *text_buffer, [CONTINUE_ON_ERROR,] CTRX_LAST );
window_name The window title. NULL if not within an active window.
xpos The output parameter containing the horizontal distance of the rectangle from the left edge of the window
ypos The output parameter containing the vertical distance of the rectangle from the edge of the window
width The width of the window, in pixels
height The height of the window, in pixels
filename The snapshot. Do not edit this field
text_buffer Output for the text
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.

ctrx_get_text assigns the text in a rectangle into text_buffer. The text can later be used in correlation.

This function is available only if the agent is installed on the Citrix server.

The xpos, ypos are relative to the window if defined or to the ICA client if window_name is null.

The default text_buffer is named text_buffer. If you use text_buffer, there is no need to allocate memory for it. If you use your own buffer, you must allocate the space.

ctrx_get_text works only when the text is real text and not a bitmap. This function can be added manually or while recording, by using the rectangle button on the floating toolbar.

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

Return Values

Citrix ICA Return Values

Parameterization

No parameterization is available for this function.