Share this page
MobilePager description properties
The MobilePager test object supports the description properties listed in the table below.
This object is supported in iOS only.
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 Name | Description |
|---|---|
| accessibilityid | The accessibility ID of the mobile control. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: 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 |
| 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 |
| 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 |
| height** | The mobile object's height (in pixels). Object identification: Not supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Not 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: Supported: GetROProperty, WaitProperty, CheckProperty ChildObjects: Supported iOS: Packaged apps only |
| 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: iOS supported for packaged apps only |
| 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 |
| 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 |
| isEnabled | Indicates whether the mobile control is enabled. Boolean value. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Supported |
| isFocusable | Indicates whether the mobile control can be brought into focus. Boolean value. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Supported |
| isFocused | Indicates whether the mobile control is in focus. Boolean value. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Supported |
| 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 |
| 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: Supported ChildObjects: Supported |
| nativeclass | The native class of the mobile control. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Supported |
| resourceid | The resource ID for the control. (Relevant only for Android) Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: 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 |
| text | The text property of the mobile control. Object identification: Supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: 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 |
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 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 mobile object's width in pixels. Object identification: Not supported Checkpoints / Output value properties / GetROProperty: Supported ChildObjects: Not 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:
