鼠标滚动

UiPath.UIAutomationNext.Activities.NMouseScroll

描述

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

此活动必须添加到“使用应用程序/浏览器”活动中。

如要在“使用应用程序/浏览器”活动之外使用该活动，您需要提供一个“输入”元素。

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

备注：

如果未为此活动提供目标，则会自动使用包含它的作用域的目标。此外，由于此活动的性质，它不能用于后台模式。

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows 和跨平台配置

• 在作用域内工作- 当活动放置在嵌套式的“使用应用程序/浏览器”活动中时，选择呈现要自动化的应用程序的浏览器选项卡。
• “滚动容器” - 滚动整个页面或在“元素”中滚动。默认选项为“整个页面” 。
• 在屏幕上指定目标- 指定要在其中执行滚动的容器用户界面元素。仅当从“滚动容器”下拉菜单中选择“元素”选项时，此选项才会出现。指定目标后，选择加号按钮以访问以下选项：
  • “指定目标” - 再次指定目标。
  • “编辑目标” - 打开选择模式以配置目标。
• 滚动方向- 要执行滚动的方向。提供以下选项：左、上、右、下。默认选项为“向下” 。
• 滚动类型- 在此活动的两种使用方法之间选择：
  • 目标元素- 滚动，直到在目标应用程序中找到指定的用户界面元素。这是默认选项。
  • “距离” - 仅滚动“滚动次数”属性字段中指定的距离。
• “滚动次数” - 滚动的次数。仅当从“滚动类型”下拉菜单中选择“距离”时，此选项才会出现。

属性面板

目标

• “展开目标属性/折叠目标属性”按钮 - 显示/隐藏目标容器及其锚点属性。
• 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后，可将其设置为任意组合：
  • 精确选取器
  • 模糊选取器
  • 图像
  • 原生文本
  • Computer Vision
  • 语义选取器
• 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。
• 精确选取器- 为用户界面元素生成的精确选取器。
• Fuzzy selector - The parameters for the fuzzy selector.
• 图像准确性- 指示图像匹配的准确性级别。默认值为 0.8。
• 图像出现次数- 在找到多个匹配项时，指示要使用的特定出现次数。
• 原生文本- 用于标识用户界面元素的文本。
• 原生文本出现次数- 当找到多个匹配项时，指示要使用的特定出现次数。
• 原生文本区分大小写- 表示天气文本匹配区分大小写。
• CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
• CV 文本- 表示使用 Computer Vision 识别的文本。
• 计算机视觉文本准确性- 指示 OCR 文本匹配的准确性级别。默认值为 0.7。
• 计算机视觉文本出现次数- 表示在找到多个匹配项时要使用的特定出现次数。
• 语义选取器- 定义目标的语义描述。
• 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
  • “无”- 不等待目标变为就绪状态。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
• 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  • 无- 不检查可见性。
  • 交互式（用于模糊选取器）- 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  • 完全可见- 检查用户界面元素是否可见。
• 响应式网站- 启用响应式网站布局。
• “目标 - 偏移点” - 指定可以进一步配置的偏移量。
  • “锚点” - 描述光标从“偏移 X”和“偏移 Y”属性添加的偏移量的起点。提供以下选项： “左上” 、 “右上” 、 “左下” 、 “右下”和“居中” （默认选中）。
  • 偏移 X - 根据“锚点”字段中选择的选项对光标位置进行的水平位移。此字段仅支持Int32变量。
  • 偏移 Y - 光标位置根据“锚点”字段中选择的选项而进行的垂直位移。此字段仅支持Int32变量。

搜索的元素 - 目标

• “展开目标属性/折叠目标属性”按钮 - 显示/隐藏目标容器及其锚点属性。
• 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后，可将其设置为任意组合：
  • 精确选取器
  • 模糊选取器
  • 图像
  • 原生文本
  • Computer Vision
  • 语义选取器
• 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。
• 精确选取器- 为用户界面元素生成的精确选取器。
• Fuzzy selector - The parameters for the fuzzy selector.
• 图像准确性- 指示图像匹配的准确性级别。默认值为 0.8。
• 图像出现次数- 在找到多个匹配项时，指示要使用的特定出现次数。
• 原生文本- 用于标识用户界面元素的文本。
• 原生文本出现次数- 当找到多个匹配项时，指示要使用的特定出现次数。
• 原生文本区分大小写- 表示天气文本匹配区分大小写。
• CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
• CV 文本- 表示使用 Computer Vision 识别的文本。
• 计算机视觉文本准确性- 指示 OCR 文本匹配的准确性级别。默认值为 0.7。
• 计算机视觉文本出现次数- 表示在找到多个匹配项时要使用的特定出现次数。
• 语义选取器- 定义目标的语义描述。
• 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
  • “无”- 不等待目标变为就绪状态。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
• 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  • 无- 不检查可见性。
  • 交互式（用于模糊选取器）- 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  • 完全可见- 检查用户界面元素是否可见。
• 响应式网站- 启用响应式网站布局。

输入/输出

• “输入元素” - 要在其上执行活动的用户界面元素，存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。
• “输出元素” - 输出目标用户界面元素，并将其存储在UIElement对象中，该对象可进一步用于与其他活动针对同一元素。
• “输出搜索的元素” - 输出搜索的用户界面元素引用，并将其存储在UIElement对象中，以在其他活动中用作输入元素。
• 输入搜索到的元素- 指定用作搜索到的目标元素的现有用户界面元素引用。活动将滚动，直到该元素在屏幕上变得可见。

选项

• Input mode - Select which method the Robot should use to interact with the target application:
  • 与应用程序/浏览器相同- 使用与使用应用程序/浏览器活动相同的输入模式。
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • “ChromiumAPI” - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请参阅Chromium API 。
• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • 已禁用 - 关闭此活动的 Healing Agent。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
• “光标移动类型”- 指定鼠标光标执行的运动类型。有两个可用选项：
  • 即时- 光标跳至目标位置。这是默认选项。
  • “平滑” - 光标以渐进的方式移动。仅当使用“硬件事件”输入模式时，该设置才生效。
• 修饰键- 添加一个或多个修饰键，以与活动的操作结合使用。可用的选项如下：无、 Alt 、 Ctrl 、 Shift和Win 。默认选项为无。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 FALSE。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为 True，则无论出现何种错误，系统都将继续执行项目。

计时

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。
• 搜索元素超时- 指定每次滚动操作后等待元素显示的时间（以秒为单位）。如果滚动速度较慢或滚动动画，请使用较大的值。默认值为 0.2 秒。

Windows - 旧版配置

• 选择“菜单”按钮以访问以下选项：
  • Indicate target on screen - Indicate the target again.
  • “编辑目标” - 打开选择模式以配置目标。
  • 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。
• “方向” - 要执行滚动的方向。提供以下选项：左、上、右、下。默认选项为“向下” 。
• 滚动类型- 在此活动的两种使用方法之间选择：
  • 目标元素- 滚动，直到在目标应用程序中找到指定的用户界面元素。这是默认选项。
    备注：

    如果在“滚动类型”字段中选择“目标元素” ，则忽略滚动次数属性字段，并查找指定的用户界面元素。如果在运行时未找到指定的元素，则活动将滚动“滚动次数”字段中指定的尽可能多的内容，然后重试搜索指定的元素。系统会根据需要多次重复此行为，直到找到元素，并且在加载时间较长的应用程序中非常有用。

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

    The number of lines scrolled by a scroll movement is configured in the Mouse settings section in Windows. If scrolling to a specific element, the element is searched after all rotations are executed. Selecting this method also displays the # of scrolls property in the body of the activity.

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

属性面板

常见

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

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

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

• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

  重要提示：

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

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

  • 即时- 光标跳至目标位置。这是默认选项。
  • “平滑” - 光标以渐进的方式移动。仅当使用“硬件事件”输入模式时，该设置才生效。

• “目标” - 目标元素。必须设置目标元素。在屏幕上指示之前，此字段设置为(null) 。指定目标后，将显示与指定元素相关的所有属性。

  • 单击偏移量- 指定单击活动的偏移量，您可以进一步配置该偏移量。
    • “锚点” - 描述光标从“偏移 X”和“偏移 Y”属性添加的偏移量的起点。提供以下选项：左上、右上、左下、右下和中间。默认情况下，选择“中心” 。
    • 偏移 X - 根据“锚点”字段中选择的选项对光标位置进行的水平位移。此字段仅支持Int32变量。
    • 偏移 Y - 光标位置根据“锚点”字段中选择的选项而进行的垂直位移。此字段仅支持Int32变量。
  • CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
  • CV 文本- 表示使用 Computer Vision 识别的文本。
  • Fuzzy selector - The parameters for the fuzzy selector.
  • 原生文本- 用于标识用户界面元素的文本。
  • 响应式网站- 启用响应式网站布局。
  • 精确选取器- 为用户界面元素生成的精确选取器。
  • 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后，可将其设置为任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置” > “Computer Vision” ，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
    • 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高，既能适应用户界面的变更，又能在传统选取器失效时显着增强自动化弹性。
  • 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不检查可见性。
    • 交互式（用于模糊选取器）- 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见
      • 检查用户界面元素是否可见。
  • 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。

• “输入元素” - 要在其上执行活动的用户界面元素，存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。

• “输出元素” - 输出目标用户界面元素，并将其存储在UIElement对象中，该对象可进一步用于与其他活动针对同一元素。

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

• “滚动次数” - 滚动的次数，存储在Int32变量中。如果活动主体中的“滚动类型”设置为“目标元素” ，则默认情况下会设置此字段为10 。如果设置为距离，则默认情况下此字段的值为5 。

• “方向” - 在“设计器” 面板中查看“方向” 。

• Input mode - Select which method the Robot should use to interact with the target application:

  • 与应用程序/浏览器相同- 使用与使用应用程序/浏览器活动相同的输入模式。
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。

• 修饰键- 添加一个或多个修饰键，以与活动的操作结合使用。可用的选项如下：无、 Alt 、 Ctrl 、 Shift和Win 。默认选项为无。

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

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