"DESKTOP_DRAG_AND_DROP" Command

Owned by Joseph Hamdan
Last updated: Feb 02, 2023
2 min read

Description: This command drags and drops a desktop element defined by a screenshot of the target (Desktop locator) or by OCR with the option Use Text to another element on screen.

Usage Scenario: Suppose we want to drag folder named “New Folder - Copy 5” to folder named “New Folder - Copy 6”.

Procedure: Take a screenshots of both folders highlighting the most distinguishable parts of the folders (Copy 5 / Copy 6) and upload them to be used in Desktop locators for the command to interact with. Your step will look like this:

  • NOTE: The Similarity field is to adjust the matching approximation (minimum of 0.10 - maximum of 0.98 - default of 0.75) which improves the accuracy of matching the exact image in the case of multiple images with similar appearance.

Alternatively, you can use OCR Use Text option and enter the text New Folder - Copy 5 and New Folder - Copy 6

Desktop commands are controlled by Locator Timeouts under User Execution Preferences. If the locator timeout is not sufficient enough for the command to find the element, you can increase Locator Timeout to give the step more time to work. It’s recommended to use 20 seconds for desktop commands.

Notes:

  1. If you do not see any highlight during execution, please enable the option Desktop Highlight under User Execution Preferences and save.

  2. Crop Region Offset can be used to designate an area for execution to look through to reduce execution duration and ensure additional accuracy. The values provided will crop the area. For example, if you provide 50 points in the Left field, only the 50% of the right side of your screen will be interacted with.

  3. Multiline can be used to interact with text which is visible on multiple lines.

The following video demonstrates how these steps get executed: