Help Centre › Building Processes
This article describes the RPA Screen functionality to drag an image to a specified point.
For a full list of available functions, please read SCREEN functions.
Description
The SCREEN Drag image to point function finds an image on the screen and drags it to the specified destination coordinates.
Setting it up
To use the SCREEN Drag image to point function, follow these instructions:
{{popups:rpas/add:action=screen-drag-to}}
Once on a process map:
- Navigate to the process where you would like to add the SCREEN Drag image to point function
- Click on the green button's drop-down (right side of the green button labelled "Process")
- On the menu that appears, click on the "+ Activity" item
- From here you can select the SCREEN Drag image to point option
- Click "Add" once you are done
Input parameters
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| Image path | Yes | Text | - | The file path to the reference image to drag |
| Destination X | Yes | Number | - | The horizontal coordinate to drag the image to |
| Destination Y | Yes | Number | - | The vertical coordinate to drag the image to |
| Confidence | No | Number (0.0-1.0) | 0.9 | The minimum confidence threshold for a match |
| Duration | No | Number (seconds) | 0.5 | The duration of the drag animation |
| Variable | No | Text | location | The variable name to store the source location |
Output variables
The {location} variable contains an object with the source location properties: x, y, width, height, center_x, center_y.
Errors
| Error | Description |
|---|---|
| Image not found on screen | The specified image could not be found on the screen |
Tips
- Use a higher duration value for smoother, more reliable drag operations
- Combine with screen-find to get the destination coordinates dynamically