活动
最新
False
横幅背景图像
用户界面自动化活动
上次更新日期 2024年2月26日

应用程序事件触发器

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

描述

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

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

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

备注:

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

项目兼容性

Windows - 旧版 | 窗口

Windows - 旧版 Windows 配置

设计器面板
  • 单击 “在屏幕上指定目标” ,指定要用作目标的用户界面元素。

    指定目标后,选择“ 菜单 按钮以访问以下选项:

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

属性面板

常见

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

输入

  • 匹配同步 - 指示目标元素选取器的匹配是同步还是异步完成。 仅适用于 Java 事件,但“ 出现 ”和 “消失”除外。 此字段仅支持 Boolean 值。 默认值为 False
  • 选取器- 用于监控指定事件的可选选取器集合;这些选取器会与指定的目标一起受到监控。
  • 目标 ” - 目标元素:顶层窗口或用户界面元素。 仅支持严格选取器,不支持锚点。 必须设置目标元素。 在屏幕上指定之前,此字段设置为 (null)。 指定目标后,将显示与指定元素相关的所有属性。
    • 严格选取器 ” - 为目标用户界面元素生成的“严格选取器”。 对于顶层窗口,该字段为空。
    • 窗口选取器 (应用程序实例)- 应用程序窗口(应用程序/浏览器)的选取器。

其他

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

选项

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

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

原生事件

关于

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

  • WND 原生事件

  • CTRL 原生事件

  • JAVA 原生事件

  • WEBCTRL 原生事件

  • HTML 原生事件
  • UIA 原生事件

WND 事件 - 顶级窗口

事件类型

触发器事件参数类型

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

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

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

JAVA 事件 - 用户界面元素

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

WEBCTRL 事件 - 用户界面元素

注意:从 UiPath.UIAutomation.Activities v23.10 开始,我们在原生嵌入式浏览器(例如 Slack、Discord 和 Electron)中添加了对基于 WEBCTRL 的原生事件的支持。

从 UiPath.UIAutomation.Activities v23.12 开始,我们在托管的嵌入式浏览器(例如 CefSharp)中增加了对基于 WEBCTRL 的原生事件的支持。

从 UiPath.UIAutomation.Activities v23.12 开始,嵌入式浏览器支持Text selection changed事件。
事件类型触发器事件参数类型描述
已出现空参数目标元素出现时触发的事件。
已消失 空参数目标元素消失时触发的事件。
更改文本已更改文本的参数目标元素的文本更改时触发的事件。
按下键网页按键参数在焦点位于目标元素内的情况下,按下某个键时触发的事件。
单击网页鼠标事件参数单击目标元素时触发的事件。
双击网页鼠标事件参数双击目标元素时触发的事件。
右击网页鼠标事件参数右键单击目标元素时触发的事件。
鼠标移动网页鼠标事件参数将鼠标移到目标元素上时触发的事件。
已按下鼠标网页鼠标事件参数在目标元素上按下任何鼠标键时触发的事件。
已释放鼠标网页鼠标事件参数在目标元素上释放任何鼠标键时触发的事件。
鼠标已进入网页鼠标事件参数当鼠标进入目标元素可见部分时触发的事件。
鼠标已退出网页鼠标事件参数当鼠标退出目标元素可见部分时触发的事件。
获得焦点空参数目标元素获得焦点时触发的事件。
焦点丢失空参数目标元素失去焦点时触发的事件。
文本选择已更改 WebTextSelectionChangedArgs 目标元素的选定文本更改时触发的事件。

HTML 事件 - 用户界面元素

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

  • Tab activated

  • Tab created

  • Tab removed

  • Tab updated

目前,仅当窗口选取器包含 <html> 部分(例如:<html app='chrome.exe' />)时才允许使用这些事件。不允许使用其他属性,例如 titleurl。如果窗口选取器包含 app 以外的属性,则会生成运行时错误。

精确选取器应为空。

嵌入式浏览器不支持这些事件类型。

事件类型触发器事件参数类型描述
已更改下载状态 DownloadChangedArgsDownloadItem 的属性更改时触发的事件。
已激活选项卡 TabActivatedArgs

窗口中的活动选项卡更改时触发的事件。

注意:触发此事件时可能未设置选项卡的 URL,但您可以侦听 onUpdated 事件,以便在设置 URL 时收到通知。
已创建选项卡 TabCreatedArgs

创建选项卡时触发的事件。

注意:触发此事件时,可能未设置选项卡的 URL 和选项卡组成员身份,但您可以侦听 onUpdated 事件,以便在设置 URL 或将选项卡添加到选项卡组时收到通知。
已删除选项卡 TabRemovedArgs关闭选项卡时触发的事件。
已更新选项卡TabUpdatedArgs更新选项卡时触发的事件。
已开始选项卡导航TabNavigationStartedArgs启动指向特定 URL 的选项卡导航时触发的事件。
已完成选项卡导航TabNavigationCompletedArgs完成指向特定 URL 的选项卡导航时触发的事件。
窗口焦点已更改HtmlWindowFocusChangedArgs当前聚焦窗口更改时触发的事件。
窗口边界已更改HtmlWindowBoundsChangedArgs调整窗口大小时触发的事件。 仅在提交新边界时调度它,而不是在正在进行的更改时调度它。
窗口已创建HtmlWindowCreatedArgs创建窗口时触发的事件。
窗口已删除HtmlWindowRemovedArgs移除(关闭)窗口时触发的事件。

UIA 事件 - 用户界面元素

事件类型触发器事件参数类型描述
已出现 空参数目标元素出现时触发的事件。
已消失 空参数目标元素消失时触发的事件。
更改文本 已更改文本的参数目标元素的文本更改时触发的事件。
文本选择已更改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任意键修饰符与键一起使用的修饰键。 可能的值:
  • 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字符串触发事件的键的代码(例如 KeyAKeyBControlLeftControlRight)。
CtrlKey布尔值如果按下了 CTRL 键。
IsComposing布尔值事件的状态是否为正在撰写。
Key字符串触发事件的键的值(例如 abControl)。
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.DownloadItemstate 中更改的字符串。
Id字符串已更改的 downloads.DownloadItemid
FileName字符串描述 downloads.DownloadItemurl 中更改的字符串。
Url字符串描述 downloads.DownloadItemfilename 中更改的字符串。
StartTime字符串描述 downloads.DownloadItemstartTime 中更改的字符串。
EndTime字符串描述 downloads.DownloadItemendTime 中更改的字符串。
Error字符串描述 downloads.DownloadItemerror 状态中更改的字符串。
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 )。
继承关系: “触发器参数” > “用户界面元素触发器参数” > “原生触发器基本参数” > “TabNavationStartedArgs”
属性类型描述
Url字符串当前与框架关联的 URL(如果FrameId标识的框架曾在给定选项卡中存在过)。 URL 与给定的FrameId相关联,并不意味着相应的框架仍然存在。
TabId整数框架所在的选项卡的 ID。
FrameId整数

选项卡中触发了已开始事件并导致选项卡导航的框架的 ID。

框架由其TabIdFrameId唯一标识。
TimeStampMsDouble网页导航的事件的TimeStampMs属性仅保证内部一致。 通过将一个事件与另一个事件进行比较,您可以得出它们之间的正确偏移量,但将它们与扩展程序中的当前时间(例如,通过(new Date()).getTime() )进行比较可能会得到意外结果。
DateTime日期不适用
TabNavigationCompletedArgs
从选项卡导航完成事件返回数据(适用于html )。
继承顺序:TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs
属性类型描述
Url字符串当前与此框架关联的 URL(如果FrameId标识的框架曾在给定选项卡中存在过)。 URL 与给定的FrameId相关联,并不意味着相应的框架仍然存在。
TabId整数框架所在的选项卡 ID。
FrameId整数

选项卡中框架的 ID,已触发已完成事件,从而产生选项卡导航。

框架由其TabIdFrameId唯一标识。
TimeStampMsDouble网页导航的事件的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
属性类型描述
TextRangesUiaTextRange()

数组,用于保存有关目标元素中所选文本元素的不同信息(如果是非相邻文本选择,我们可以选择多个文本元素)。

此数组中的每个项目都会公开以下信息:

  • Text ”(键入“ String ”)- 所选文本元素的文本。 示例: TriggerEventArgs.TextRanges(0).Text表示第一个选定文本元素的文本。
  • BoundingRectangles (类型Rectangle()) - 所选文本元素的边框数组。 如果选定的文本元素跨越多行,则可以有多个关联的边框。
    每个边框的类型均为Rectangle {X , Y , Width , Height},并且提供有关元素位置和大小的信息。

    示例:

    TriggerEventArgs.TextRanges(0).BoundingRectangles(0)表示第一个选定文本元素中第一行的边框。

事件检查工具

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

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



工具栏包含以下选项:
  • 记录 - 记录通过与用户界面元素交互而生成的事件并将其添加到事件列表中。
  • 暂停 - 不再记录与用户界面元素交互时生成的事件。
  • 高亮显示 - 显示目标元素的轮廓,并将其置于前台几秒钟。一直高亮显示,直到禁用为止。
  • 在 UI Explorer 中打开 - 在 UI Explorer 中打开受监控的元素,您可以在其中观察该元素的选取器。
开始事件记录后,还有两个选项可用:
  • 清除 - 删除所有记录的事件。
  • CSV - 可以将捕获的事件导出到 .csv 文件中以进行进一步分析。
事件检查工具”窗口分为两个主要部分:
  • 事件筛选器 - 允许选择您想要监视目标元素的事件类型。
  • 事件列表 - 显示有关已捕获事件的信息。

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

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

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

事件列表包含三列:
  • 事件名称 - 事件类型。
  • 时间戳 - 执行事件时的日期和时间(小时)。
  • 事件数据 - 特定事件的关联数据和参数。
每一列都可以按升序或降序排序。默认情况下,事件按执行顺序显示。


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


此页面是否有帮助?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.