JavaLink description properties
Object description properties can be used in the object repository description, in programmatic descriptions, in checkpoint and output value steps, and as argument values for the GetTOProperty and GetROProperty methods.
In earlier releases of QuickTest, Java description properties were not case-sensitive. If you learned a test object in a QuickTest version earlier than 11.00, you need to re-learn the object with properties that are case-sensitive by performing an Update Run (using the Update test object descriptions option). For more details, see the section on updating test object descriptions in the UFT One User Guide.
The JavaLink test object supports the description properties listed in the table below. Note, however, that some of the properties may not be applicable for a specific JavaLink object and some objects may have additional description properties that are generated dynamically.
Property Name | Description |
---|---|
abs_x | The object's absolute x-coordinate (left) relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor. If you are working with multiple monitors, the coordinate in the secondary monitor is relative to the primary monitor. For example, given a resolution of 1280 x 1024 in the primary monitor, if the secondary monitor is positioned to the right of the primary monitor, the x-coordinate is 1280 or greater. If the secondary monitor is placed to the left of the primary monitor, the x-coordinate is negative. |
abs_y | The object's absolute y-coordinate (top) relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor. If you are working with multiple monitors, the coordinate in the secondary monitor is relative to the primary monitor. For example, given a resolution of 1280x1024 in the primary monitor, if the secondary monitor is positioned below the primary monitor, the y-coordinate is 1024 or greater. If the secondary monitor is placed above the primary monitor, the y-coordinate is negative. |
attached text | The static text that is attached to an object. |
background | The object's background color. |
class description | The general object type (i.e. list, button, table). |
class_path | The Java class hierarchy of the object's Java class. |
developer name | The object's internal name. |
displayed | Indicates whether the object is displayed on the screen. Possible values: |
enabled | Indicates whether the object is enabled. Possible values: |
focused | Indicates whether the object has the focus. Possible values: |
foreground | The object's foreground color. |
height | The object's height (in pixels). |
hwnd | The run-time object's window handle. |
index | The ordinal identifier that UFT One assigns to the object to indicate the order in which the object appears in the code relative to other objects with an otherwise identical description. This property cannot be used with GetROProperty. Values begin with 0. |
label | The object's label. |
labeled_containers_path | The hierarchical path of the tab and group controls containing the object. The path is composed of the container type and name of each control, in the following format: <Container1>:<Name1>;...<ContainerN>:<NameN>. Supported for SWT-based controls only. If UFT One does not recognize the object as a child object of a labeled container in the test object hierarchy, then the labeled_containers_path value for it will be empty. If you are not sure whether the object is a child object of a labeled container, you can use the Properties tab of the Object Spy to view this property. |
logical_location | The ordinal identifier that UFT One assigns to the object to indicate where the object appears within the window, frame, or dialog box. Values are assigned from top to bottom, and left to right. This property cannot be used with GetROProperty. Values begin with 0. |
path | The object's hierarchy (object ancestors). |
tagname | The test object's name. |
text | The text displayed for the object. |
toolkit class | The object's Java class name. |
value | The text displayed in the link object. |
visual relations | Represents the test object's visual relations identifier. Use this property in GetTOProperty and SetTOProperty steps to return or apply a VisualRelationsCollection object for a test object. The VisualRelationsCollection object enables you to retrieve or replace the visual relation identifier settings of a test object during a run session. Syntax: SetVRIColl = TestObject.GetTOProperty("visual relations") TestObject.SetTOProperty "visual relations", VRIColl For details, see VisualRelationsCollection Object in the Utility Objects section of the UFT One Object Model Reference for GUI Testing. This property is not listed in the Object Spy. It is not retrieved when you use the GetTOProperties method. It cannot be used in the Object Identification dialog box, the description area of the object repository, checkpoint or output value steps, and so on. |
width | The object's width (in pixels). |
x | The object's x-coordinate (left) relative to the parent object (in pixels). |
y | The object's y-coordinate (top) relative to the parent object (in pixels). |
See also: