UiPath Documentation
activities
latest
false
重要 :
请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。

用户界面自动化活动

上次更新日期 2026年5月22日

键入

UiPath.Core.Activities.TypeInto

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

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

还支持粘滞键。例如,如果要键入 Shift+End 以仅选择控件的部分文本,则需要从特殊键列表中选择 ShiftEnd,建议的文本为 [k(Shift)][k(End)]。这将模拟按顺序按下 ShiftEnd 键。正确的文本为 [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 毫秒。

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

    备注:

    如果“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”- 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形(以像素为单位)。支持正数和负数。

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

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

  • 属性
  • 输入
  • 选项
  • 常见
  • 其他
  • “输入信息”活动使用示例

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新