发送热键

UiPath.Core.Activities.SendHotkey

向用户界面元素发送键盘快捷方式。

属性

选项

• “修饰键”- 用于添加修饰键。可用的选项如下：Alt、Ctrl、Shift、Win。

  备注：

  修饰键不能与“发送窗口消息”选项一起使用。执行包含具有此选项组合的活动的工作流时，不会引发错误。

• “特殊键”- 指明是否在键盘快捷方式中使用了特殊键。“键”下拉列表中提供了所有可用的特殊键清单。

• “发送窗口消息”- 如果选中该复选框，则系统会向目标应用程序发送一条特定消息以执行热键。这种输入方法速度更快，且可在后台工作。默认情况下，该复选框是未选中状态。如果未选中该复选框，则默认方法通过使用硬件驱动程序执行点击。默认方法速度更慢，且不能在后台工作，但可兼容所有桌面应用程序。

• “键之间延迟”- 两次击键之间的延迟时间（以毫秒为单位）。默认时长为 10 毫秒。最大值为 1000 毫秒。

• “键入前单击”- 选中该复选框后，系统会在写入文本之前单击指定用户界面元素。

• “清空字段”- 选中该复选框后，则系统会在写入文本之前，将用户界面元素中的已有内容全部清除。

• “激活”- 选中该复选框后，系统会将指定用户界面元素置于前台，并在写入文本之前将其激活。

输入

• “键”- 组成已发送热键的按键或按键组合。该字段仅支持字符串和“String”变量。

  备注：

  从 v2018.3 开始，“键”属性便接受“String”变量作为输入，可用于在自动化项目中为最常用的热键创建变量，并将这些变量直接用作此属性字段的输入，从而加快创建流程。

常见

• “显示名称”- 活动的显示名称。

• “延迟(毫秒)”- 执行活动之后的延迟时间（以毫秒为单位）。默认时长为 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”- 按照左、上、右、下四个方向定义相对于用户界面元素的剪切矩形（以像素为单位）。支持正数和负数。

使用“发送热键”活动的示例

您可以在此查看包含多个活动的示例，了解如何使用发送热键活动。