单击

UiPath.UIAutomationNext.Activities.NClick

描述

单击指定的用户界面元素，例如按钮或链接。 可以将其配置为使用任何鼠标键或双击，并且可以与修饰键结合使用。

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

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

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

项目兼容性

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之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

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

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

输入/输出元素

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

其他

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

选项

• 激活 - 将用户界面元素置于前台，并在单击前将其激活。 该字段仅支持“布尔值”（“True”、“ False”）。 默认值为 True。
• “更改禁用的元素 ” - 如果选中，即使禁用了指定的用户界面元素，活动也会执行 Actions 。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。

  如果输入模式属性设置为硬件事件，则此属性不适用。

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

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

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

    如果您更改以下任何属性的默认设置“ 单击类型”、“ 鼠标按钮”或 “修饰键”，则默认情况下会选择此选项。

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

    “模拟 ”只能与“ 单击 ”类型和“鼠标 左键” 选项一起使用。

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

    当使用 ChromiumAPI 启动浏览器时，将显示一个功能区，说明浏览器以调试模式启动。如果通过策略安装扩展程序，则不会显示此消息。

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

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

  按键修饰符不能与“ 模拟 ”输入模式一起使用。

跨平台配置

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

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

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

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

其他选项

计时

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

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

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

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

选项

• “单击类型 ” - 从下拉菜单中选择要执行的单击类型：“ 单击” 、“ 双击” 、 “向下” 或 “向上”。 默认选项为“ 单个”。
• “鼠标键 ” - 从下拉菜单中选择要单击的鼠标键： “左键”、“ 中键” 或 “右键”。 默认选项为 “左”。
• 修饰键 - 添加一个或多个修饰键以与单击结合使用。 可用的选项如下： Alt、 Ctrl、 Shift和 Win。

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

  • 与浏览器相同 - 用户使用父级 使用浏览器 活动中的 输入模式 设置。
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chrome 和 Edge 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。
  • Simulate - Simulates the click using accessibility APIs. Works for browsers. Sends all text in one go. This input method works in the background (even if the target app is not in focus).

输入/输出

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