MobileButton description properties

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

Note: Most 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. However, some object description properties can be used only in checkpoint and output value steps, and with GetROProperty, WaitProperty, and CheckProperty steps, whereas others can be used only when identifying an object, as indicated below.

Property

Description

accessibilityid

The accessibility ID of the mobile control.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

bottom

The offset (in pixels) of the mobile control's bottom border from the top of the device's screen.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS support: Supported

Android: Supported

class*

The test object class name used by Digital Lab to identify objects, such as button or table.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

container

The x-path to the control within its container.

Syntax: <Class>[index][row][cell] (All values are 0-based)

Example: Table[1][3][5] means that the object is in the 6th cell of the 4th row of the 2nd Table object.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Packaged apps only

iOS: Supported

Android: Not supported

height**

The mobile object's height (in pixels).

Object identification: Not supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

hint

Instruction or example indicating the type of content to enter for the value of a control, for example, a grayed out hint inside a text box.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Packaged apps only

Android: Packaged apps only

This property is not supported on Flutter-based objects.

isCheckable

Indicates whether the mobile control contains a check box that can be selected. Boolean value. (Relevant for controls with a check box.)

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

isChecked

Indicates whether the mobile control is checked. Boolean value. (Relevant for controls with a check box.)

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

isClickable

Indicates whether the mobile control can be tapped (clicked). Boolean value.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: iOS supported for packaged apps only; Android supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

isEnabled

Indicates whether the mobile control is enabled. Boolean value.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

isFocusable

Indicates whether the mobile control can be brought into focus. Boolean value.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

isFocused

Indicates whether the mobile control is in focus. Boolean value.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

This property is not supported on Flutter-based objects.

left**

The offset (in pixels) of the mobile control's left border from the left side of the device's screen.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

mcindex

An ordinal number assigned to the object by Digital Lab to indicate the order in which the object appears on the device relative to other objects with an otherwise identical description.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: iOS supported; Android not supported for GetProperty on non-packaged apps

ChildObjects: Supported

iOS: Supported

Android: Supported

nativeclass

The native class of the mobile control.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: iOS supported; Android supported on packaged apps only

ChildObjects: iOS supported; Android supported for packaged apps only

iOS: Supported

Android: Supported

resourceid

The resource ID for the control. (Relevant only for Android)

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Not supported

Android: Supported

right**

The offset (in pixels) of the mobile control's right border from the left side of the device's screen.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

text

The text property of the mobile control.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Supported

iOS: Supported

Android: Supported

tooltip

Text displayed when hovering over the button. Usually describes the operation that occurs when the button is pressed.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

top**

The offset (in pixels) of the mobile control's top border from the top of the device's screen.

Object identification: Supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

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 OpenText Functional Testing 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 mobile object's width in pixels.

Object identification: Not supported

Checkpoints / Output value properties / GetROProperty: Supported

ChildObjects: Not supported

iOS: Supported

Android: Supported

* Required by Digital Lab to identify the objects in the application.

** When defining the location of an object:

  • For native apps, use top, left, right, and bottom to define the location of the object on the device.

  • For native and hybrid apps, use abs_x, abs_y, width, and height to define the location of the object on the desktop screen, such as on the Digital Lab remote access window.

See also: