按键事件触发器

UiPath.UIAutomationNext.Activities.NKeyboardTrigger

描述

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

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

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

备注：

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

项目兼容性

Windows - 旧版 | 窗口

Windows - 旧版 Windows 配置

设计器面板

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

  指定目标后，选择“ 菜单” 按钮以访问以下选项：

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

属性面板

常见

• 显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。

输入

• 键 - 请在上方的“设计器”面板部分中查看详细信息。
• “目标 ” - 目标元素：顶层窗口或用户界面元素。 仅支持严格选取器，不支持锚点。 必须设置目标元素。 在屏幕上指定之前，此字段设置为 (null)。 指定目标后，将显示与指定元素相关的所有属性。
  • “严格选取器 ” - 为目标用户界面元素生成的“严格选取器”。 对于顶层窗口，该字段为空。
  • 窗口选取器 （应用程序实例）- 应用程序窗口（应用程序/浏览器）的选取器。

其他

• “已启用 ” - 如果设置为 False，则触发器将启动，但不会触发任何事件。 稍后可以在 Runtime 使用“ 启用本地触发器 ”活动启用它。 此字段仅支持 “布尔 值”。 默认值为 True。
• “私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持 Boolean (True和 False) 值。 默认值为 False。

选项

• 阻止事件 - 请参阅“ 设计器”面板中的 阻止事件 。
• 包含子项 - 请参阅在“设计器”面板中 包含子 项。
• 修饰键 - 请参阅“设计器”面板中的“修饰 键 ”。
• “计划模式 ”- 指定在触发触发器时如何执行 Actions 。 从下拉菜单中选择五个选项之一：
  • 顺序 - 依次执行操作。
  • 并发 - 操作执行可以重叠。
  • 一次性 - 执行一项操作并退出监控。
  • 按顺序折叠 - 忽略所有即将发生的事件（最新事件除外），直到当前事件完成执行。
  • 按顺序停止 - 停止执行上一个事件，并开始下一个事件。

  对于“ 顺序 ”和“ 并发 ”模式，监控将持续进行，直到用户停止执行或遇到 “中断” 活动。

• “触发模式 ” - 指定在按下或松开按键时是否触发事件。 从以下两个选项中选择一个： 向下 或 向上。 默认值为 “关闭”。