activities

latest

false

重要 :

请注意此内容已使用机器翻译进行了部分本地化。新发布内容的本地化可能需要 1-2 周的时间才能完成。

用户界面自动化活动

上次更新日期 2024年12月4日

应用程序事件触发器

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

描述

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

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

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

备注：

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

项目兼容性

Windows - 旧版 | 窗口

Windows - 旧版 Windows 配置

设计器面板

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

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
事件类型 - 特定于指定元素的原生事件类型列表。必须设置事件类型。公开的事件列表取决于目标元素类型和目标应用程序技术。例如，网页用户界面元素公开的事件列表可能与 Java 用户界面元素不同。

属性面板

常见

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

输入

匹配同步 - 指示目标元素选取器的匹配是同步还是异步完成。仅适用于 Java 事件，但“ 出现 ”和 “消失”除外。此字段仅支持 Boolean 值。默认值为 False。
选取器- 用于监控指定事件的可选选取器集合；这些选取器会与指定的目标一起受到监控。选取器必须是完整（非部分）选取器。

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

其他

“已启用 ” - 如果设置为 False，则触发器将启动，但不会触发任何事件。稍后可以在 Runtime使用 “ 启用本地触发器 ”活动将其启用。当“ 应用程序事件触发器 ”活动置于“ 触发器作用域”内时，此属性会隐藏。此字段仅支持 Boolean 值。默认值为 True。
“私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。此字段仅支持 Boolean (True和 False) 值。默认值为 False。

选项

“包括子 元素” - 选中后，还会监控指定用户界面元素的子元素。它支持除“ 出现 ”或 “消失” 之外的所有事件类型，以及除顶级窗口以外的任何用户界面元素。此字段仅支持 Boolean (True和 False) 值。默认值为 False。
“计划模式 ”- 指定在触发触发器时如何执行 Actions 。从下拉菜单中选择五个选项之一：
- 顺序 - 依次执行操作。
- 并发 - 操作执行可以重叠。
- 一次性 - 执行一项操作并退出监控。
- 按顺序折叠 - 忽略所有即将发生的事件（最新事件除外），直到当前事件完成执行。
- 按顺序停止 - 停止执行上一个事件，并开始下一个事件。
对于“ 顺序 ”和“ 并发 ”模式，监控将持续进行，直到用户停止执行或遇到 “中断” 活动。

原生事件

关于

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

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

WND 事件 - 顶级窗口

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

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

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

JAVA 事件 - 用户界面元素

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

WEBCTRL 事件 - 用户界面元素

备注：

从UiPath.UIAutomation.Activities v23.10.3 开始，我们添加了对以下内容的支持：

原生嵌入式浏览器中基于 WEBCTRL 的原生事件（如 Slack、Discord 和 Electron）。

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

HTML 事件 - 用户界面元素

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

已更改下载状态
已激活选项卡
已创建选项卡
已删除选项卡
已更新选项卡

目前，仅当窗口选取器包含 <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

注意：它遵循为键盘事件定义的属性名称。

属性	类型	描述
`AltKey`	布尔值	如果按下了 ALT 键。
`Code`	字符串	触发事件的键的代码（例如 `KeyA`、`KeyB`、`ControlLeft` 和 `ControlRight`）。
`CtrlKey`	布尔值	如果按下了 CTRL 键。
`IsComposing`	布尔值	事件的状态是否为正在撰写。
`Key`	字符串	触发事件的键的值（例如 `a`、`b`、`Control`）。
`Location`	整数	键盘或设备上的按键位置。可能的值： `0` - 标准 - 几乎代表键盘上的每个键 `1` - 已按下左键 `2` - 已按下右键 `3` - 在数字小键盘上按下了该键
`MetaKey`	布尔值	如果按下了 META 键。
`Repeat`	布尔值	是否重复按住某个键。
`ShiftKey`	布尔值	如果按下了 SHIFT 键。

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

属性	类型	描述
`TextRanges`	UiaTextRange()	数组，用于保存有关目标元素中所选文本元素的不同信息（如果是非相邻文本选择，我们可以选择多个文本元素）。此数组中的每个项目都会公开以下信息： “ `Text` ”（键入“ `String` ”）- 所选文本元素的文本。示例： `TriggerEventArgs.TextRanges(0).Text`表示第一个选定文本元素的文本。 `BoundingRectangles` （类型`Rectangle())` - 所选文本元素的边框数组。如果选定的文本元素跨越多行，则可以有多个关联的边框。每个边框的类型均为`Rectangle` {`X` , `Y` , `Width` , `Height`}，并且提供有关元素位置和大小的信息。示例： `TriggerEventArgs.TextRanges(0).BoundingRectangles(0)`表示第一个选定文本元素中第一行的边框。

事件检查工具

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

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