悬停

UiPath.UIAutomationNext.Activities.NHover

描述

将鼠标悬停在指定用户界面元素上方。

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 单击 “在应用程序/浏览器 中指定”，以指定要用作目标的用户界面元素。

  指定目标后，选择“ 菜单” 按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 添加验证/删除验证- 在活动卡中添加或删除“在屏幕上指定验证目标”功能。 默认情况下，验证执行处于启用状态。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
• 持续时间 - 悬停指定用户界面元素的持续时间 (以秒为单位)。 您可以从下拉菜单 中 选择一个预定值 ：1、3、5。默认值为 1 秒。 或者，也可以单击“ 加号”图标， 按钮，然后使用菜单中的某个选项输入持续时间。
• 在屏幕上指定验证目标 - 指定要用作目标的用户界面元素，以及在执行操作后应显示或消失的用户界面元素。当您要确保在运行时正确执行活动所执行的特定操作时，请使用此功能。这在自动化流程中特别有用，因为您需要确认特定用户界面元素由于操作而显示或消失。它增加了额外的验证层，以确保流程按预期运行。因此，如果您的自动化流程取决于某些步骤的正确执行，您可能需要验证执行情况。可以从“项目设置”或从活动主体中选择“添加验证”来启用此功能。

属性面板

常见

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

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

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

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

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

输入

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

  • 即时 - 光标跳至目标位置。 这是默认选项。
  • “平滑 ” - 光标以增量方式移动。 仅当使用 硬件事件 输入模式时，该设置才有效。
• “目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前，此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。
  • 单击偏移量 - 指定单击活动的偏移量，可以进一步配置该偏移量。
    • 锚点 - 描述光标相对于“ 偏移 X ”和“ 偏移 Y ”属性的偏移量的起点。 提供以下选项： “左上”、 “右上”、“ 左下”、“ 右下”和“ 居中”。 默认情况下，选择“ 居中 ”。
    • X 轴偏移 - 光标位置根据“ 锚点 ”字段中所选选项而进行的水平位移。 此字段仅支持 Int32 变量。
    • “Y 偏移 ” - 光标位置根据“ 锚点 ” 字段中所选选项而进行的垂直位移。 此字段仅支持 Int32 变量。
  • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
  • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
  • “模糊选取器 ” - 模糊选取器的参数。
  • 原生文本 - 用于标识用户界面元素的文本。
  • 响应式网站 - 启用响应式网站布局。
  • “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
  • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。

      将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。

  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

• 验证执行 - 在运行时，验证活动执行的操作是否正确。这是通过指定应在执行操作后出现或消失的元素来完成的，该元素在活动执行后受到监控和验证。通过从上下文菜单中选择添加验证，可以从项目设置或每个活动的主体中启用此功能。

  • “显示名称 ”- 验证 Actions的显示名称。 此字段会根据您选择的验证 Actions 和元素自动填充。 设置“ 验证执行 ”后，此显示名称将在活动卡中可见。
  • “重试 ” - 选中后，如果系统未获得预期结果，则将在活动超时的持续时间内重试 Actions 。 默认情况下，该复选框处于选中状态。
  • “目标 ”- 此目标用于指示要在 Runtime验证的元素。 有关可在此属性下展开的属性字段的更多信息，请参阅上面的 目标 属性，因为属性的功能是相同的。
  • “超时 ”- 等待验证元素出现、消失或更改的时间 (以秒为单位)。 如果选中“ 重试 ”复选框，则会在活动的“ 超时 ”属性中指定的持续时间内再次执行 Actions ，然后进行验证。默认值为 10 秒。
  • 验证元素 - 定义要检查验证目标的更改。 可用选项包括：
    • “出现 ” - 检查元素是否出现。
    • “消失” - 检查元素是否消失。
    • “已更改文本” - 检查元素文本是否有任何更改。
    • 已更改外观 - 检查元素的图像是否发生更改。

输入/输出元素

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

其他

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

选项

• 持续时间 - 在“设计器”面板中查看“ 持续时间 ”。

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

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

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

  • 模拟 - 使用辅助功能 API 进行模拟。 推荐用于浏览器、基于 Java 的应用程序、SAP。 通常比 硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中，也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。

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

  • 窗口消息 - 使用 Win32 消息进行模拟。 推荐用于桌面应用程序。 通常比 硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中，也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。

跨平台配置

• “在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。

• 在屏幕上指定目标 - 指定要用作目标的用户界面元素。

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

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
• 持续时间 - 悬停在用户界面元素上的持续时间 (以秒为单位)。 默认持续时间为 1 秒。

其他选项

计时

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

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

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

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

选项

• 单击偏移 - 打开切换按钮可启用用于执行单击的偏移值。 默认值为目标的中心。
  • 锚点 - 描述光标相对于“偏移 X”和“偏移 Y”属性的偏移量的起点。 提供以下选项： “左上”、 “右上”、“ 左下”、“ 右下”和“ 居中”。 默认情况下，选择“ 居中 ”。
  • X 轴偏移 - 光标位置根据“ 锚点 ”字段中所选选项而进行的水平位移。
  • “Y 偏移 ” - 光标位置根据“ 锚点 ” 字段中所选选项而进行的垂直位移。

输入/输出

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