Legacy | UFT Function Reference: Device
Perfecto Lab Device class; part of the UFT Mobile (QTP) integration.
Incorporates a Perfecto Lab device into the existing UFT structure, with designated object properties and methods.
Properties
The built-in Device properties that can be retrieved from the Device object include:
(Also see the Device info function.)
- device_id
- status
- rotation
- resolution_width
- resolution_height
- resolution
- position
- phone_number
- os_version
- os
- network
- model
- manufacturer
- location
- last_timer_ux
- last_timer_system
- last_timer_device
- last_timer_elapsed
- language
- in_use
- imsi
- firmware
- distributer
- description
- cradle_id
Use the GetROProperty UFT method to retrieve the current value of a specified identification property from the Device object.
Functions
| Name | Description |
|---|---|
| Close | Close the device. |
| Drag | Perform a drag gesture on the device screen. |
| Home | Bring the device to its idle/home screen. |
| KeyboardDisplay | Control the virtual keyboard display. |
| Open | Open the device. |
| PressKey | Press a key or a sequence of keys. |
| Reboot | Reboot the device. |
| Roll | Roll the trackball across the target device screen. |
| PressKey | Press a key or a sequence of keys. |
| Screenshot | Capture an image of the current screen display, in JPEG format, and store it in the media repository. |
| ScreenText | Retrieve the text that appears on the device screen. |
| Swipe | Perform a swipe gesture on the device screen. |
| Touch | Perform a touch gesture on the device screen. |
| Type | Type text into the device. |
| Applications | Applications functions. |
| Checkpoints | Checkpoints functions. |
| Files | Files functions. |
| Resources | Resources functions. |
| UserFunctions | UserFunctions functions. |
| WebBrowser | WebBrowser functions. |
| MButton | A button object identified on the device screen based on an image or text label. It can be found and clicked on. |
| MEdit | A text object identified on the device screen based on an image or text label. It can be found, retrieved, and set to the specified text. |
| MObject | An image or text object (the needle) that can be found and clicked on the device screen (the haystack). |
| GetROProperty | Return the current value of the specified identification property dialog box the object in the application. |
| Additional UFT functions |
|
Example
| UFT Mobile Code Syntax | Description |
|---|---|
| Device("DUT").Home | On the device under test (DUT), brings the device under test to its home screen. |
| Device("DUT").GetROProperty("manufacturer") | On the DUT, retrieves the manufacturer property of the device under test (DUT) object. |
| Device("DUT").MEdit("image").GetROProperty("text") | On the DUT, retrieves the text property from the MEdit object – using the Edit Get (image) function. |