TeTextScreen description properties

The TeTextScreen test object supports the description properties listed in the table below.

Property Name

Description

column count

The number of columns in the screen.

current column

The current column position of the cursor in the terminal emulator screen. The first column in the screen is 1.

Note: This property does not have a value when your emulator settings have been configured as supporting text-only HLLAPI operations.

current row

The current row position of the cursor in the terminal emulator screen. The first row in the screen is 1.

Note: This property does not have a value when your emulator settings have been configured as supporting text-only HLLAPI operations.

index

The ordinal identifier that UFT One assigns to the object to indicate the order in which the object appears relative to other objects with an otherwise identical description. The property can be useful for uniquely identifying an object using programmatic descriptions. This property cannot be used with GetROProperty.

Values begin with 0.

Note: You can record on one terminal emulator session at a time.

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.

row count

The number of rows in the screen.

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 section of the Object Model Reference.

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.

See also: