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

拖放

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

此 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 - 执行拖放操作所需的操作之间的延迟(以秒为单位)。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。