用户界面自动化活动

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

查找文本位置

UiPath.Core.Activities.FindText

在用户界面元素中搜索给定字符串，并返回另一个用户界面元素，且该元素会将剪切区域设置为给定字符串所处的屏幕位置。

备注：

在需要将扩展程序自动化的浏览器（例如Chrome、Firefox和Edge ）中使用时，此活动无法正常运行。

属性

输入

“文本”- 正在搜索的字符串。

备注：
必须用引号将所有字符串括起。
“出现次数”- 如果“文本”字段中的字符串在指定的用户界面元素中出现多次，则可在此处指定要单击的出现次数。例如，如果字符串出现了 4 次，而您想要单击第一次出现的字符串，则在该字段中写入 1。默认值为 1。

输出

“用户界面元素”- 您查找的字符串所在的用户界面元素。该字段仅支持用户界面元素变量。

选项

“格式化文本”- 如果选中此复选框，则保留选定文本的屏幕布局。

其他

“私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
“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”，则系统在执行项目时不会捕获任何错误。