应用程序事件触发器

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

描述

根据任何类型元素（顶级窗口或任何其他指定的用户界面元素）的原生事件设置触发器。 您可以在屏幕上指定目标元素，然后从该元素支持的事件列表中选择原生事件。

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

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

备注：

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

项目兼容性

Windows - Legacy | Windows

Windows - 旧版 Windows 配置

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

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

• Indicate target on screen - Indicate the target again.
• “编辑目标” - 打开选择模式以配置目标。
• 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
• 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。

• 事件类型- 特定于指定元素的原生事件类型列表。必须设置事件类型 。公开的事件列表取决于目标元素类型和目标应用程序技术。例如，Web 用户界面元素可能会显示与 Java 用户界面元素不同的事件列表。

属性面板

常见

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

输入

• 匹配同步- 指示目标元素选取器的匹配是同步还是异步完成。仅适用于 Java 事件， “已出现”和“已消失”除外。此字段仅支持Boolean值。默认值为False 。

• “选取器” - 用于监控指定事件的可选选取器集合；这些选取器会与指定的目标一起受到监控。选取器必须是完整（非部分）选取器。

• “目标” - 目标元素：顶级窗口或用户界面元素。仅支持精确选取器，不支持锚点。必须设置目标元素。在屏幕上指示之前，此字段设置为(null) 。指定目标后，将显示与指定元素相关的所有属性。

  • 精确选取器- 为目标用户界面元素生成的精确选取器。对于顶级窗口，此字段为空。
  • 窗口选取器（应用程序实例）- 应用程序窗口（应用程序/浏览器）的选取器。

• 已启用- 如果设置为False ，则触发器将启动，但不会触发任何事件。稍后可以在运行时使用“启用本地触发器”活动启用它。将应用程序事件触发器活动位于触发器作用域中时，此属性隐藏。此字段仅支持Boolean True、False）值。默认值为True 。

• “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。此字段仅支持Boolean （ True ， False ）值。默认值为False 。

• 包括子元素- 如果选中，还会监控指定用户界面元素的子元素。它支持除“已出现”或“已消失”事件外的所有事件类型，以及除顶级窗口以外的任何用户界面元素。此字段仅支持Boolean （ True ， False ）值。默认值为False 。

• 计划模式- 指定在触发触发器时如何执行操作。从下拉菜单中选择以下五个选项之一：

  • 顺序 - 依次执行操作。
  • 并发 - 操作执行可以重叠。
  • 一次性 - 执行一项操作并退出监控。
  • 按顺序折叠 - 忽略所有即将发生的事件（最新事件除外），直到当前事件完成执行。
  • 顺序删除- 停止执行上一个事件并开始下一个事件。对于顺序和并发模式，系统将会继续监控，直到用户停止执行或遇到“中断”活动为止。

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。

  • 已禁用 - 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

原生事件

关于

通过实施不同类型的应用程序技术支持的新事件集，改进了原生事件监控机制：

• WND 原生事件
• CTRL 原生事件
• JAVA 原生事件
• WEBCTRL 原生事件
• HTML 原生事件
• UIA 原生事件

WND 事件 - 顶级窗口

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
已更改标题	已更改文本的参数	目标元素标题更改时触发的事件。 注意：这是“文本已更改”事件，为了更清楚，我们将顶级窗口的事件重命名为“标题已更改” 。
已更改状态	状态已更改的参数	目标元素的状态更改时触发的事件。 注意：当窗口的某些状态发生更改时，会触发此事件：“已启用”、“已禁用”、“选中”、“未选中”、可聚焦、聚焦、可见等。状态的新值在 arguments 变量中公开。
位置已更改	位置已更改参数	目标的元素位置更改时触发的事件。
已获取前景	HwndArgs	当目标的元素窗口变为前台窗口时触发的事件。
已丢失前台	HwndArgs	当目标的元素窗口不再位于前台时触发的事件。
最小化	HwndArgs	即将最小化目标的元素窗口时触发的事件。
还原	HwndArgs	即将恢复目标的元素窗口时触发的事件。

CTRL 或 WND 事件 - 用户界面元素

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
按下键	KeyPressArgs	在焦点位于目标元素内的情况下，按下某个键时触发的事件。
单击	MouseClickedArgs	单击目标元素时触发的事件。
更改文本	已更改文本的参数	目标元素的文本更改时触发的事件。
获得焦点	空参数	目标元素获得焦点时触发的事件。
焦点丢失	空参数	目标元素失去焦点时触发的事件。
已更改状态	状态已更改的参数	目标元素的状态更改时触发的事件。 注意：当窗口的某些状态发生更改时，会触发此事件：“已启用”、“已禁用”、“选中”、“未选中”、可聚焦、聚焦、可见等。状态的新值在 arguments 变量中公开。
所选内容已更改	所选内容已更改的参数	目标元素选择值更改时触发的事件。

JAVA 事件 - 用户界面元素

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
更改文本	已更改文本的参数	目标元素的文本更改时触发的事件。
按下键	Java 按键参数	在焦点位于目标元素内的情况下，按下某个键时触发的事件。
单击	Java 鼠标操作参数	单击目标元素时触发的事件。
鼠标移动	JavaMouseMotionArgs	将鼠标移到目标元素上时触发的事件。
获得焦点	空参数	目标元素获得焦点时触发的事件。
焦点丢失	空参数	目标元素失去焦点时触发的事件。
已启用	空参数	启用目标元素时触发的事件。
已禁用	空参数	禁用目标元素时触发的事件。
所选内容已更改	所选内容已更改的参数	目标元素选择值更改时触发的事件。
鼠标已进入	JavaMouseMotionArgs	当鼠标进入目标元素可见部分时触发的事件。
鼠标已退出	JavaMouseMotionArgs	当鼠标退出目标元素可见部分时触发的事件。
已选择单元格	Java 单元格选定参数	当目标元素是表格单元格并且被选中时触发的事件。
单元格值已更改	Java 单元格值已更改参数	当目标元素为表格单元格且其值发生更改时触发的事件。
已按下鼠标	Java 鼠标操作参数	在目标元素上按下任何鼠标键时触发的事件。
已释放鼠标	Java 鼠标操作参数	在目标元素上释放任何鼠标键时触发的事件。
已选择菜单	空参数	当目标元素是菜单并且被选中时触发的事件。
已取消选择菜单	空参数	当目标元素是菜单并且被取消选中时触发的事件。
已取消菜单	空参数	当目标元素是菜单并且被取消时触发的事件。
弹出式菜单可见	空参数	当目标元素是弹出式菜单并且可见时触发的事件。
弹出式菜单不可见	空参数	当目标元素是弹出式菜单并且不可见时触发的事件。
已取消弹出式菜单	空参数	当目标元素是弹出式菜单并且被取消时触发的事件。

WEBCTRL 事件 - 用户界面元素

备注：

从UiPath.UIAutomation.Activities v23.10.3 开始，我们添加了对以下活动的支持：* 原生嵌入式浏览器（例如 Slack、Discord、Electron）中基于 WEBCTRL 的原生事件。

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
更改文本	已更改文本的参数	目标元素的文本更改时触发的事件。
按下键	网页按键参数	在焦点位于目标元素内的情况下，按下某个键时触发的事件。
单击	网页鼠标事件参数	单击目标元素时触发的事件。
双击	网页鼠标事件参数	双击目标元素时触发的事件。
右击	网页鼠标事件参数	右键单击目标元素时触发的事件。
鼠标移动	网页鼠标事件参数	将鼠标移到目标元素上时触发的事件。
已按下鼠标	网页鼠标事件参数	在目标元素上按下任何鼠标键时触发的事件。
已释放鼠标	网页鼠标事件参数	在目标元素上释放任何鼠标键时触发的事件。
鼠标已进入	网页鼠标事件参数	当鼠标进入目标元素可见部分时触发的事件。
鼠标已退出	网页鼠标事件参数	当鼠标退出目标元素可见部分时触发的事件。
获得焦点	空参数	目标元素获得焦点时触发的事件。
焦点丢失	空参数	目标元素失去焦点时触发的事件。
文本选择已更改	WebTextSelectionChangedArgs	目标元素的选定文本更改时触发的事件。

HTML 事件 - 用户界面元素

备注：

以下事件类型仅支持由仅具有app属性的<html>选取器标识的网页应用程序：

• Download state changed
• Tab activated
• Tab created
• Tab removed
• Tab updated目前，仅当窗口选取器包含<html>部分（例如： <html app='chrome.exe' /> ）时才允许使用这些事件。不允许使用其他属性，例如title或url 。如果窗口选取器包含app以外的属性，则会生成运行时错误。精确选取器应为空。嵌入式浏览器不支持这些事件类型。

事件类型	触发器事件参数类型	描述
已更改下载状态	DownloadChangedArgs	DownloadItem 的属性更改时触发的事件。
已激活选项卡	TabActivatedArgs	窗口中的活动选项卡更改时触发的事件。 注意：触发此事件时可能未设置选项卡的 URL，但您可以侦听onUpdated事件，以便在设置 URL 时收到通知。
已创建选项卡	TabCreatedArgs	创建选项卡时触发的事件。 注意：触发此事件时，可能未设置选项卡的 URL 和选项卡组成员身份，但您可以侦听onUpdated事件，以便在设置 URL 或将选项卡添加到选项卡组时收到通知。
已删除选项卡	TabRemovedArgs	关闭选项卡时触发的事件。
已更新选项卡	TabUpdatedArgs	更新选项卡时触发的事件。
已开始选项卡导航	TabNavigationStartedArgs	启动指向特定 URL 的选项卡导航时触发的事件。
已完成选项卡导航	TabNavigationCompletedArgs	完成指向特定 URL 的选项卡导航时触发的事件。
窗口焦点已更改	HtmlWindowFocusChangedArgs	当前聚焦窗口更改时触发的事件。
窗口边界已更改	HtmlWindowBoundsChangedArgs	调整窗口大小时触发的事件。 仅在提交新边界时调度它，而不是在正在进行的更改时调度它。
窗口已创建	HtmlWindowCreatedArgs	创建窗口时触发的事件。
窗口已删除	HtmlWindowRemovedArgs	移除（关闭）窗口时触发的事件。
网页请求：重定向前	WebRequestBeforeRedirectArgs	即将发生服务器启动的重定向时触发的事件。
网页请求：请求前	WebRequestBeforeRequestArgs	即将发生请求时触发的事件。
网页请求：发送 HTTP 标头前	WebRequestBeforeSendHeadersArgs	在即将发生请求并且初始标头已准备就绪时触发的事件。该事件允许扩展程序添加、修改和删除请求标头。
网页请求：已完成	WebRequestCompletedArgs	成功处理网页请求后触发的事件。
网页请求：发生错误	WebRequestErrorOccurredArgs	无法成功处理网页请求时触发的事件。 网页请求 API 可保证对于每个请求，Completed 或 Error occurred 作为最终事件触发，但有一个例外。
网页请求：已收到 HTTP 标头	WebRequestHeadersReceivedArgs	每当收到 HTTP(S) 响应标头时触发的事件。由于重定向和身份验证请求，每个请求可能会触发多次。
网页请求：已开始响应	WebRequestResponseStartedArgs	收到响应正文的第一个字节时触发的事件。对于 HTTP 请求，这意味着状态行和响应标头可用。此事件用于提供信息，且已异步处理。不允许修改或取消请求。
网页请求：发送 HTTP 标头	WebRequestSendHeadersArgs	在所有扩展程序都有机会修改请求标头后触发的事件，并显示最终版本。在将标头发送到网络之前触发该事件。此事件用于提供信息，且已异步处理。不允许修改或取消请求。

UIA 事件 - 用户界面元素

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
按下键	KeyPressArgs	在焦点位于目标元素内的情况下，按下某个键时触发的事件。
单击	MouseClickedArgs	单击目标元素时触发的事件。
更改文本	已更改文本的参数	目标元素的文本更改时触发的事件。
文本选择已更改	UiaTextSelectionChangedArgs	目标元素的选定文本更改时触发的事件。
获得焦点	空参数	目标元素获得焦点时触发的事件。
焦点丢失	空参数	目标元素失去焦点时触发的事件。
已调用	空参数	调用目标元素时触发的事件。
Selected	所选内容已更改的参数	选定目标元素时触发的事件。
已取消选择	所选内容已更改的参数	取消选定目标元素时触发的事件。
已切换	UiaToggledArgs	切换目标元素时触发的事件。

触发器事件参数属性

触发器参数

与触发器相关的所有 args 类的基类。

属性	类型	描述
TriggerName	字符串	发出此事件的触发器活动的名称 (显示为活动名称)。
TriggerType	类型	发出此事件的触发器活动的 .NET 类型。

用户界面元素触发器参数

继承: TriggerArgs > UiElementTriggerArgs

属性	类型	描述
Selector	字符串	目标元素的选取器。
TargetElement	用户界面元素	受监控的目标元素。

NativeTriggerBaseArgs

继承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

属性	类型	描述
SelectorIndex	整数	目标元素选取器的索引。

空参数

从以下事件返回数据：

• 已出现
• 已消失
• 获得焦点
• 焦点丢失
• 已启用
• 已禁用
• 已选择菜单
• 已取消选择菜单
• 已取消菜单
• 弹出式菜单可见
• 弹出式菜单不可见
• 已取消弹出式菜单

继承: TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

从以下事件返回数据：

• 更改文本
• 已更改标题

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

属性	类型	描述
Text	字符串	目标元素的新文本。

状态已更改的参数

从以下事件返回数据：

• 已更改状态

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

属性	类型	描述
State	字符串	目标元素的新状态。

所选内容已更改的参数

从以下事件返回数据：

• 所选内容已更改

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

属性	类型	描述
Selection	字符串	目标元素的新选择。

位置已更改参数

从以下事件返回数据：

• 位置已更改

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs

属性	类型	描述
Location	矩形	已更改位置的矩形，其中包含有关元素大小及其位置的信息。

HwndArgs

从以下事件返回数据：

• 已获取前景
• 已丢失前台
• 最小化
• 还原

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

属性	类型	描述
Hwnd	整数点	窗口句柄。
HwndAsString	字符串	字符串形式的窗口句柄。

KeyPressArgs

从来自 WND 和 CTRL 元素的以下事件返回数据：

• 按下键

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs

属性	类型	描述
Key	整数	与之交互的键。
ScanCode	整数	与所交互的键对应的扫描码。
KeyAction	整数	0 - 已按下键 1 - 密钥已释放
KeyModifiers	任意键修饰符	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

MouseClickedArgs

从来自 WND 和 CTRL 元素的以下事件返回数据：

• 单击

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs

属性	类型	描述
X	整数	鼠标指针的 X 坐标。
Y	整数	鼠标指针的 Y 坐标。
MouseButton	整数	0 - 无 1 - 左侧 2 - 中间 3 - 右侧
MouseAction	整数	0 - 已按下鼠标键 1 - 鼠标键已释放
KeyModifiers	任意键修饰符	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

Java 按键参数

从以下 Java 事件返回数据：

• 按下键

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

属性	类型	描述
KeyChar	字符串	与按下的键对应的字符。
KeyCode	整数	与所按下的键对应的代码。
ExtendedKeyCode	整数	所按下键的扩展键代码。与KeyCode不同，此值取决于当前的键盘布局。
Location	字符串	发起事件的键的位置。
KeyModifiers	任意键修饰符	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

Java 鼠标操作参数

从以下 Java 事件返回数据：

• 单击
• 已按下鼠标
• 已释放鼠标

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

属性	类型	描述
X	整数	鼠标指针的 X 坐标。
Y	整数	鼠标指针的 Y 坐标。
Button	整数	1 - 左侧 2 - 中间 3 - 右侧
ClickCount	整数	按钮被单击的次数。
KeyModifiers	任意键修饰符	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaMouseMotionArgs

从以下 Java 事件返回数据：

• 鼠标移动
• 鼠标已进入
• 鼠标已退出

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

属性	类型	描述
X	整数	鼠标指针的 X 坐标。
Y	整数	鼠标指针的 Y 坐标。
MouseButton	整数	0 - 无 1 - 左侧 2 - 中间 3 - 右侧

Java 单元格选定参数

从以下 Java 事件返回数据：

• 单击

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

属性	类型	描述
Row	整数	选定的单元格行。
Column	整数	选定的单元格列。

Java 单元格值已更改参数

从以下 Java 事件返回数据：

• 单击

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

属性	类型	描述
Row	整数	单元格行。
Column	整数	单元格列。
Value	字符串	单元格的新值。

网页鼠标事件参数

从 WEBCTRL 的以下事件返回数据：

• 单击
• 双击
• 右击
• 鼠标移动
• 鼠标已进入
• 鼠标已退出
• 已按下鼠标
• 已释放鼠标

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

备注：

它遵循为鼠标事件定义的属性名称 。

属性	类型	描述
AltKey	布尔值	如果按下了 ALT 键。
Button	整数	0 - 左侧 1 - 中间 2 - 右侧
ClientX	整数	鼠标指针的 X 坐标（相对于窗口）。
ClientY	整数	鼠标指针的 Y 坐标（相对于窗口）。
CtrlKey	布尔值	如果按下了 CTRL 键。
MetaKey	布尔值	如果按下了 META 键。
MovementX	整数	鼠标指针的 X 坐标（相对于上一个 mousemove 事件的位置）。
MovementY	整数	鼠标指针的 Y 坐标（相对于上一个 mousemove 事件的位置）。
OffsetX	整数	鼠标指针的 X 坐标（相对于目标）。
OffsetY	整数	鼠标指针的 Y 坐标（相对于目标）。
PageX	整数	鼠标指针的 X 坐标（相对于文档）。
PageY	整数	鼠标指针的 Y 坐标（相对于文档）。
ScreenX	整数	鼠标指针的 X 坐标（相对于屏幕）。
ScreenY	整数	鼠标指针的 Y 坐标（相对于屏幕）。
ShiftKey	布尔值	如果按下了 SHIFT 键。

网页按键参数

从 WEBCTRL 的以下事件返回数据：

• 按下键

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

备注：

它采用为键盘事件定义的属性名称 。

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
已更改标题	已更改文本的参数	目标元素标题更改时触发的事件。 注意：这是“文本已更改”事件，为了更清楚，我们将顶级窗口的事件重命名为“标题已更改” 。
已更改状态	状态已更改的参数	目标元素的状态更改时触发的事件。 注意：当窗口的某些状态发生更改时，会触发此事件：“已启用”、“已禁用”、“选中”、“未选中”、可聚焦、聚焦、可见等。状态的新值在 arguments 变量中公开。
位置已更改	位置已更改参数	目标的元素位置更改时触发的事件。
已获取前景	HwndArgs	当目标的元素窗口变为前台窗口时触发的事件。
已丢失前台	HwndArgs	当目标的元素窗口不再位于前台时触发的事件。
最小化	HwndArgs	即将最小化目标的元素窗口时触发的事件。
还原	HwndArgs	即将恢复目标的元素窗口时触发的事件。

WebTextSelectionChangedArgs

从 WEBCTRL 的以下事件返回数据：

• 文本选择已更改

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

备注：

它采用为键盘事件定义的属性名称 。

属性	类型	描述
AnchorClientBounds	矩形	锚点客户端范围：有关元素大小及其相对于视口的位置的信息。
AnchorElement	用户界面元素	锚点用户界面元素。
AnchorOffset	整数	在其中开始文本选择（从目标元素的全文中开始）的从 0 开始索引字符。
FocusClientBounds	矩形	焦点客户端范围：有关元素大小及其相对于视口的位置的信息。
FocusElement	用户界面元素	焦点用户界面元素。
FocusOffset	整数	在其中结束文本选择（从目标元素的全文中开始）的从 0 开始索引字符。
SelectedText	字符串	目标元素的新文本选择。

DownloadChangedArgs

从 WEBCTRL 的以下事件返回数据：

• 已更改下载状态

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

属性	类型	描述
State	字符串	描述 downloads.DownloadItem 的 state 中更改的字符串。
Id	字符串	已更改的 downloads.DownloadItem 的 id。
FileName	字符串	描述 downloads.DownloadItem 的 url 中更改的字符串。
Url	字符串	描述 downloads.DownloadItem 的 filename 中更改的字符串。
StartTime	字符串	描述 downloads.DownloadItem 的 startTime 中更改的字符串。
EndTime	字符串	描述 downloads.DownloadItem 的 endTime 中更改的字符串。
Error	字符串	描述 downloads.DownloadItem 的 error 状态中更改的字符串。

TabActivatedArgs

从 WEBCTRL 的以下事件返回数据：

• 已激活选项卡

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

属性	类型	描述
TabId	字符串	已处于活动状态的选项卡 ID。
WindowId	字符串	所选选项卡更改后的窗口 ID。
Title	字符串	选项卡的新标题。
Url	字符串	选项卡的 URL（如果已更改）。

TabCreatedArgs

从 WEBCTRL 的以下事件返回数据：

• 已创建选项卡

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

属性	类型	描述
TabId	字符串	已创建的选项卡 ID。
WindowId	字符串	包含选项卡的窗口 ID。
Title	字符串	选项卡的新标题。
Url	字符串	选项卡的 URL。

TabRemovedArgs

从 WEBCTRL 的以下事件返回数据：

• 已删除选项卡

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

属性	类型	描述
TabId	字符串	已删除的选项卡 ID。
WindowId	字符串	其选项卡已关闭的窗口 ID。
IsWindowClosing	布尔值	True 何时关闭选项卡，因为其父窗口已关闭。

TabUpdatedArgs

从 WEBCTRL 的以下事件返回数据：

• 已更新选项卡

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

属性	类型	描述
TabId	字符串	已更新的选项卡 ID。
WindowId	字符串	包含选项卡的窗口 ID。
Status	字符串	选项卡的加载状态。
Title	字符串	选项卡的新标题。
Url	字符串	选项卡的 URL（如果已更改）。
Active	布尔值	选项卡在其窗口中是否处于活动状态。不一定意味着窗口已获得焦点。

TabNavigationStartedArgs

从以下 HTML 事件返回数据：

• 已开始选项卡导航

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

属性	类型	描述
Url	字符串	当前与框架关联的 URL（如果FrameId标识的框架曾在给定选项卡中存在过）。 URL 与给定的FrameId相关联，并不意味着相应的框架仍然存在。
TabId	整数	框架所在的选项卡的 ID。
FrameId	整数	选项卡中触发已开始事件，从而导致选项卡导航的框架的 ID。框架由其TabId和FrameId唯一标识。
TimeStampMs	Double	选项卡导航开始的时间，以自历元开始的毫秒数为单位。网页导航的事件TimeStampMs属性仅保证内部一致。将一个事件与另一个事件进行比较，可以获得它们之间的正确偏移量，但将它们与扩展程序内的当前时间（例如，通过(new Date()).getTime() ）进行比较可能会给出意外结果。
DateTime	日期	选项卡导航开始的日期和时间 (UTC)。

TabNavigationCompletedArgs

从以下 HTML 事件返回数据：

• 已完成选项卡导航

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

属性	类型	描述
Url	字符串	当前与此框架关联的 URL（如果FrameId标识的框架曾在给定选项卡中存在过）。 URL 与给定的FrameId相关联，并不意味着相应的框架仍然存在。
TabId	整数	框架所在的选项卡 ID。
FrameId	整数	选项卡中触发完成事件，从而导致选项卡导航的框架的 ID。框架由其TabId和FrameId唯一标识。
TimeStampMs	Double	选项卡导航完成的时间，自历元开始以毫秒为单位。网页导航的事件TimeStampMs属性仅保证内部一致。将一个事件与另一个事件进行比较，可以获得它们之间的正确偏移量，但将它们与扩展程序内的当前时间（例如，通过(new Date()).getTime() ）进行比较可能会给出意外结果。
DateTime	日期	选项卡导航完成的日期和时间 (UTC)。

HtmlWindowFocusChangedArgs

从以下 HTML 事件返回数据：

• 窗口焦点已更改

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

属性	类型	描述
TabId	字符串	新聚焦的选项卡的 ID。
WindowId	字符串	包含选项卡的窗口 ID。
Title	字符串	选项卡的标题。
Url	字符串	选项卡的 URL（如果已更改）。

HtmlWindowBoundsChangedArgs

从以下 HTML 事件返回数据：

• 窗口边界已更改

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

属性	类型	描述
WindowId	字符串	边界已更改的窗口的 ID。
Focused	布尔值	窗口当前是否为焦点窗口。
Top	整数	窗口相对于屏幕上边缘的偏移量 (以像素为单位)。
Left	整数	窗口相对于屏幕左边缘的偏移量 (以像素为单位)。
Width	整数	窗口的宽度 (包括框架), 以像素为单位。
Height	整数	窗口高度，包括框架，以像素为单位。

HtmlWindowCreatedArgs

从以下 HTML 事件返回数据：

• 窗口已创建

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

属性	类型	描述
WindowId	字符串	已创建的窗口 ID。

HtmlWindowRemovedArgs

从以下 HTML 事件返回数据：

• 窗口已删除

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

属性	类型	描述
WindowId	字符串	已删除的窗口 ID。

WebRequestBaseArgs

适用于 HTML 的网页请求事件 args 的基类。

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs

属性	类型	描述
FrameId	字符串	发出请求的框架的 ID。
Initiator	字符串	发起请求的源。
Method	字符串	标准 HTTP 方法。
ParentFrameId	字符串	包含发送请求的框架的框架的 ID。
RequestId	字符串	请求的 ID。
TabId	字符串	发生请求的选项卡的 ID。
TimeStamp	字符串	触发此信号的时间，自历元开始计算，以毫秒为单位。
Type	字符串	将如何使用所请求的资源。
Url	字符串	URL。

WebRequestHeadersReceivedArgs

从以下 HTML 事件返回数据：

• 网页请求：已收到 HTTP 标头

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs

属性	类型	描述
ResponseHeaders	字符串	与此响应一起收到的 HTTP 响应标头。
StatusCode	字符串	服务器返回的标准 HTTP 状态代码。
StatusLine	字符串	响应的 HTTP 状态行。

WebResponseCacheDetailsArgs

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs

属性	类型	描述
FromCache	布尔值	表示此响应是否从磁盘缓存中获取。
Ip	字符串	发送请求时，请求实际到达的服务器 IP 地址。

WebRequestBeforeRedirectArgs

从以下 HTML 事件返回数据：

• 网页请求：重定向前

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebResponseCacheDetailsArgs > WebRequestBeforeRedirectArgs

属性	类型	描述
RedirectUrl	字符串	重定向 URL。

WebRequestBeforeRequestArgs

从以下 HTML 事件返回数据：

• 网页请求：请求前

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeRequestArgs

WebRequestBeforeSendHeadersArgs

从以下 HTML 事件返回数据：

• 网页请求：发送 HTTP 标头前

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeSendHeadersArgs

属性	类型	描述
RequestHeaders	字符串	将与此请求一起发送出的 HTTP 请求标头。

WebRequestCompletedArgs

从以下 HTML 事件返回数据：

• 网页请求：已完成

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestCompletedArgs

WebRequestErrorOccurredArgs

从以下 HTML 事件返回数据：

• 网页请求：发生错误

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestErrorOccurredArgs

属性	类型	描述
Error	字符串	错误说明。
FromCache	布尔值	表示此响应是否从磁盘缓存中获取。
Ip	字符串	发送请求时，请求实际到达的服务器 IP 地址。

WebRequestResponseStartedArgs

从以下 HTML 事件返回数据：

• 网页请求：已开始响应

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs → WebRequestHeadersReceivedArgs → WebResponseCacheDetailsArgs → WebRequestResponseStartedArgs

WebRequestSendHeadersArgs

从以下 HTML 事件返回数据：

• 网页请求：发送 HTTP 标头

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestSendHeadersArgs

属性	类型	描述
RequestHeaders	字符串	将与此请求一起发送出的 HTTP 请求标头。

UiaToggledArgs

从 UIA 的以下事件返回数据：

• 已切换的事件

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

属性	类型	描述
State	字符串	目标元素的新状态。

UiaTextSelectionChangedArgs

从 UIA 的以下事件返回数据：

• 文本选择更改事件

继承顺序：TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

事件类型	触发器事件参数类型	描述
已出现	空参数	目标元素出现时触发的事件。
已消失	空参数	目标元素消失时触发的事件。
已更改标题	已更改文本的参数	目标元素标题更改时触发的事件。 注意：这是“文本已更改”事件，为了更清楚，我们将顶级窗口的事件重命名为“标题已更改” 。
已更改状态	状态已更改的参数	目标元素的状态更改时触发的事件。 注意：当窗口的某些状态发生更改时，会触发此事件：“已启用”、“已禁用”、“选中”、“未选中”、可聚焦、聚焦、可见等。状态的新值在 arguments 变量中公开。
位置已更改	位置已更改参数	目标的元素位置更改时触发的事件。
已获取前景	HwndArgs	当目标的元素窗口变为前台窗口时触发的事件。
已丢失前台	HwndArgs	当目标的元素窗口不再位于前台时触发的事件。
最小化	HwndArgs	即将最小化目标的元素窗口时触发的事件。
还原	HwndArgs	即将恢复目标的元素窗口时触发的事件。

事件检查工具

在基于触发器的 Attended 自动化的上下文中，事件检查工具可用于识别与应用程序中的某些用户界面元素交互时触发的原生事件的类型，然后可用于配置“应用程序事件触发器”活动。该工具可捕获并监控所有选定的事件类型，例如单击、按键、获得焦点、失去焦点和其他相关交互，使您能够分析执行的操作，并在适用时诊断问题。

选择有效的用户界面元素后，通过单击“检查事件”工具栏按钮，即可从“UI Explorer”打开事件检查工具。

工具栏包含以下选项：

• 记录 - 记录通过与用户界面元素交互而生成的事件并将其添加到事件列表中。
• 暂停 - 不再记录与用户界面元素交互时生成的事件。
• 高亮显示 - 显示目标元素的轮廓，并将其置于前台几秒钟。一直高亮显示，直到禁用为止。
• 在 UI Explorer 中打开 - 在 UI Explorer 中打开受监控的元素，您可以在其中观察该元素的选取器。

开始事件记录后，还有两个选项可用：

• 清除 - 删除所有记录的事件。
• CSV - 可以将捕获的事件导出到.csv文件中以进行进一步分析。

“事件检查工具”窗口分为两个主要部分：

• 事件筛选器 - 允许选择您想要监视目标元素的事件类型。
• 事件列表 - 显示有关已捕获事件的信息。

您可以通过启用或禁用事件类型列表中的复选框来筛选要捕获的事件类型。该列表可能因所选元素技术而异。

默认情况下，禁用特定于 Web 或 Java 用户界面元素的所有鼠标事件类型（ “鼠标” 、 “已按下鼠标” 、 “已释放鼠标” 、 “鼠标已进入”、 “鼠标已退出”），因为在这种情况下，事件列表可能会变得非常大。我们的建议是，仅在您有监控鼠标事件类型的特定需求时才启用它们。

还值得一提的是，即使在开始事件记录之后，也可以启用或禁用事件类型。

事件列表包含三列：

• 事件名称 - 事件类型。
• 时间戳 - 执行事件时的日期和时间（小时）。
• 事件数据 - 特定事件的关联数据和参数。

每一列都可以按升序或降序排序。默认情况下，事件按执行顺序显示。

找到“消失”类型事件后，您将无法再继续监控，并且屏幕上会显示错误消息。单击工具栏中的任何选项时，屏幕上都会显示相同的错误消息。唯一可用的选项是清除数据或将其导出为.csv文件。要再次开始监控，请关闭窗口并打开事件检查工具的另一个实例 。