用户界面自动化活动

上次更新日期 2026年1月14日

在图像消失时

UiPath.Core.Activities.OnImageVanish

此容器会等待图像消失，并可用于执行其他活动。

属性

输入

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

常见

“显示名称”- 活动的显示名称。
ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

备注：
如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

选项

无限重复- 指定活动是否持续监控事件。该字段仅支持“布尔值”（True 和 False）。True
- 每次出现指定图像时，都执行该块；这是默认值。False - 该活动仅执行一次。

其他

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

使用“在图像消失时”活动的示例

“在图像消失时”活动会检查网站中的特定图像何时消失。此活动用于验证来自网站的流程，并可用作自动化流程的触发器。

为了举例说明如何使用此活动，我们创建了一个示例，该示例对所选网站执行速度测试，并为其分配特定的性能等级。自动化流程将打开浏览器，并验证图像何时消失。这表示测试已开始。第二个“在图像消失时”活动会检查测试是否完成。

此自动化流程的构建方法如下：

打开 Studio ，创建一个新“流程”。
将“序列”活动拖动至“工作流设计器”。
- 创建以下变量：
  
  变量名称变量类型默认值
  website 字符串
将“输入对话框”活动拖动到“序列”容器内。
- 在“属性”面板中，向“标签”字段添加“"Insert Website URL"”表达式。
- 在“标题”字段中添加表达式“"Website"”。
- 在“结果”字段中添加 website 变量。
在“输入对话框”活动下方放置一个“打开浏览器”活动。
- 在“URL”字段中添加表达式 "https://tools.pingdom.com"。
- 在“属性”字段中，从“浏览器类型”下拉列表中选择“IE”选项。
- 选中“新会话”选项的复选框。这会启动所选浏览器的新会话。
将“输入”活动拖动到“打开浏览器”活动的“执行”容器内。
- 在“属性”面板中，从“目标”下拉列表中选择“Target”选项。
- 在“选取器”字段中添加表达式“"<webctrl id='urlInput' tag='INPUT' />"”。
- 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
- 在“文本”字段中添加“website”变量。
- 选中“激活”选项的复选框。这会将浏览器置于前台，并在写入文本前将其激活。
在“输入”活动下方放置“单击”活动。
- 在“属性”面板中，向“在此之后延迟”字段添加“1000”值。
- 在“单击类型”下拉列表中选择“CLICK_SINGLE”选项。
- 从“鼠标按键”下拉列表中选择“BTN_LEFT”选项。
- 在“目标”下拉列表中选择“Target”选项。
- 在“选取器”字段中添加表达式“"<webctrl tag='INPUT' type='submit' />"”。
- 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
- 在“光标位置”下拉列表中选择“CursorPosition”选项。
- 在“位置”下拉列表中选择“Center”选项。
- 从“修饰键”下拉列表中选择“None”选项。
将“延迟”活动拖动到“单击”活动下方。
- 在“属性”面板中，向“持续时间”字段添加“00:00:02”值。这会导致活动间出现两秒延迟。
将“在图像消失时”活动放置在“延迟”活动下方。
- 在“属性”面板中，从“图像”下拉列表中选择 ImageTarget 选项。
- 在“准确度”字段中添加值“0.8”。
- 从“配置文件”下拉列表中选择“Basic”选项。
- 在“目标”下拉列表中选择“Target”选项。
- 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
- 在“一直重复”字段中添加值“False”。
将新的“在图像消失时”活动拖动到上一个“在图像消失时”活动的“执行”容器中。
- 在“属性”面板中，从“图像”下拉列表中选择 ImageTarget 选项。
  - 在“准确度”字段中添加值“0.8”。
  - 从“配置文件”下拉列表中选择“Basic”选项。
  - 在“目标”下拉列表中选择“Target”选项。
  - 在“选取器”字段中添加表达式“"<webctrl id='speedometer' tag='svg' />"”。
  - 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
  - 在“一直重复”字段中添加值“False”。
- 选择最后一个“在图像消失时”活动的“执行”容器，并创建以下变量：
  
  变量名称变量类型默认值
  grade 字符串
将“获取文本”活动拖动至“执行”容器中。
- 在“属性”面板中，从“目标”下拉列表中选择“Target”选项。
- 在“选取器”字段中添加表达式“"<html title='Pingdom Tools' /><webctrl parentname='Performance grade' tag='app-grade-badge' />"”。这将从网站检索性能等级，并将其值存储在变量 grade 中。
- 从“等待就绪”下拉列表中选择“INTERACTIVE”选项。
- 在“值”字段中添加变量 grade。
将“消息框”活动放置在“获取文本”活动下方。
- 在“属性”面板中，从“按钮”下拉列表中选择“Ok”选项。
- 在“文本”字段中添加表达式 "Performance Grade is " + grade。这将显示您提供的网站收到的分数。
- 选中“排名最前”选项的复选框。这会将消息框置于前台。
运行流程。机器人会要求您输入网站地址，打开新的浏览器，访问www.pingdom.com网站，验证您添加的地址的性能，并返回一个包含性能等级的消息框。