Citrix ICA Vuser Functions (CTRX) > Alphabetical List of Functions > ctrx_<obj>_get_info

ctrx_<obj>_get_info

ctrx_button_get_info

ctrx_edit_get_info

ctrx_list_get_info

Example: ctrx_<obj>_get_info Information Retrieval Functions

Gets class information about the object.

int ctrx_obj_get_info( const char *window_name, long xpos, long ypos, eObjAttribute attribute, char *value, [CONTINUE_ON_ERROR,] CTRX_LAST );
window_name The window title. NULL if not within an active window.
xpos The horizontal distance of the object from the edge of the application window, or ICA client window
ypos The vertical distance of the object from the edge of the application window, or ICA client window
attribute The Object Attributes whose value is to be retrieved
value An output buffer for the retrieved value. object_value_buffer is allocated automatically. You may use any buffer, but you must declare and allocate memory in the script.
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.

The ctrx_<obj>_get_info family of functions assign the value of the attribute to the value buffer. ctrx_obj_get_info is a generic function that can be entered on any object identified as such by the recorder.

If an object is outlined in yellow in the snapshot in the tree view, then it has been recognized as an object. Right click on the outlined object, and choose Insert Object Get Info. The call will be inserted in the script.

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

ctrx_button_get_info gets information on command buttons.

ctrx_edit_get_info gets information on text boxes.

ctrx_list_get_info gets information on list boxes.

Return Values

Citrix ICA Return Values

Parameterization

All input string arguments (char type) can be parameterized using standard parameterization.