用户界面自动化活动

上次更新日期 2025年3月25日

键入

在指定的用户界面元素中输入文本，例如文本框。您还可以向用户界面元素发送特殊键（如 Tab 或 Enter）。

如果要安全地输入敏感信息，请在此 API 之前添加“获取凭据” API，然后选择该 API 中保存以备后用的用户名和密码值作为要键入的文本。

此 API 必须在“打开” 或“附加”之后添加。

定义

命名空间：UiPath.UIAutomationNext.API.Models

程序集：UiPath.UIAutomationNext.API.Models（在 UiPath.UIAutomationNext.API.Models dll 中）

重载

重载	描述
`TypeInto(TargetAnchorableModel, String)`	在指定的用户界面元素中输入文本，该文本标识为对象存储库中的字符串。
`TypeInto(TargetAnchorableModel, TypeIntoOptions)`	在指定的用户界面元素中输入文本，该元素标识为 `TargetAnchorableModel` 对象。
`TypeInto(String, String)`	在指定的用户界面元素中输入文本，该文本标识为对象存储库中的字符串。
`TypeInto(String, TypeIntoOptions)`	在指定的用户界面元素中输入文本（标识为对象存储库中的字符串）以及其他配置。

`TypeInto(TargetAnchorableModel, String)`

在指定的用户界面元素中输入文本，该文本标识为对象存储库中的字符串。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]TypeInto(
    TargetAnchorableModel target,
    string text)

target TargetAnchorableModel: 目标用户界面元素，标识为 TargetAnchorableModel 对象。
text 字符串: 要键入的文本。

`TypeInto(TargetAnchorableModel, TypeIntoOptions)`

在指定的用户界面元素中输入文本，该元素标识为 TargetAnchorableModel 对象。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]TypeInto(
    TargetAnchorableModel target,
    TypeIntoOptions typeIntoOptions)

target TargetAnchorableModel

目标用户界面元素，标识为 TargetAnchorableModel 对象。

typeIntoOptions TypeIntoOptions

可用的选项如下：

Text String - 要输入的文本。
“DelayBetweenKeys Double ”- 连续击键之间的延迟（以秒为单位）。默认值为 0.02 秒。
ActivateBefore Boolean - 如果为 true，则系统会将指定的用户界面元素置于前台，并在输入文本之前将其激活。如果为 false，则 API 将在当前活动窗口中键入内容。
ClickBeforeMode NClickMode - 在输入输入之前要执行的点击类型：
- 无
- 单个
- Double
“EmptyFieldMode NEmptyFieldMode”-
选择是否在键入文本之前删除字段中的现有内容，以及如何清空字段。通过发送击键组合来清空字段，击键组合在单行字段和多行字段之间有所不同。请务必根据指定的字段选择正确的选项。选项包括：
- 无
- SingleLine
- MultiLine
DeselectAfter Boolean - 仅当 InteractionMode 设置为 Simulate时才能使用。某些目标应用程序不会注册类型“ Actions ”，除非“ 完成”事件也与“ Actions”一起发送。将此设置为 true 会在文本输入后添加一个完成事件，以便正确注册 Actions 。如果将其设置为 false，则不会将完成事件发送到目标应用程序。默认情况下，这设置为 true。
AlterIfDisabled Boolean - 如果设置为 true，则即使禁用指定的用户界面元素，也会执行选择项目 Actions 。如果 InteractionMode 设置为 Hardware Events，则此参数不适用。默认情况下为 false。
InteractionMode NChildInteractionMode - 指定用于执行 Actions的 API。提供以下选项：
- SameAsCard - 使用与“ 打开 ”或“ 附加”相同的输入模式。这是默认选择。
- HardwareEvents - 使用硬件驱动程序执行 Actions。这是最慢的 API，不能在后台工作，但可兼容所有桌面应用程序。
- Simulate - 使用辅助功能 API 模拟 Actions 。建议在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。
- DebuggerApi - 使用调试器 API 执行 Actions 。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
- WindowMessages - 通过 Win32 消息发送鼠标和键盘输入。推荐用于桌面应用程序。通常比硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。

`TypeInto(String, String)`

在指定的用户界面元素中输入文本，该文本标识为对象存储库中的字符串。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]TypeInto(
    string target,
    string text)

target: 要在其中键入内容的目标用户界面元素，在对象存储库中标识为字符串。
text 字符串: 要键入的文本。

`TypeInto(String, TypeIntoOptions)`

在指定的用户界面元素中输入文本（标识为对象存储库中的字符串）以及其他配置。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]TypeInto(
    string target,
    TypeIntoOptions typeIntoOptions)

target

要在其中键入内容的目标用户界面元素，在对象存储库中标识为字符串。

typeIntoOptions TypeIntoOptions

可用的选项如下：

Text String - 要输入的文本。
“DelayBetweenKeys Double ”- 连续击键之间的延迟（以秒为单位）。默认值为 0.02 秒。
ActivateBefore Boolean - 如果为 true，则系统会将指定的用户界面元素置于前台，并在输入文本之前将其激活。如果为 false，则 API 将在当前活动窗口中键入内容。
ClickBeforeMode NClickMode - 在输入输入之前要执行的点击类型：
- 无
- 单个
- Double
“EmptyFieldMode NEmptyFieldMode”-
选择是否在键入文本之前删除字段中的现有内容，以及如何清空字段。通过发送击键组合来清空字段，击键组合在单行字段和多行字段之间有所不同。请务必根据指定的字段选择正确的选项。选项包括：
- 无
- SingleLine
- MultiLine
DeselectAfter Boolean - 仅当 InteractionMode 设置为 Simulate时才能使用。某些目标应用程序不会注册类型“ Actions ”，除非“ 完成”事件也与“ Actions”一起发送。将此设置为 true 会在文本输入后添加一个完成事件，以便正确注册 Actions 。如果将其设置为 false，则不会将完成事件发送到目标应用程序。默认情况下，这设置为 true。
AlterIfDisabled Boolean - 如果设置为 true，则即使禁用指定的用户界面元素，也会执行选择项目 Actions 。如果 InteractionMode 设置为 Hardware Events，则此参数不适用。默认情况下为 false。
InteractionMode NChildInteractionMode - 指定用于执行 Actions的 API。提供以下选项：
- SameAsCard - 使用与“ 打开 ”或“ 附加”相同的输入模式。这是默认选择。
- HardwareEvents - 使用硬件驱动程序执行 Actions。这是最慢的 API，不能在后台工作，但可兼容所有桌面应用程序。
- Simulate - 使用辅助功能 API 模拟 Actions 。建议在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。
- DebuggerApi - 使用调试器 API 执行 Actions 。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
- WindowMessages - 通过 Win32 消息发送鼠标和键盘输入。推荐用于桌面应用程序。通常比硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。