键入

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)]。

备注：

This only works for the Default and SendWindowMessages options (see below).

选项

• 模拟键入- 如果选中，则通过使用目标应用程序的技术模拟类型。这种输入方法在三种方法中速度最快，且可在后台工作。默认情况下，该复选框处于未选中状态。如果既未选中该复选框，也未选中“发送窗口消息”复选框，则默认方法是通过使用硬件驱动程序执行击键。默认方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。如果选择此属性，建议在执行之前检查目标 UI 元素的状态。如需了解更多详情，请参阅此页面。

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

• “键之间延迟”- 两次击键之间的延迟时间（以毫秒为单位）。默认时长为 10 毫秒。最大值为 1000 毫秒。

• “键入前单击”- 选中该复选框后，系统会在写入文本之前单击指定用户界面元素。

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

  备注：

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

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

  备注：

  如未选中“激活”复选框，则活动将键入当前活动窗口。

• “如果禁用则更改”- 如果启用，则即使禁用了指定的用户界面元素，也会执行该操作。

常见

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

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

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

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

其他

• “私有”- 选中后将不再以“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”- 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形（以像素为单位）。支持正数和负数。

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

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