鼠标滚动

UiPath.UIAutomationNext.Activities.NMouseScroll

描述

通过向指定的用户界面元素发送鼠标滚动事件来启用应用程序中的滚动。

无法在使用应用程序/浏览器活动内添加此活动。

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

此活动可与对象存储库兼容。

备注：

如果未为此活动提供任何目标，则系统会自动使用包含该活动的作用域的目标。

此外，由于此活动的性质，它不能在后台模式下使用。

有关指定和配置目标的更多信息，请参阅 选择屏幕。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 选择 菜单 按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。

• “方向” - 要执行的滚动方向。 提供以下选项： “左” 、 “上”、 “右”、 “下”。 默认选项为 “ 关闭”。

• 滚动类型 - 在此活动的两种使用方法之间进行选择：

  • “目标元素” - 滚动，直到在目标应用程序中找到指定的用户界面元素。 这是默认选项。

    注意： 如果在 滚动类型 字段中选择 目标元素 ，则 滚动次数 属性字段将被忽略，并查找指定的用户界面元素。

    如果在运行时未找到指定元素，则活动将滚动 到“滚动 次数” 字段中指定的时间，然后重试搜索指定元素。 此行为会根据需要重复多次，直到找到元素为止，并且对于加载时间较长的应用程序非常有用。

  • “距离 ” - 仅滚动 “滚动次数 ” 属性字段中指定的滚动距离。

    注意： 滚动移动所滚动的行数在 Windows 的“ 鼠标 设置”部分中配置。 如果滚动到特定元素，则在执行所有旋转后搜索该元素。 选择此方法还会在活动主体中显示“ 滚动次数” 属性。

• “滚动到元素” - 单击 “在应用程序/浏览器 中指明”，以指明要滚动到的用户界面元素。 仅当从 滚动类型 下拉菜单中选择目标 元素 时，才会显示此选项。

属性面板

常见

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• 显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

  重要事项： 如果要滚动到图像目标，建议增加“ 超时 ”属性的值，以适应更长的图像搜索时间。

输入

• 光标移动类型 - 指定鼠标光标执行的移动类型。 有两个可用选项：

  • 即时 - 光标跳至目标位置。 这是默认选项。
  • “平滑 ” - 光标以增量方式移动。 仅当使用 硬件事件 输入模式时，该设置才有效。
• “目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前，此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。
  • 单击偏移量 - 指定单击活动的偏移量，可以进一步配置该偏移量。
    • 锚点 - 描述光标相对于“ 偏移 X ”和“ 偏移 Y ”属性的偏移量的起点。 提供以下选项： “左上”、 “右上”、“ 左下”、“ 右下”和“ 居中”。 默认情况下，选择“ 居中 ”。
    • X 轴偏移 - 光标位置根据“ 锚点 ”字段中所选选项而进行的水平位移。 此字段仅支持 Int32 变量。
    • “Y 偏移 ” - 光标位置根据“ 锚点 ” 字段中所选选项而进行的垂直位移。 此字段仅支持 Int32 变量。
  • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
  • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
  • “模糊选取器 ” - 模糊选取器的参数。
  • 原生文本 - 用于标识用户界面元素的文本。
  • 响应式网站 - 启用响应式网站布局。
  • “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
  • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision
  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

• 输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
• 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。

其他

• “私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持 Boolean (True和 False) 值。 默认值为 False。

选项

• 滚动 次数 - 要滚动的次数，存储在 Int32 变量中。 如果将活动主体中的“ 滚动类型 ”设置为“目标 元素”，则此字段默认设置为 10。 如果设置为“ 距离”，则此字段默认设置为 5 。
• “方向” - 在“设计器”面板中查看 “方向 ”。

• 输入模式 - 选择机器人与目标应用程序交互时应使用的方法：

  • 与应用程序/浏览器 相同 - 使用与 使用应用程序/浏览器 活动相同的输入模式。

  • “硬件事件 ” - 使用硬件驱动程序执行操作。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。

  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。

• 修饰键 - 添加一个或多个修饰键以与活动的 Actions 结合使用。 提供以下选项：“ 无” 、“ Alt” 、“ Ctrl” 、“ Shift” 和 “Win”。 默认选项为“ 无”。

• “搜索的元素 ”- 要滚动到的指定用户界面元素。

  • “输出元素 ”- 在“ 输入元素 ”属性中搜索到的用户界面元素引用，您可以在其他用户界面自动化活动中使用该引用。
  • “目标 ”- 此用户界面元素具有自己的“ 目标 ”属性，该属性的配置方式与主属性相同。
  • “超时 ”- 等待搜索的元素出现的时间 (以秒为单位)。 默认值为 0.2 秒。

跨平台配置

• “在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。
• 滚动容器 - 滚动 整个页面 或在 元素内滚动。 默认选项为“ 整个页面”。
• 滚动方向 - 要执行的滚动方向。 提供以下选项： “左” 、 “上”、 “右”、 “下”。 默认选项为 “ 关闭”。
• 滚动类型 - 在此活动的两种使用方法之间进行选择：
  • “目标元素” - 滚动，直到在目标应用程序中找到指定的用户界面元素。 这是默认选项。
  • “距离 ” - 仅滚动“滚动 次数” 属性字段中指定的滚动距离。

• 在屏幕上指定搜索的元素 - 指定要滚动到的用户界面元素。 仅当从 滚动类型 下拉菜单中选择目标 元素 时，才会显示此选项。

  指定目标后，选择加号按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。

• 滚动 次数 - 滚动的次数。 仅当从“ 滚动类型 ”下拉菜单中选择“ 距离 ”时，才会显示此选项。

其他选项

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

输入/输出

• 输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。 此字段仅支持 UIElement 对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
• 输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。
• 输出搜索到的元素 - 搜索到的用户界面元素引用，以在其他活动中用作输入用户界面元素。 仅当从 滚动类型 下拉菜单中选择目标 元素 时，才会显示此选项。