单击图像

UiPath.Core.Activities.ClickImage

搜索用户界面元素中的图像，并单击该图像。

重要提示：

“ 双击图像”活动与“单击图像 ” 活动具有相同的功能，唯一的区别在于，“ 双击图像” 活动的“单击 类型”默认设置为“ CLICK_DOUBLE” ，而“ 单击图像” 活动的“单击 类型 ”默认设置为“ 单击“单击”。

属性

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 FALSE。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• 在此之后延迟 - 执行活动之后的延迟时间（以毫秒为单位）。默认时长为 300 毫秒。
• “延迟 之前” - 活动开始执行任何操作之前的延迟时间（以毫秒为单位）。 默认时间为 200 毫秒。
• “显示名称”- 活动的显示名称。

输入

• 单击类型 - 指定模拟“点击”事件时所使用的鼠标点击类型（单击、双击、向上滚动、向下滚动）。
• Image.Accuracy - 介于 0 到 1 的一种度量单位，表示您正在搜索的图像与要查找的图像之间的最低相似度。当要查找的图像与您正在搜索的图像略有不同时，此方法较为适用。默认值为 0.8。
• Image.Image - 待搜索的现有图像。此字段仅支持图像变量。
• Image.Profile - 用于更改要使用的图像检测算法。基础版是经典算法，速度和资源成本均适中。增强版可提供更精确的结果，但资源成本较高。默认情况下，该字段设为基础版。
• “鼠标 按钮” - 用于单击操作的鼠标按钮（左、右、中）。 默认情况下，鼠标左键处于选中状态。
• Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形（以像素为单位）：左、上、右、下。 它支持正数和负数。
• “目标.元素” - 使用另一个活动返回的用户界面元素变量。 此属性不能与“选取器”属性一起使用。 此字段仅支持用户界面元素变量。
• “目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。 它实际上是一个 XML 片段，用于指定您要查找的 GUI 元素及其某些父元素的属性。
• Target.Timeout（以毫秒为单位）- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出 SelectorNotFoundException 错误。默认值为 30000 毫秒（30 秒）。
• Target.WaitForReady - 在执行操作之前，等待目标准备就绪。默认情况下，选择交互/完成。可选择以下选项：
  • “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖于尚未加载的元素（例如脚本），则可能会产生不良后果。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• CursorPosition.OffsetX - 根据“位置”字段中的选定选项对光标位置进行的水平位移。
• CursorPosition.OffsetY - 根据“位置”字段中的选定选项对光标位置进行的垂直位移。
• CursorPosition.Position - 描述光标的起始点，向其添加“偏移 X”和“偏移 Y”属性的偏移量。提供以下选项：“左上”、“右上”、“左下”、“右下”和“中间”。默认选项为“中间”。
• “键修饰符” - 用于添加键修饰符。 提供以下选项：“ 无”、“ Alt”、“ Ctrl”、“ Shift”和“ Win”。 默认选项为“ 无”。
  备注： 密钥修饰符 不能与“ 发送窗口消息” 选项一起使用。 执行包含具有此选项组合的活动的工作流时，不会引发错误。
• 发送窗口消息 - 如果选中该复选框，则系统会向目标应用程序发送一条特定消息以执行悬停。这种输入方法速度更快，且可在后台工作。默认情况下，该复选框处于未选中状态。如果未选中该复选框，则默认方法通过使用硬件驱动程序执行点击。默认方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。

使用“单击图像”和“双击图像”活动的示例

您可以在包含多个活动的示例中查看如何使用“ 单击图像” 和“ 双击图像 ”活动。

您可在此处查看和下载该示例。