键入

UiPath.Core.Activities.TypeInto

将击键发送到用户界面元素。

支持特殊按键，且可以从下拉列表中选择。

还支持粘滞键。例如，如果要键入 Shift+End 以仅选择控件的部分文本，则需要从特殊键列表中选择 Shift 和 End，建议的文本为 [k(Shift)][k(End)]。这将模拟按顺序按下 Shift 和 End 键。正确的文本为 [d(Shift)][k(End)][u(Shift)]，其中 d 表示按键按下，k 表示按住按键，u 表示按键松开。

属性

输入

• 文本- 待写入指定用户界面元素的文本。支持特殊键，且可以从活动下拉列表中选择。

  也可以使用以下语法发送向下按键或向上发送按键：

  %[d(ctrl)] - 按下特定按钮；
  %[u(ctrl)] - 提起特定按钮。

例如，要发送 CTRL + V 组合键，您可以使用 %[d(ctrl)]v[u(ctrl)]。

注意： 这仅适用于“ 默认” 和 “发送窗口消息” 选项（见下文）。

选项

• 模拟键入- 如果选中，则通过使用目标应用程序的技术模拟类型。这种输入方法在三种方法中速度最快，且可在后台工作。默认情况下，该复选框处于未选中状态。如果既未选中该复选框，也未选中“发送窗口消息”复选框，则默认方法是通过使用硬件驱动程序执行击键。默认方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。如果选择此属性，建议在执行之前检查目标 UI 元素的状态。如需了解更多详情，请参阅此页面。
• 发送窗口消息 - 如果选中，则系统会向目标应用程序发送一条特定消息，以执行相应类型。这种输入方法可在后台工作，且兼容大多数桌面应用程序，但并不是速度最快的方法。默认情况下，该复选框是未选中状态。默认情况下，该复选框处于未选中状态。如果既未选中该复选框，也未选中“模拟类型”复选框，则默认方法通过使用硬件驱动程序模拟击键。默认方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。
• 键之间延迟 - 两次击键之间的延迟时间（以毫秒为单位）。默认时长为 10 毫秒。最大值为 1000 毫秒。
• 键入前单击 - 选中该复选框后，系统会在写入文本之前单击指定用户界面元素。

• 清空字段 - 选中该复选框后，则系统会在写入文本之前，将用户界面元素中的已有内容全部清除。

  注意：在网页环境中，字段默认清空。

• 激活- 选中该复选框后，系统会将指定用户界面元素置于前台，并在写入文本之前将其激活。

  注意：如未选中激活复选框，则活动将键入当前活动窗口。
• “如果禁用则更改”- 如果启用，则即使禁用了指定的用户界面元素，也会执行该操作。

常见

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

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

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

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• “目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。 它实际上是一个 XML 片段，用于指定您要查找的 GUI 元素及其某些父元素的属性。
• Target.TimeoutMS - 指定在引发 SelectorNotFoundException 错误之前等待活动运行的时间（以毫秒为单位）。 默认值为 30000 毫秒 (30 秒)。

• Target.WaitForReady - 在执行操作之前，请等待目标就绪。 提供以下选项：

  • “无”- 在执行操作之前，系统不会等待显示除目标用户界面元素之外的任何内容。例如，如果希望只从网页检索文本或单击特定按钮，则可以使用此选项，而不必等待用户界面元素全部加载。请注意，如果按钮依赖于尚未加载的元素（例如脚本），则可能会产生不良后果。

  • “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后，再实际执行操作。

    为了评估应用程序处于“交互”状态还是“完成”状态，系统将验证以下标签：

  • “桌面应用程序”- 系统会发出一条“wm_null”消息，以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在，则执行活动。
  • 网页应用程序：
  1. Internet Explorer - <webctrl> 标签用于检查 HTML 文档的就绪状态是否设为完成。此外，必须将忙碌状态设置为“False”。
  2. 其他 - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否为“完成”。
  • “SAP 应用程序”- 首先验证是否存在“<wnd>”标签，然后使用 SAP 特定 API 来检测会话是否繁忙。
• “目标.元素” - 使用另一个活动返回的用户界面元素变量。 此属性不能与“选取器”属性一起使用。 此字段仅支持用户界面元素变量。
• Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形（以像素为单位）：左、上、右、下。 它支持正数和负数。

“输入信息”活动使用示例

您 可以在此查看包含多个活动的示例，了解如何使用 输入 活动。