Object Model Reference for GUI Testing > Utility Objects > GetArgument Method

VisualRelation Object

Description

An object that defines the details of a single visual relationship between a related object and the test object.

Important Information

If you need to specify more than one relative position for the same related object (for example, the related object is both left and above the test object to identify), include a separate VisualRelation object in the VisualRelationsCollection Object for each relationship.

Methods and Properties

Method GetArgument Returns the value of a visual relation argument.
SetTOProperty Sets the specified value of an description properties for an object.
RelatedObjectPath The full object hierarchy path of the related object
RelativePosition The position of the related object relative to the test object.
SetArgument Sets the value of a visual relation argument.

Back to top

GetArgument Method

Description

Returns the value of a visual relation argument.

Syntax

ArgVal = VisualRel.GetArgument(Argument)

Argument

Type

Description

Argument

String or Pre-defined constant

The name of the argument you want to retrieve

Possible values:

  • Inline (string) or micrelinline (constant)--A boolean argument that indicates whether the related object is (horizontally or vertically) in-line with the test object

ArgVal

Variant

A variable that will store the retrieved argument value.

Return Value

Variant. The value of the argument.

IMPORTANT


Back to top

RelatedObjectPath Property

Description

The full object hierarchy path of the related object. For example: "Browser("Welcome: Mercury Tours").Page("Book a Flight: Mercury").WebEdit("passFirst1")"

Syntax

VRIColl.RelatedObjectPath

Return Value

Read-write. String.

IMPORTANT

The specified object must be an object from the test object repository. It cannot be a test object specified by a programmatic description.


Back to top

RelativePosition Property

Description

The position of the related object relative to the test object.

Syntax

VRIColl.RelativePosition

Return Value

Read-write. String (or Pre-defined constant).

Possible values:

Constant

String

Description

micRelLeft

left

The related object is to the left of the test object.

micRelRight

right

The related object is to the right of the test object.

micRelAbove

above

The related object is above the test object.

micRelBelow

below

The related object is below the test object.

micRelContains

contains

The related object contains the test object.

micRelClosestX

closest-x

The related object is the closest object on the X-axis to the test object.

micRelClosestY

closest-y

The related object is the closest object on the Y-axis to the test object.

micRelClosest

closest

The related object is the closest object to the test object.


Back to top

SetArgument Method

Description

Sets the value of a visual relation argument.

Syntax

VisualRel.SetArgument Argument, Value

Argument

Type

Description

Argument

String or Pre-defined constant

The name of the argument you want to set.

Possible values:

  • Inline (string) or micrelinline (constant))--A boolean argument that indicates whether the related object is (horizontally or vertically) in-line with the test object

Value

Variant

The value to assign to the argument.

IMPORTANT


Back to top

See also: