单击 OCR 文本

UiPath.Core.Activities.ClickOCRText

使用 OCR 技术在指定的用户界面元素或图像中搜索给定的字符串，并单击该字符串。默认情况下，使用UiPath 屏幕 OCR引擎。

重要提示：

“双击 OCR 文本”活动与“单击 OCR 文本”活动具有相同的功能，唯一的区别是，对于“双击 OCR 文本”活动，默认将“单击类型”设置为“单击\_双击” ，而对于“单击 OCR 文本”活动，默认情况下将“单击类型”设置为“双击”。单击类型的默认设置为CLICK\_SINGLE 。

属性

常见

• 出错时继续- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”（True、False）。默认值为False 。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为True ，则无论出现何种错误，系统都将继续执行项目。

  备注：

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

• “在此之后延迟”- 执行活动之后的延迟时间（以毫秒为单位）。默认时长为 300 毫秒。

• “在此之前延迟”- 活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认时长为 200 毫秒。

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

输入

• “单击类型”- 指定模拟“点击”事件时所使用的鼠标点击类型（单击、双击、向上滚动、向下滚动）。系统会默认选择单击。
• “鼠标键”- 用于执行点击操作的鼠标键（左键、右键和中键）。系统会默认选择鼠标左键。
• “出现次数”- 如果“文本”字段中的字符串在指定的用户界面元素中出现多次，则可在此处指定要单击的出现次数。例如，如果字符串出现了 4 次，而您想要单击第一次出现的字符串，则在该字段中写入 1。默认值为 1。
• “Target.ClippingRegion”- 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形（以像素为单位）。支持正数和负数。
• “Target.Element”- 使用另一个活动返回的“用户界面元素”变量。该属性不能与“选取器”属性一起使用。该字段仅支持用户界面元素变量。
• “Target.Selector”- 用于在执行活动时查找特定用户界面元素的“文本”属性。它实际上是 XML 片段，用于指定要查找的图形用户界面元素及其一些父元素的属性。
• “Target.Timeout(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出“SelectorNotFoundException”错误。默认值为 30000 毫秒（30 秒）。
• Target.WaitForReady - Before performing the actions, wait for the target to become ready. By default, Interactive/Complete is selected. The following options are available:
  • “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖尚未加载的元素（如脚本），这可能会产生不良后果。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
• 文本 - 要单击的字符串。 必须用引号将所有字符串括起。

其他

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

选项

• “CursorPosition.OffsetX”- 根据“位置”字段中的选定选项对光标位置进行的水平位移。

• “CursorPosition.OffsetY”- 根据“位置”字段中的选定选项对光标位置进行的垂直位移。

• CursorPosition.Position - 描述光标的起始点，向其添加“偏移 X”和“偏移 Y”属性的偏移量。提供以下选项：左上、右上、左下、右下和中间。默认选项为“居中” 。

• 可用的选项如下：无、Alt、Ctrl、Shift、Win。默认选项为无。

  备注：

  修饰键不能与“发送窗口消息”选项一起使用。执行包含具有此选项组合的活动的工作流时，不会引发错误。

• “发送窗口消息”- 如果选中该复选框，则系统会向目标应用程序发送一条特定消息以执行单击。这种输入方法速度更快，且可在后台工作。默认情况下，该复选框是未选中状态。如果未选中该复选框，则默认方法通过使用硬件驱动程序执行点击。默认方法速度更慢，且不能在后台工作，但可兼容所有桌面应用程序。