activities
latest
false
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
UiPath logo, featuring letters U and I in white
用户界面自动化活动
Last updated 2024年10月28日

拖放

执行从源用户界面元素到目标用户界面元素的拖放操作。

此 API 必须在“打开” 或“附加”之后添加。

定义

命名空间：UiPath.UIAutomationNext.API.Models

程序集：UiPath.UIAutomationNext.API.Models（在 UiPath.UIAutomationNext.API.Models dll 中）

重载

重载描述
DragAndDrop(IElementDescriptor, DragAndDropOptions)拖放由对象存储库中元素描述符标识的指定用户界面元素，同时自定义拖放操作。
DragAndDrop(String, DragAndDropOptions)拖放由对象存储库中的字符串标识的指定用户界面元素，同时自定义拖放操作。
DragAndDrop(IElementDescriptor, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)拖放指定的用户界面元素，该元素由对象存储库中的元素描述符和TargetAnchorableModel对象标识，同时指定您要使用的修饰键、鼠标键和光标移动类型。
DragAndDrop(String, TargetAnchorableModel, NKeyModifiers, NMouseButton, CursorMotionType, Boolean, Double)拖放由对象存储库中的字符串和TargetAnchorableModel对象标识的指定用户界面元素，同时指定要使用的修饰键、鼠标键和光标移动类型。
DragAndDrop(TargetAnchorableModel, DragAndDropOptions)拖放由TargetAnchorableModel对象标识的指定用户界面元素，同时自定义拖放操作。
DragAndDrop(RuntimeTarget, DragAndDropOptions)拖放由对象存储库元素的运行时实例标识的指定用户界面元素，同时自定义拖放操作。

DragAndDrop(IElementDescriptor, DragAndDropOptions)

拖放指定的用户界面元素（由对象存储库中的用户界面元素描述符标识），同时自定义拖放操作。 

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

要拖放的用户界面元素，由对象存储库中用户界面元素的描述符标识。

dragAndDropOptions DragAndDropOptions

用于自定义拖放操作的其他选项。 您可以选择自定义：

  • TargetOptions:
    • 超时- 指定等待时间（以秒为单位），如果超出该时间后 API 并未运行，系统便会抛出SelectorNotFoundException错误。 默认值为 30 秒。
    • “在此之后延迟” - 执行 API 后的延迟时间（以秒为单位）。 默认时间为 0.3 秒 (300 毫秒)。
    • 在此之前延迟- API 开始执行任何操作之前的延迟时间（以秒为单位）。 默认时间为 0.2 秒 (200 毫秒)。
  • TargetAnchorableModel - 要将用户界面元素拖放到的位置。
  • NKeyModifiers - 指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
  • NMouseButton - 指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
  • CusorMotionType - 指定鼠标光标执行的移动类型。 有两个可用选项：
    • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
    • “平滑” - 光标逐渐向目标移动。
  • UseSourceHover - 确定是否在拖动之前将鼠标悬停在来源上。
  • DelayBetweenActions - 执行拖放操作所需的操作之间的延迟（以秒为单位）。

DragAndDrop(String, DragAndDropOptions)

拖放由对象存储库中的字符串标识的指定用户界面元素，同时自定义拖放操作。 

DragAndDrop(
    string target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    string target,
    DragAndDropOptions dragAndDropOptions)
target 字符串

要拖放的用户界面元素，由对象存储库中的字符串标识。

dragAndDropOptions DragAndDropOptions

用于自定义拖放操作的其他选项。 您可以选择自定义：

  • TargetOptions:
    • 超时- 指定等待时间（以秒为单位），如果超出该时间后 API 并未运行，系统便会抛出SelectorNotFoundException错误。 默认值为 30 秒。
    • “在此之后延迟” - 执行 API 后的延迟时间（以秒为单位）。 默认时间为 0.3 秒 (300 毫秒)。
    • 在此之前延迟- API 开始执行任何操作之前的延迟时间（以秒为单位）。 默认时间为 0.2 秒 (200 毫秒)。
  • TargetAnchorableModel - 要将用户界面元素拖放到的位置。
  • NKeyModifiers - 指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
  • NMouseButton - 指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
  • CusorMotionType - 指定鼠标光标执行的移动类型。 有两个可用选项：
    • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
    • “平滑” - 光标逐渐向目标移动。
  • UseSourceHover - 确定是否在拖动之前将鼠标悬停在来源上。
  • DelayBetweenActions - 执行拖放操作所需的操作之间的延迟（以秒为单位）。

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

拖放指定的用户界面元素，该元素由对象存储库中的元素描述符和TargetAnchorableModel对象标识，同时指定您要使用的修饰键、鼠标键和光标移动类型。 
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

要拖放的用户界面元素，由对象存储库中元素的描述符标识。

destinationTarget TargetAnchorableModel
要将用户界面元素拖放到的位置。
keyModifiers 任意键修饰符
指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
mouseButton NMouseButton
指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
cursorMotionType 光标移动类型
指定鼠标光标要执行的移动类型。有两个可用选项：
  • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
  • “平滑” - 光标逐渐向目标移动。
useSourceHover 布尔值

确定是否在拖动前将鼠标悬停在来源上方。

delayBetweenActions Double

执行拖放操作所需的操作之间的延迟 (以秒为单位)。

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

拖放由对象存储库中的字符串和TargetAnchorableModel对象标识的指定用户界面元素，同时指定要使用的修饰键、鼠标键和光标移动类型。 
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 字符串
要拖放的用户界面元素，由对象存储库中的字符串标识。
destinationTarget TargetAnchorableModel

要将用户界面元素拖放到的位置。

keyModifiers 任意键修饰符
指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
mouseButton NMouseButton
指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
cursorMotionType 光标移动类型
指定鼠标光标要执行的移动类型。有两个可用选项：
  • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
  • “平滑” - 光标逐渐向目标移动。
useSourceHover 布尔值

确定是否在拖动前将鼠标悬停在来源上方。

delayBetweenActions Double

执行拖放操作所需的操作之间的延迟 (以秒为单位)。

DragAndDrop(TargetAnchorableModel, DragAndDropOptions)

拖放由TargetAnchorableModel对象标识的指定用户界面元素，同时自定义拖放操作。 
DragAndDrop(
    TargetAnchorableModel target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    TargetAnchorableModel target,
    DragAndDropOptions dragAndDropOptions)
target TargetAnchorableModel
要拖放的用户界面元素，由TargetAnchorableModel对象标识。
dragAndDropOptions DragAndDropOptions

用于自定义拖放操作的其他选项。 您可以选择自定义：

  • TargetOptions:
    • 超时- 指定等待时间（以秒为单位），如果超出该时间后 API 并未运行，系统便会抛出SelectorNotFoundException错误。 默认值为 30 秒。
    • “在此之后延迟” - 执行 API 后的延迟时间（以秒为单位）。 默认时间为 0.3 秒 (300 毫秒)。
    • 在此之前延迟- API 开始执行任何操作之前的延迟时间（以秒为单位）。 默认时间为 0.2 秒 (200 毫秒)。
  • TargetAnchorableModel - 要将用户界面元素拖放到的位置。
  • NKeyModifiers - 指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
  • NMouseButton - 指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
  • CusorMotionType - 指定鼠标光标执行的移动类型。 有两个可用选项：
    • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
    • “平滑” - 光标逐渐向目标移动。
  • UseSourceHover - 确定是否在拖动之前将鼠标悬停在来源上。
  • DelayBetweenActions - 执行拖放操作所需的操作之间的延迟（以秒为单位）。

DragAndDrop(RuntimeTarget, DragAndDropOptions)

拖放由对象存储库元素的运行时实例标识的指定用户界面元素，同时自定义拖放操作。 

DragAndDrop(
    RuntimeTarget target,
    DragAndDropOptions dragAndDropOptions)DragAndDrop(
    RuntimeTarget target,
    DragAndDropOptions dragAndDropOptions)
target RuntimeTarget
要拖放的用户界面元素，由对象存储库元素的运行时实例标识。
dragAndDropOptions DragAndDropOptions

用于自定义拖放操作的其他选项。 您可以选择自定义：

  • TargetOptions:
    • 超时- 指定等待时间（以秒为单位），如果超出该时间后 API 并未运行，系统便会抛出SelectorNotFoundException错误。 默认值为 30 秒。
    • “在此之后延迟” - 执行 API 后的延迟时间（以秒为单位）。 默认时间为 0.3 秒 (300 毫秒)。
    • 在此之前延迟- API 开始执行任何操作之前的延迟时间（以秒为单位）。 默认时间为 0.2 秒 (200 毫秒)。
  • TargetAnchorableModel - 要将用户界面元素拖放到的位置。
  • NKeyModifiers - 指定要在拖放操作期间使用的修饰键。 可用的选项如下：“无”、“ Alt ”、“ Ctrl ”、“ Shift ”和“Win” 。
  • NMouseButton - 指定要在拖放操作期间使用的鼠标键。 提供以下选项： “左侧” 、 “右侧”和“中间”。
  • CusorMotionType - 指定鼠标光标执行的移动类型。 有两个可用选项：
    • “即时 ” - 光标跳转到目标位置。 默认情况下，“ 即时 ”处于选中状态。
    • “平滑” - 光标逐渐向目标移动。
  • UseSourceHover - 确定是否在拖动之前将鼠标悬停在来源上。
  • DelayBetweenActions - 执行拖放操作所需的操作之间的延迟（以秒为单位）。

此页面有帮助吗？

支持与服务
获取您需要的帮助
UiPath Academy
了解 RPA - 自动化课程
UiPath 论坛
UiPath Community 论坛
Uipath Logo White
信任与安全
使用条款
隐私策略
Cookie 政策
© 2005-2024 UiPath。保留所有权利。