用户界面自动化活动

上次更新日期 2025年11月12日

按键事件触发器

UiPath.UIAutomationNext.Activities.NKeyboardTrigger

描述

在指定的用户界面元素上设置按键事件触发器。

此活动可与对象存储库兼容。

触发器必须是工作流中的第一个活动，并且在发生特定用户界面事件时触发工作流。每个工作流仅支持一个触发器。有关更多详细信息，请查看基于触发器的 Attended 自动化。

备注：

如果您使用的 Studio 版本低于 2023.4，您需要将“ 应用程序事件触发器 ”活动放置在“ 触发器作用域 ”活动中。在这种情况下，“ 按键事件触发器 ”活动不会显示“ 计划模式 ”和“已启用 ”属性，并且“ 计划模式 ”属性在“ 触发器作用域 ”活动中可用。

项目兼容性

Windows - 旧版 | 窗口

Windows - 旧版 Windows 配置

单击 “在屏幕上指定目标” ，指定要用作目标的用户界面元素。

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
修饰键 - 将修饰键（无、 Win、 Ctrl、 Alt、 Shift）添加到要监控的按键序列。
Special Keys - Setup a key-pressed event trigger on the indicated UI element.
“阻止事件 ”- 指定是否阻止事件作用于指定元素。如果为 False，则对该元素执行该元素。如果为 True，则系统会阻止事件，并且稍后可以在活动处理程序中使用“ 重播用户事件 ”活动将“ 事件信息 ”属性设置为 TriggerEventArgs.Event 作为要重播的事件来重播。此字段仅支持 “布尔 值”。默认值为 False。
“包含子元素”- 如果“ Actions”针对任何子元素，则触发事件。选中后，还会监控指定用户界面元素的子元素。此字段仅支持 “布尔 值”。默认值为 True。

属性面板

输入

“密钥 ” - 受监控的密钥。支持特殊键，您可以从下拉菜单中选择它们。必须设置密钥。

选项

“已启用 ” - 如果设置为 False，则触发器将启动，但不会触发任何事件。稍后可以在 Runtime 使用“ 启用本地触发器 ”活动启用它。此字段仅支持 “布尔 值”。默认值为 True。

“计划模式 ”- 指定在触发触发器时如何执行 Actions 。从下拉菜单中选择五个选项之一：
- 顺序 - 依次执行操作。
- 并发 - 操作执行可以重叠。
- 一次性 - 执行一项操作并退出监控。
- 按顺序折叠 - 忽略所有即将发生的事件（最新事件除外），直到当前事件完成执行。
- 按顺序停止 - 停止执行上一个事件，并开始下一个事件。
对于“ 顺序 ”和“ 并发 ”模式，监控将持续进行，直到用户停止执行或遇到 “中断” 活动。

“触发模式 ” - 指定在按下或松开按键时是否触发事件。从以下两个选项中选择一个：向下或向上。默认值为 “关闭”。
Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
- 已禁用- 关闭此活动的 Healing Agent。
- 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
- “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
- 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。