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

ctrx_get_text_ocr

Example Information Retrieval Functions

Retrieves the text in a rectangle using optical character recognition (OCR).

int ctrx_get_text_ocr( 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.
You can use the asterisk wildcard character (*) in window_name.
xpos Output parameter. The horizontal distance of the rectangle from the left edge of the window if defined or relative to the ICA client if window_name is null.
ypos Output parameter. The vertical distance of the rectangle from the top edge of the window if defined or relative to the ICA client if window_name is null.
width The width of the window in pixels.
height The height of the window in pixels
filename The snapshot. Do not edit this argument.
text_buffer Output for the text. The default text buffer, named text_buffer, is allocated automatically. If you do not use text_buffer, you must allocate the buffer. For example, char myBuffer[1000];
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_ocr assigns the text in a rectangle into text_buffer. The text can later be used in correlation. This function can be used without the Citrix Agent being installed on the Citrix server.

You can use ctrx_get_text_ocr to retrieve the text from a bitmap or from a character string.

This function is not recorded. You can insert it manually into your script.

Return Values

Citrix ICA Return Values

Parameterization

Parameterization is available for all arguments of this function.

Example

This example shows the use of ctrx_get_text_ocr.

   ctrx_sync_on_window("Start", CREATE, 2, 560, 53, 39, "snapshot4", CTRX_LAST);
   ctrx_get_text_ocr(NULL, 6, 56, 65, 20, "snapshot_1", text_buffer, CTRX_LAST);
   // Action.c(20): Retrieved Text "Recycle Bin" in region (6, 56, 65, 20) in the desktop window

   ctrx_sync_on_obj_info("NULL=snapshot5", 29, 574, TEXT, "Start", CTRX_LAST);
   ctrx_obj_mouse_click("<class=Button text=Start>", 29, 574, LEFT_BUTTON, 0, "NULL=snapshot5", CTRX_LAST);
   ctrx_get_text_ocr(NULL, 20, 571, 30, 18, "snapshot_2", text_buffer, CTRX_LAST);   
   // Action.c(26): Retrieved Text "Start" in region (20, 571, 30, 18) in the desktop window