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.

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:     
    0
    1

enabled

Indicates whether the object is enabled.

Possible values:     
    0
    1

focused

Indicates whether the object has the focus.

Possible values:     
    0
    1

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.

textThe 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: