- 概述
- 用户界面自动化
- 通过用户界面自动化实现自动化的应用程序和技术
- UI-ANA-016 - 拉取打开浏览器 URL
- UI-ANA-017 - 出错时继续 True
- UI-ANA-018 - 列出 OCR/图像活动
- UI-DBP-006 - 容器使用情况
- UI-DBP-013 - Excel 自动化误用
- UI-DBP-030 - 选取器中的禁止变量使用情况
- ST-DBP-021 - 硬编码超时
- UI-PRR-001 - 模拟单击
- UI-PRR-002 - 模拟键入
- UI-PRR-003 - 打开应用程序误用
- UI-PRR-004 - 硬编码延迟
- UI-REL-001 - 选取器中的大 IDX
- UI-SEC-004 - 选取器电子邮件数据
- UI-SEC-010 - 应用程序/Url 限制
- UI-USG-011 - 不允许的属性
- SY-USG-013 - 私有文件调用
- SY-USG-014 - 执行模板占位符不正确
- UiPath 浏览器迁移工具
- 计算机视觉录制器
- 激活
- 锚点基准
- 附加浏览器
- 附加窗口
- 阻止用户输入
- 调用事务
- 标注
- 选中
- 单击
- 单击图像
- 单击图像触发器
- 单击 OCR 文本
- 单击屏幕上的图片
- 单击文本
- 单击工具栏按钮
- 单击触发器
- 关闭应用程序
- 关闭选项卡
- 关闭窗口
- 上下文感知锚点
- 复制选定文本
- 元素属性更改触发器
- 存在元素
- 元素作用域
- 元素状态更改触发器
- 展开 ALV 层次结构表格
- 展开 ALV 树
- 展开树
- 导出用户界面树
- 提取结构化数据
- 查找子元素
- 查找元素
- 查找图像
- 查找图像匹配项
- 查找 OCR 文本位置
- 查找相对元素
- 查找文本位置
- 获取活动窗口
- 获取上级
- 获取属性
- 获取事件信息
- 从剪贴板获取
- 获取全文
- 获取 OCR 文本
- 获取密码
- 获取位置
- 获取源元素
- 获取文本
- 获取可见文本
- 返回
- 前往
- 转至主页
- Google Cloud Vision OCR
- 隐藏窗口
- 高亮显示
- 热键触发器
- 悬停
- 悬停在图像上方
- 悬停在 OCR 文本上方
- 悬停文本
- 存在图像
- 在屏幕上指定
- 注入 .NET 代码
- 注入 JS 脚本
- 调用 ActiveX 方法
- 按键触发器
- 加载图像
- 最大化窗口
- Microsoft Azure 计算机视觉 OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- 最小化窗口
- 监控事件
- 鼠标触发器
- 移动窗口
- 导航至
- 存在 OCR 文本
- 在元素出现时
- 在元素消失时
- 在图像出现时
- 在图像消失时
- 打开应用程序
- 打开浏览器
- 读取状态栏
- 刷新浏览器
- 重播用户事件
- 还原窗口
- SAP 登录
- SAP 登录
- SAP 会话属性更改触发器
- 保存图像
- 在日历中选择日期
- 选择项目
- 选择菜单项
- 选择多个项目
- 发送热键
- 设置剪切区域
- 设置焦点
- 设置文本
- 设置为剪贴板
- 设置网页属性
- 显示窗口
- 启动进程
- 系统触发器
- 表格单元范围
- 截取屏幕截图
- Tesseract OCR
- 存在文本
- 工具提示
- 键入
- 输入安全文本
- 使用前台
- 等待属性
- 等待元素消失
- 等待图像消失
- Computer Vision Local Server
- 移动自动化
- 终端
应用程序事件触发器
UiPath.UIAutomationNext.Activities.NNativeEventTrigger
根据任何类型元素(顶级窗口或任何其他指定的用户界面元素)的原生事件设置触发器。 您可以在屏幕上指定目标元素,然后从该元素支持的事件列表中选择原生事件。
此活动可与对象存储库兼容。
触发器必须是工作流中的第一个活动,并且在发生特定用户界面事件时触发工作流。 每个工作流仅支持一个触发器。 有关更多详细信息,请查看基于触发器的 Attended 自动化。
如果您使用的 Studio 版本低于 2023.4, 您需要将“应用程序事件触发器”活动放置在“触发器作用域”活动中。 在这种情况下,“应用程序事件触发器”活动不显示“计划模式”和“已启用”属性,并且“计划模式”属性在“触发器作用域”活动中可用。
设计器面板
-
单击 “在屏幕上指定目标” ,指定要用作目标的用户界面元素。
指定目标后,选择“ 菜单” 按钮以访问以下选项:
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中,以便在整个自动化流程中重复使用该元素。
-
事件类型 - 特定于指定元素的原生事件类型列表。 必须设置事件类型。 公开的事件列表取决于目标元素类型和目标应用程序技术。 例如,网页用户界面元素公开的事件列表可能与 Java 用户界面元素不同。
属性面板
常见
-
显示名称- 设计器面板中活动的显示名称指定目标时,系统会自动生成显示名称。
输入
-
匹配同步 - 指示目标元素选取器的匹配是同步还是异步完成。 仅适用于 Java 事件,但“ 出现 ”和 “消失”除外。 此字段仅支持
Boolean
值。 默认值为 False。 - 选取器- 用于监控指定事件的可选选取器集合;这些选取器会与指定的目标一起受到监控。 选取器必须是完整(非部分)选取器。
-
“目标 ” - 目标元素:顶层窗口或用户界面元素。 仅支持严格选取器,不支持锚点。 必须设置目标元素。 在屏幕上指定之前,此字段设置为
(null)
。 指定目标后,将显示与指定元素相关的所有属性。- “严格选取器 ” - 为目标用户界面元素生成的“严格选取器”。 对于顶层窗口,该字段为空。
- 窗口选取器 (应用程序实例)- 应用程序窗口(应用程序/浏览器)的选取器。
其他
-
“已启用”- 如果设置为False ,则触发器将启动,但不会触发任何事件。 稍后可以在运行时使用“启用本地触发器”活动将其启用。 将“应用程序事件触发器”活动放置在“触发器作用域”中时,此属性隐藏。 此字段仅支持
Boolean
值。 默认值为True 。 - “私有” - 如果选中,则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持
Boolean
(True和 False) 值。 默认值为 False。
选项
-
“包括子 元素” - 选中后,还会监控指定用户界面元素的子元素。 它支持除“ 出现 ”或 “消失” 之外的所有事件类型,以及除顶级窗口以外的任何用户界面元素。 此字段仅支持
Boolean
(True和 False) 值。 默认值为 False。 - “计划模式 ”- 指定在触发触发器时如何执行 Actions 。 从下拉菜单中选择五个选项之一:
- 顺序 - 依次执行操作。
- 并发 - 操作执行可以重叠。
- 一次性 - 执行一项操作并退出监控。
- 按顺序折叠 - 忽略所有即将发生的事件(最新事件除外),直到当前事件完成执行。
- 按顺序停止 - 停止执行上一个事件,并开始下一个事件。
对于“ 顺序 ”和“ 并发 ”模式,监控将持续进行,直到用户停止执行或遇到 “中断” 活动。
事件类型 |
触发器事件参数类型 | 描述 |
---|---|---|
已出现 | 空参数 | 目标元素出现时触发的事件。 |
已消失 | 空参数 | 目标元素消失时触发的事件。 |
已更改标题 | 已更改文本的参数 |
目标元素标题更改时触发的事件。
注意: 为了更清楚起见,我们已将这是一个已 更改文本 事件重命名为已 更改顶层窗口的标题 。
|
已更改状态 | 状态已更改的参数 | 目标元素的状态更改时触发的事件。
注意: 窗口状态发生更改时会触发此事件: 已启用、已禁用、已选中、未选中、可聚焦、已聚焦、可见等。 状态的新值显示在参数变量中。
|
位置已更改 | 位置已更改参数 | 目标的元素位置更改时触发的事件。 |
已获取前景 | HwndArgs | 当目标的元素窗口变为前台窗口时触发的事件。 |
已丢失前台 | HwndArgs | 当目标的元素窗口不再位于前台时触发的事件。 |
最小化 | HwndArgs | 即将最小化目标的元素窗口时触发的事件。 |
还原 | HwndArgs | 即将恢复目标的元素窗口时触发的事件。 |
事件类型 | 触发器事件参数类型 | 描述 |
---|---|---|
已出现 | 空参数 | 目标元素出现时触发的事件。 |
已消失 | 空参数 | 目标元素消失时触发的事件。 |
更改文本 | 已更改文本的参数 | 目标元素的文本更改时触发的事件。 |
获得焦点 | 空参数 | 目标元素获得焦点时触发的事件。 |
焦点丢失 | 空参数 | 目标元素失去焦点时触发的事件。 |
已更改状态 | 状态已更改的参数 | 目标元素的状态更改时触发的事件。
注意: 窗口状态发生更改时会触发此事件: 已启用、已禁用、已选中、未选中、可聚焦、已聚焦、可见等。 状态的新值显示在参数变量中。
|
所选内容已更改 | 所选内容已更改的参数 | 目标元素选择值更改时触发的事件。 |
事件类型 | 触发器事件参数类型 | 描述 |
---|---|---|
已出现 | 空参数 | 目标元素出现时触发的事件。 |
已消失 | 空参数 | 目标元素消失时触发的事件。 |
更改文本 | 已更改文本的参数 | 目标元素的文本更改时触发的事件。 |
按下键 | Java 按键参数 | 在焦点位于目标元素内的情况下,按下某个键时触发的事件。 |
单击 | Java 鼠标操作参数 | 单击目标元素时触发的事件。 |
鼠标移动 | JavaMouseMotionArgs | 将鼠标移到目标元素上时触发的事件。 |
获得焦点 | 空参数 | 目标元素获得焦点时触发的事件。 |
焦点丢失 | 空参数 | 目标元素失去焦点时触发的事件。 |
已启用 | 空参数 | 启用目标元素时触发的事件。 |
已禁用 | 空参数 | 禁用目标元素时触发的事件。 |
所选内容已更改 | 所选内容已更改的参数 | 目标元素选择值更改时触发的事件。 |
鼠标已进入 | JavaMouseMotionArgs | 当鼠标进入目标元素可见部分时触发的事件。 |
鼠标已退出 | JavaMouseMotionArgs | 当鼠标退出目标元素可见部分时触发的事件。 |
已选择单元格 | Java 单元格选定参数 | 当目标元素是表格单元格并且被选中时触发的事件。 |
单元格值已更改 | Java 单元格值已更改参数 | 当目标元素为表格单元格且其值发生更改时触发的事件。 |
已按下鼠标 | Java 鼠标操作参数 | 在目标元素上按下任何鼠标键时触发的事件。 |
已释放鼠标 | Java 鼠标操作参数 | 在目标元素上释放任何鼠标键时触发的事件。 |
已选择菜单 | 空参数 | 当目标元素是菜单并且被选中时触发的事件。 |
已取消选择菜单 | 空参数 | 当目标元素是菜单并且被取消选中时触发的事件。 |
已取消菜单 | 空参数 | 当目标元素是菜单并且被取消时触发的事件。 |
弹出式菜单可见 | 空参数 | 当目标元素是弹出式菜单并且可见时触发的事件。 |
弹出式菜单不可见 | 空参数 | 当目标元素是弹出式菜单并且不可见时触发的事件。 |
已取消弹出式菜单 | 空参数 | 当目标元素是弹出式菜单并且被取消时触发的事件。 |
从 UiPath.UIAutomation.Activities v23.12 开始,我们在托管的嵌入式浏览器(例如 CefSharp)中增加了对基于 WEBCTRL 的原生事件的支持。
Text selection changed
事件。
事件类型 | 触发器事件参数类型 | 描述 |
---|---|---|
已出现 | 空参数 | 目标元素出现时触发的事件。 |
已消失 | 空参数 | 目标元素消失时触发的事件。 |
更改文本 | 已更改文本的参数 | 目标元素的文本更改时触发的事件。 |
按下键 | 网页按键参数 | 在焦点位于目标元素内的情况下,按下某个键时触发的事件。 |
单击 | 网页鼠标事件参数 | 单击目标元素时触发的事件。 |
双击 | 网页鼠标事件参数 | 双击目标元素时触发的事件。 |
右击 | 网页鼠标事件参数 | 右键单击目标元素时触发的事件。 |
鼠标移动 | 网页鼠标事件参数 | 将鼠标移到目标元素上时触发的事件。 |
已按下鼠标 | 网页鼠标事件参数 | 在目标元素上按下任何鼠标键时触发的事件。 |
已释放鼠标 | 网页鼠标事件参数 | 在目标元素上释放任何鼠标键时触发的事件。 |
鼠标已进入 | 网页鼠标事件参数 | 当鼠标进入目标元素可见部分时触发的事件。 |
鼠标已退出 | 网页鼠标事件参数 | 当鼠标退出目标元素可见部分时触发的事件。 |
获得焦点 | 空参数 | 目标元素获得焦点时触发的事件。 |
焦点丢失 | 空参数 | 目标元素失去焦点时触发的事件。 |
文本选择已更改 | WebTextSelectionChangedArgs | 目标元素的选定文本更改时触发的事件。 |
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 | 移除(关闭)窗口时触发的事件。 |
事件类型 | 触发器事件参数类型 | 描述 |
---|---|---|
已出现 | 空参数 | 目标元素出现时触发的事件。 |
已消失 | 空参数 | 目标元素消失时触发的事件。 |
更改文本 | 已更改文本的参数 | 目标元素的文本更改时触发的事件。 |
文本选择已更改 | UiaTextSelectionChangedArgs | 目标元素的选定文本更改时触发的事件。 |
获得焦点 | 空参数 | 目标元素获得焦点时触发的事件。 |
焦点丢失 | 空参数 | 目标元素失去焦点时触发的事件。 |
已调用 | 空参数 | 调用目标元素时触发的事件。 |
Selected | 所选内容已更改的参数 | 选定目标元素时触发的事件。 |
已取消选择 | 所选内容已更改的参数 | 取消选定目标元素时触发的事件。 |
已切换 | UiaToggledArgs | 切换目标元素时触发的事件。 |
触发器参数
args
类的基类。
属性 | 类型 | 描述 |
---|---|---|
TriggerName | 字符串 | 触发器的名称(显示为活动名称)。 |
TriggerType | 类型 | 触发器事件参数的类型。 |
用户界面元素触发器参数
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 | 字符串 | 字符串形式的窗口句柄。 |
Java 按键参数
从以下事件返回数据:按下键(适用于 Java)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaKeyPressArgs
属性 | 类型 | 描述 |
---|---|---|
KeyChar | 字符串 | 与按下的键对应的字符。 |
KeyCode | 整数 | 与所按下的键对应的代码。 |
ExtendedKeyCode | 整数 | 所按下键的扩展键代码。 与 KeyCode 不同,此值取决于当前的键盘布局。
|
Location | 字符串 | 发起事件的键的位置。 |
KeyModifiers | 任意键修饰符 | 与键一起使用的修饰键。 可能的值:
|
Java 鼠标操作参数
从以下事件返回数据:单击、已按下鼠标、已释放鼠标(适用于 Java)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaMouseActionArgs
属性 | 类型 | 描述 |
---|---|---|
X | 整数 | 鼠标指针的 X 坐标。 |
Y | 整数 | 鼠标指针的 Y 坐标。 |
Button | 整数 | 单击的鼠标键。 可能的值:
|
ClickCount | 整数 | 按钮被单击的次数。 |
KeyModifiers | 任意键修饰符 | 与鼠标键一起使用的修饰键。 可能的值:
|
JavaMouseMotionArgs
从以下事件返回数据:鼠标移动、鼠标进入、鼠标退出(适用于 Java)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaMouseMotionArgs
属性 | 类型 | 描述 |
---|---|---|
X | 整数 | 鼠标指针的 X 坐标。 |
Y | 整数 | 鼠标指针的 Y 坐标。 |
MouseButton | 整数 | 单击的鼠标键可能的值:
|
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 | 整数 | 按下哪个鼠标键。 可能的值:
|
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 | 整数 | 键盘或设备上的按键位置。 可能的值:
|
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
)。
属性 | 类型 | 描述 |
---|---|---|
Url | 字符串 | 当前与框架关联的 URL(如果FrameId 标识的框架曾在给定选项卡中存在过)。 URL 与给定的FrameId 相关联,并不意味着相应的框架仍然存在。
|
TabId | 整数 | 框架所在的选项卡的 ID。 |
FrameId | 整数 |
选项卡中触发了已开始事件并导致选项卡导航的框架的 ID。 框架由其
TabId 和FrameId 唯一标识。
|
TimeStampMs | Double | 网页导航的事件的TimeStampMs 属性仅保证内部一致。 通过将一个事件与另一个事件进行比较,您可以得出它们之间的正确偏移量,但将它们与扩展程序中的当前时间(例如,通过(new Date()).getTime() )进行比较可能会得到意外结果。
|
DateTime | 日期 | 不适用 |
TabNavigationCompletedArgs
html
)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabNavigationCompletedArgs
属性 | 类型 | 描述 |
---|---|---|
Url | 字符串 | 当前与此框架关联的 URL(如果FrameId 标识的框架曾在给定选项卡中存在过)。 URL 与给定的FrameId 相关联,并不意味着相应的框架仍然存在。
|
TabId | 整数 | 框架所在的选项卡 ID。 |
FrameId | 整数 |
选项卡中框架的 ID,已触发已完成事件,从而产生选项卡导航。 框架由其
TabId 和FrameId 唯一标识。
|
TimeStampMs | Double | 网页导航的事件的TimeStampMs 属性仅保证内部一致。 通过将一个事件与另一个事件进行比较,您可以得出它们之间的正确偏移量,但将它们与扩展程序中的当前时间(例如,通过(new Date()).getTime() )进行比较可能会得到意外结果。
|
DateTime | 日期 | 不适用 |
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。 |
UiaToggledArgs
从以下事件返回数据:已切换的事件(适用于 UIA)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> UiaToggledArgs
属性 | 类型 | 描述 |
---|---|---|
State | 字符串 | 目标元素的新状态。 |
UiaTextSelectionChangedArgs
uia
)。
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> UiaTextSelectionChangedArgs
属性 | 类型 | 描述 |
---|---|---|
TextRanges | UiaTextRange() |
数组,用于保存有关目标元素中所选文本元素的不同信息(如果是非相邻文本选择,我们可以选择多个文本元素)。 此数组中的每个项目都会公开以下信息:
|
在基于触发器的 Attended 自动化的上下文中,事件检查工具可用于识别与应用程序中的某些用户界面元素交互时触发的原生事件的类型,然后可用于配置“应用程序事件触发器”活动。该工具可捕获并监控所有选定的事件类型,例如单击、按键、获得焦点、失去焦点以及其他相关交互,使您能够分析执行的操作,并在适用时诊断问题。
选择有效的用户界面元素后,通过单击“检查事件”工具栏按钮,即可从“UI Explorer”打开事件检查工具。
- 记录 - 记录通过与用户界面元素交互而生成的事件并将其添加到事件列表中。
- 暂停 - 不再记录与用户界面元素交互时生成的事件。
- 高亮显示 - 显示目标元素的轮廓,并将其置于前台几秒钟。一直高亮显示,直到禁用为止。
- 在 UI Explorer 中打开 - 在 UI Explorer 中打开受监控的元素,您可以在其中观察该元素的选取器。
- 清除 - 删除所有记录的事件。
- CSV - 可以将捕获的事件导出到
.csv
文件中以进行进一步分析。
- 事件筛选器 - 允许选择您想要监视目标元素的事件类型。
- 事件列表 - 显示有关已捕获事件的信息。
您可以通过启用或禁用事件类型列表中的复选框来筛选要捕获的事件类型。该列表可能因所选元素技术而异。
默认情况下,禁用特定于 Web 或 Java 用户界面元素的所有鼠标事件类型(移动鼠标、点按鼠标、释放鼠标、进入鼠标、退出鼠标),因为在这种情况下,事件列表可能会变得非常大。我们的建议是,仅在您有监控鼠标事件类型的特定需求时才启用它们。
还值得一提的是,即使在开始事件记录之后,也可以启用或禁用事件类型。
- 事件名称 - 事件类型。
- 时间戳 - 执行事件时的日期和时间(小时)。
- 事件数据 - 特定事件的关联数据和参数。
.csv
文件。要再次开始监控,请关闭窗口并打开事件检查工具的另一个实例。