Open topic with navigation
|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.
No parameterization is available for this function.