activities
latest
false
UiPath logo, featuring letters U and I in white
UI Automation Activities
Last updated Dec 4, 2024

DragAndDrop

Executes a drag and drop operation from the source UI element to the destination UI element.

This API must be added after Open or Attach.

Definition

Namespace: UiPath.UIAutomationNext.API.Models

Assembly: UiPath.UIAutomationNext.API.Models (in UiPath.UIAutomationNext.API.Models dll)

Overloads

OverloadDescription
DragAndDrop(IElementDescriptor, DragAndDropOptions)Drags and drops a specified UI element, identified by a descriptor of an element from Object Repository, while customizing the drag and drop action.
DragAndDrop(String, DragAndDropOptions)Drags and drops a specified UI element, identified by a string from Object Repository, while customizing the drag and drop action.
DragAndDrop(IElementDescriptor, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)Drags and drops a specified UI element, identified by a descriptor of an element from Object Repository and by the TargetAnchorableModel object, while specifying the key modifiers, the mouse button, and the cursor motion type you want to use.
DragAndDrop(String, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)Drags and drops a specified UI element, identified by a string from Object Repository and a by the TargetAnchorableModel object, while specifying the key modifiers, the mouse button, and the cursor motion type you want to use.
DragAndDrop(TargetAnchorableModel, DragAndDropOptions)Drags and drops a specified UI element, identified by the TargetAnchorableModel object, while customizing the drag and drop action.
DragAndDrop(RuntimeTarget, DragAndDropOptions)Drags and drops a specified UI element, identified by a runtime instance of an Object Repository element, while customizing the drag and drop action.

DragAndDrop(IElementDescriptor, DragAndDropOptions)

Drags and drops a specified UI element, identified by a descriptor of a UI element from Object Repository, while customizing the drag and drop action.

DragAndDrop(
    IElementDescriptor elementDescriptor,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    IElementDescriptor elementDescriptor,
    DragAndDropOptions dragAndDropOptions)
elementDescriptor IElementDescriptor

The UI element that you want to drag and drop, identified by a descriptor of a UI element from Object Repository.

dragAndDropOptions DragAndDropOptions

Additional options to customize the drag and drop operation. You can choose to customize:

  • TargetOptions:
    • Timeout - Specifies the amount of time (in seconds) to wait for the API to run before the SelectorNotFoundException error is thrown. The default value is 30 seconds.
    • DelayAfter - Delay time (in seconds) after executing the API. The default amount of time is 0.3 seconds (300 milliseconds).
    • DelayBefore - Delay time (in seconds) before the API begins performing any operations. The default amount of time is 0.2 seconds (200 milliseconds).
  • TargetAnchorableModel - The location where you want to drag and drop the UI element to.
  • NKeyModifiers - Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
  • NMouseButton - Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
  • CusorMotionType - Specifies the type of motion performed by the mouse cursor. There are two available options:
    • Instant - The cursor jumps to the destination. By default, Instant is selected.
    • Smooth - The cursor moves gradually towards the destination.
  • UseSourceHover - Determines whether to hover over the source before dragging.
  • DelayBetweenActions - Delay (in seconds) between the actions necessary to perform the drag and drop operation.

DragAndDrop(String, DragAndDropOptions)

Drags and drops a specified UI element, identified by a string from Object Repository, while customizing the drag and drop action.

DragAndDrop(
    string target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    string target,
    DragAndDropOptions dragAndDropOptions)
target String

The UI element that you want to drag and drop, identified by a string from the Object Repository.

dragAndDropOptions DragAndDropOptions

Additional options to customize the drag and drop operation. You can choose to customize:

  • TargetOptions:
    • Timeout - Specifies the amount of time (in seconds) to wait for the API to run before the SelectorNotFoundException error is thrown. The default value is 30 seconds.
    • DelayAfter - Delay time (in seconds) after executing the API. The default amount of time is 0.3 seconds (300 milliseconds).
    • DelayBefore - Delay time (in seconds) before the API begins performing any operations. The default amount of time is 0.2 seconds (200 milliseconds).
  • TargetAnchorableModel - The location where you want to drag and drop the UI element to.
  • NKeyModifiers - Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
  • NMouseButton - Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
  • CusorMotionType - Specifies the type of motion performed by the mouse cursor. There are two available options:
    • Instant - The cursor jumps to the destination. By default, Instant is selected.
    • Smooth - The cursor moves gradually towards the destination.
  • UseSourceHover - Determines whether to hover over the source before dragging.
  • DelayBetweenActions - Delay (in seconds) between the actions necessary to perform the drag and drop operation.

DragAndDrop(IElementDescriptor, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)

Drags and drops a specified UI element, identified by a descriptor of an element from Object Repository and a by the TargetAnchorableModel object, while specifying the key modifiers, the mouse button, and the cursor motion type you want to use.
DragAndDrop(
    IElementDescriptor elementDescriptor,
    TargetAnchorableModel destinationTarget,
    [NKeyModifiers? keyModifiers],
    [NMouseButton? mouseButton],
    [CursorMotionType? cursorMotionType],
    [bool? useSourceHover],
    [double? delayBetweenActions])DragAndDrop(
    IElementDescriptor elementDescriptor,
    TargetAnchorableModel destinationTarget,
    [NKeyModifiers? keyModifiers],
    [NMouseButton? mouseButton],
    [CursorMotionType? cursorMotionType],
    [bool? useSourceHover],
    [double? delayBetweenActions])
elementDescriptor IElementDescriptor

The UI element that you want to drag and drop, identified by a descriptor of an element from Object Repository.

destinationTarget TargetAnchorableModel
The location where you want to drag and drop the UI element to.
keyModifiers NKeyModifiers
Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
mouseButton NMouseButton
Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
cursorMotionType CursorMotionType
Specifies the type of motion performed by the mouse cursor. There are two available options:
  • Instant - The cursor jumps to the destination. By default, Instant is selected.
  • Smooth - The cursor moves gradually towards the destination.
useSourceHover Boolean

Determines whether to hover over the source before dragging.

delayBetweenActions Double

Delay (in seconds) between the actions necessary to perform the drag and drop operation.

DragAndDrop(String, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)

Drags and drops a specified UI element, identified by a string from Object Repository and a by the TargetAnchorableModel object, while specifying the key modifiers, the mouse button, and the cursor motion type you want to use.
DragAndDrop(
    string target,
    TargetAnchorableModel destinationTarget,
    [NKeyModifiers? keyModifiers],
    [NMouseButton? mouseButton],
    [CursorMotionType? cursorMotionType],
    [bool? useSourceHover],
    [double? delayBetweenActions])DragAndDrop(
    string target,
    TargetAnchorableModel destinationTarget,
    [NKeyModifiers? keyModifiers],
    [NMouseButton? mouseButton],
    [CursorMotionType? cursorMotionType],
    [bool? useSourceHover],
    [double? delayBetweenActions])
target String
The UI element that you want to drag and drop, identified by a string from the Object Repository.
destinationTarget TargetAnchorableModel

The location where you want to drag and drop the UI element to.

keyModifiers NKeyModifiers
Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
mouseButton NMouseButton
Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
cursorMotionType CursorMotionType
Specifies the type of motion performed by the mouse cursor. There are two available options:
  • Instant - The cursor jumps to the destination. By default, Instant is selected.
  • Smooth - The cursor moves gradually towards the destination.
useSourceHover Boolean

Determines whether to hover over the source before dragging.

delayBetweenActions Double

Delay (in seconds) between the actions necessary to perform the drag and drop operation.

DragAndDrop(TargetAnchorableModel, DragAndDropOptions)

Drags and drops a specified UI element, identified by the TargetAnchorableModel object, while customizing the drag and drop action.
DragAndDrop(
    TargetAnchorableModel target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    TargetAnchorableModel target,
    DragAndDropOptions dragAndDropOptions)
target TargetAnchorableModel
The UI element that you want to drag and drop, identified by the TargetAnchorableModel object.
dragAndDropOptions DragAndDropOptions

Additional options to customize the drag and drop operation. You can choose to customize:

  • TargetOptions:
    • Timeout - Specifies the amount of time (in seconds) to wait for the API to run before the SelectorNotFoundException error is thrown. The default value is 30 seconds.
    • DelayAfter - Delay time (in seconds) after executing the API. The default amount of time is 0.3 seconds (300 milliseconds).
    • DelayBefore - Delay time (in seconds) before the API begins performing any operations. The default amount of time is 0.2 seconds (200 milliseconds).
  • TargetAnchorableModel - The location where you want to drag and drop the UI element to.
  • NKeyModifiers - Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
  • NMouseButton - Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
  • CusorMotionType - Specifies the type of motion performed by the mouse cursor. There are two available options:
    • Instant - The cursor jumps to the destination. By default, Instant is selected.
    • Smooth - The cursor moves gradually towards the destination.
  • UseSourceHover - Determines whether to hover over the source before dragging.
  • DelayBetweenActions - Delay (in seconds) between the actions necessary to perform the drag and drop operation.

DragAndDrop(RuntimeTarget, DragAndDropOptions)

Drags and drops a specified UI element, identified by a runtime instance of an Object Repository element, while customizing the drag and drop action.

DragAndDrop(
    RuntimeTarget target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    RuntimeTarget target,
    DragAndDropOptions dragAndDropOptions)
target RuntimeTarget
The UI element that you want to drag and drop, identified by a runtime instance of an Object Repository element.
dragAndDropOptions DragAndDropOptions

Additional options to customize the drag and drop operation. You can choose to customize:

  • TargetOptions:
    • Timeout - Specifies the amount of time (in seconds) to wait for the API to run before the SelectorNotFoundException error is thrown. The default value is 30 seconds.
    • DelayAfter - Delay time (in seconds) after executing the API. The default amount of time is 0.3 seconds (300 milliseconds).
    • DelayBefore - Delay time (in seconds) before the API begins performing any operations. The default amount of time is 0.2 seconds (200 milliseconds).
  • TargetAnchorableModel - The location where you want to drag and drop the UI element to.
  • NKeyModifiers - Specify the key modifiers you want to use during the drag and drop operation. The following options are available: None, Alt, Ctrl, Shift, and Win.
  • NMouseButton - Specify the mouse button you want to use during the drag and drop operation. The following options are available: Left, Right, and Middle.
  • CusorMotionType - Specifies the type of motion performed by the mouse cursor. There are two available options:
    • Instant - The cursor jumps to the destination. By default, Instant is selected.
    • Smooth - The cursor moves gradually towards the destination.
  • UseSourceHover - Determines whether to hover over the source before dragging.
  • DelayBetweenActions - Delay (in seconds) between the actions necessary to perform the drag and drop operation.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.