用户界面自动化活动

上次更新日期 2024年12月4日

存在图像

UiPath.Core.Activities.ImageFound

检查是否在指定用户界面元素中查找到图像。

属性

输入

Image.Image - 待搜索的现有图像。此字段仅支持图像变量。
Image.Accuracy - 介于 0 到 1 的一种度量单位，表示您正在搜索的图像与要查找的图像之间的最低相似度。当要查找的图像与您正在搜索的图像略有不同时，此方法较为适用。默认值为 0.8。
Image.Profile - 用于更改要使用的图像检测算法。基础版是经典算法，速度和资源成本均适中。增强版可提供更精确的结果，但资源成本较高。默认情况下，该字段设为基础版。
“目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。它实际上是一个 XML 片段，用于指定您要查找的 GUI 元素及其某些父元素的属性。
Target.TimeoutMS - 指定在引发 SelectorNotFoundException 错误之前等待活动运行的时间（以毫秒为单位）。默认值为 30000 毫秒 (30 秒)。
Target.WaitForReady - 在执行操作之前，请等待目标就绪。提供以下选项：
- “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖于尚未加载的元素（例如脚本），则可能会产生不良后果。
- “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后，再实际执行操作。
  
  为了评估应用程序处于“交互”状态还是“完成”状态，系统将验证以下标签：
- “桌面应用程序”- 系统会发出一条“wm_null”消息，以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在，则执行活动。
- 网页应用程序：
1. Internet Explorer - <webctrl> 标签用于检查 HTML 文档的就绪状态是否设为完成。此外，必须将忙碌状态设置为“False”。
2. 其他 - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否为“完成”。
- “SAP 应用程序”- 首先验证是否存在“<wnd>”标签，然后使用 SAP 特定 API 来检测会话是否繁忙。
“目标.元素” - 使用另一个活动返回的用户界面元素变量。此属性不能与“选取器”属性一起使用。此字段仅支持用户界面元素变量。
Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形（以像素为单位）：左、上、右、下。它支持正数和负数。