单击 OCR 文本

UiPath.Core.Activities.ClickOCRText

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

重要提示：

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

属性

常见

• 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”，则系统在执行项目时不会捕获任何错误。

• “在此之后延迟”- 执行活动之后的延迟时间（以毫秒为单位）。默认时长为 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。默认选项为无。

  备注：

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

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