存在文本

UiPath.Core.Activities.TextExists

检查是否在给定的用户界面元素中查找到文本。

备注：

在需要将扩展程序自动化的浏览器（如 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”- 定义相对于用户界面元素的剪切矩形。

输出

• “存在”- 指明文本是否存在。该字段仅支持“布尔值”变量。

常见

• “显示名称”- 活动的显示名称。