JavaDialog 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 JavaDialog 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 JavaDialog object and some objects may have additional description properties that are generated dynamically.
Property | 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. |
java window | Indicates whether the object is a Java window. Possible values: |
label | The object's label. |
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. |
maximizable | Indicates whether the window is maximizable. Possible values: |
maximized | Indicates whether the window is maximized. Possible values: |
minimizable | Indicates whether the window is minimizable. Possible values: |
minimized | Indicates whether the window is minimized. Possible values: |
path | The object's hierarchy (object ancestors). |
resizable | Indicates whether the window is resizable. Possible values: |
tagname | The test object's name. |
text | The text displayed for the object. |
title | The dialog box title. |
toolkit class | The object's Java class name. |
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: