Share this page

# rdp_get_object_info

Retrieves information about the object at the specified coordinates.

General Functions

int rdp_get_object_info( "StepDescription=<step description>", "Snapshot=<snapshot>", ["ConnectionID=<connection identifier>",] "WindowTitle[/RE]=<window title>", ["WindowOrdinal=<window ordinal>",] "ObjectX=<x position>", "ObjectY=<y position>", "Attribute=<attribute>", "Value=<parameter name>", RDP_LAST );

This function returns LR_PASS (0) on success or LR_FAIL (1) on failure. Note that LR_PASS and LR_FAIL generally indicate whether the function call completed without an exception, and not that the test step succeeded.

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

Argument | Description
--- | ---
StepDescription | A descriptive, unique name for this step. Use any text.
Snapshot | The name of the snapshot file of the screen state before this step.
ConnectionID | The name of the connection on which this function operates. Do not change the recorded ID. If several connections are open and the ID is not specified, the first connection in the script is used. If only one connection is open, the connection ID is not required.
"WindowTitle=" "WindowTitle/RE=" | The title of the window. The value for Title is a literal string, for example, `"Title=Quality Center"`. If you use WindowTitle/RE, the value is a regular expression, for example, `"WindowTitle/RE=^Document[0-9]+ - Microsoft Word"`.
WindowOrdinal | The 1-based index of the window among the session windows that match the title specified by WindowTitle or WindowTitle/RE. For example, if the WindowTitle/RE and WindowOrdinal arguments are `"WindowTitle/RE=Document[0-9]+ - Microsoft Word"` and `"WindowOrdinal=3"`, the window specified is the third window in the creation order of the existing windows whose title matches the regular expression `"Document[0-9]+ - Microsoft Word"`. If this optional argument is omitted, the default value is 1.
ObjectX | The horizontal distance of the object from the left edge of the window.
ObjectY | The vertical distance of the object from the top edge of the window.
Attribute | One of the Object Attributes constants.
Value | The value of the attribute.
RDP_LAST | The delimiter marking the end of the argument list.

The rdp_get_object_info function retrieves information about an object at the specified coordinates.

The execution of this function requires the RDP agent to be installed on the RDP Server.

Note: This function might not work on some Java applications.

# Object Attributes

Objects have the following attributes:

Attribute Name | Applies to: | Values
ENABLED | All objects | "TRUE" or "FALSE"
FOCUSED | All objects | "TRUE" or "FALSE"
CHECKED | Check box, radio button | "TRUE" or "FALSE"
LINES | List box, combo box | String representation of number of lines the list contains (Decimal representation).
TEXT | All objects | Text
CONTROL_ID | All objects | String representation of the object's control ID (Decimal representation).
ITEM_TEXT | List box, combo box Note that a line in a list box may be highlighted to indicate the current mouse position. This does not indicate that the item is selected. | The text of the selected item. For a combo box, this is the item in the text box. For a list box, it is the last item clicked.

## Example

The following shows a script retrieving the control ID for an object at certain coordinates in a Notepad window and saving it in MyParam.

Copy code

    rdp_get_object_info(
        "StepDescription=Get Object Info 1",
        "Snapshot=snapshot1.inf",
        "WindowTitle=Notepad",
        "ObjectX=127",
        "ObjectX=68",
        "Attribute=CONTROL_ID",
        "Value=MyParam",
        RDP_LAST );

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: