键入

在指定的用户界面元素中输入文本，例如文本框。 您还可以向用户界面元素发送特殊键（如 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)

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

TypeInto(
    TargetAnchorableModel target,
    string text)

target TargetAnchorableModel

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

text 字符串

要键入的文本。

TypeInto(TargetAnchorableModel, TypeIntoOptions)

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

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)

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

TypeInto(
    string target,
    string text)

target

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

text 字符串

要键入的文本。

TypeInto(String, TypeIntoOptions)

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

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中发送所有文本。 即使目标应用程序不在焦点中，也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。