activities

latest

false

UI Automation Activities

Last updated Nov 25, 2024

Application Event Trigger

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

Description

Sets up a trigger based on a native event of any type of element (top-level window or any other indicated UI element). You can indicate the target element on screen and then choose the native event from the list of events supported by that element.

This activity is compatible with Object Repository.

The trigger must be the first activity in the workflow and the workflow is triggered when a certain UI event occurs. Only one trigger per workflow is allowed. For more details, check out Trigger-based Attended Automation.

Note:

If you are using a Studio version lower than 2023.4, you need to place the Application Event Trigger activity inside a Trigger Scope activity. In this case, the Application Event Trigger activity does not display the Scheduling mode and Enabled properties and the Scheduling mode property is available in the Trigger Scope activity.

Project compatibility

Windows - Legacy | Windows

Windows - Legacy, Windows configuration

Designer panel

Click Indicate target on screen to indicate the UI element to use as target.

After you indicate the target, select the Menu button to access the following options:
- Indicate target on screen - Indicate the target again.
- Edit target - Open the selection mode to configure the target.
- Remove informative screenshot - Remove the screenshot of the target application or web page.
- Add to Object Repository - Add the current UI element to a library project, from where it can be reused throughout your automation process.
Event type - The list of native event types specific to the indicated element. The event type must be set. The exposed events list is dependent on the target element type and on the target application technology. For example, a web UI element might expose a different list of events than a Java UI element.

Properties panel

Common

Display name - The name displayed for the activity in the Designer panel. A display name is automatically generated when you indicate a target.

Input

Match sync - Indicates whether the matching of the target element selector is done synchronously or asynchronously. It is supported only for Java events except for Appeared and Disappeared. This field supports only Boolean values. The default value is False.
Selectors - Optional collection of selectors to monitor for the indicated event; these selectors are monitored alongside the indicated target. The selectors must be full (not partial) selectors.

Target - The target element: top-level window or UI element. Only strict selectors are supported, without anchors. Target element must be set. Before indicating on screen, this field is set to (null). Once the target is indicated, all properties regarding the element that was indicated are displayed.
- Strict selector - The strict selector generated for the target UI element. It is empty for top-level windows.
- Window selector (Application instance) - The selector for the application window (application/browser).

Misc

Enabled - If set to False, the trigger starts but does not fire any events. It can be enabled later at runtime, by using the Enable Local Trigger activity. This property is hidden when the Application Event Trigger activity is placed inside a Trigger Scope. This field supports only Boolean values. The default value is True.
Private - If selected, the values of variables and arguments are no longer logged at Verbose level. This field supports only Boolean (True, False) values. The default value is False.

Options

Include children - When selected, the children of the specified UI element are also monitored. It supports all event types except for Appeared or Disappeared and any UI element except for top-level windows. This field supports only Boolean (True, False) values. The default value is False.
Scheduling mode - It specifies how to execute the actions when a trigger is fired. Choose one of five options from the drop-down menu:
- Sequential - Actions are executed one after another.
- Concurrent - Actions execution can overlap.
- OneTime - Executes one action and exits monitoring.
- Sequential Collapse - Ignores all upcoming events, except the latest, until the current event finishes execution.
- Sequential Drop - Stops the previous event execution and starts the next event.
For Sequential and Concurrent modes the monitoring continues until either the user stops the execution or a Break activity is met.

Native events

About

The native events monitoring mechanism has been improved by implementing new sets of events supported by different types of application technologies:

WND native events
CTRL native events
JAVA native events
WEBCTRL native events
HTML native events
UIA native events

WND events - Top-level window

Event type	TriggerEventArgs type	Description
Appeared	EmptyArgs	Event triggered when the target element appears.
Disappeared	EmptyArgs	Event triggered when the target element disappears.
Title changed	TextChangedArgs	Event triggered when the title of the target element changes. Note: This is the Text changed event, renamed to Title changed for top-level windows, for more clarity.
State changed	StateChangedArgs	Event triggered when the state of the target element changes. Note: This event is triggered when something is changed in the state of the window: enabled, disabled, checked, unchecked, focusable, focused, visible, etc. The new value of the state is exposed in the arguments variable.
Location changed	LocationChangedArgs	Event triggered when the target’s element location has changed.
Foreground gained	HwndArgs	Event triggered when the target’s element window becomes the foreground window.
Foreground lost	HwndArgs	Event triggered when the target’s element window is no longer in foreground.
Minimized	HwndArgs	Event triggered when the target’s element window is about to be minimized.
Restored	HwndArgs	Event triggered when the target’s element window is about to be restored.

CTRL or WND events - UI elements

Event type	TriggerEventArgs type	Description
Appeared	EmptyArgs	Event triggered when the target element appears.
Disappeared	EmptyArgs	Event triggered when the target element disappears.
Key pressed	KeyPressArgs	Event triggered when a key is pressed while focus is inside the target element.
Click	MouseClickedArgs	Event triggered when the target element is clicked.
Text changed	TextChangedArgs	Event triggered when the text of the target element changes.
Focus gained	EmptyArgs	Event triggered when the target element gains focus.
Focus lost	EmptyArgs	Event triggered when the target element loses focus.
State changed	StateChangedArgs	Event triggered when the state of the target element changes. Note: This event is triggered when something is changed in the state of the window: enabled, disabled, checked, unchecked, focusable, focused, visible, etc. The new value of the state is exposed in the arguments variable.
Selection changed	SelectionChangedArgs	Event triggered when the target element selection value changes.

JAVA events - UI elements

Event type	TriggerEventArgs type	Description
Appeared	EmptyArgs	Event triggered when the target element appears.
Disappeared	EmptyArgs	Event triggered when the target element disappears.
Text changed	TextChangedArgs	Event triggered when the text of the target element changes.
Key pressed	JavaKeyPressArgs	Event triggered when a key is pressed while focus is inside the target element.
Click	JavaMouseActionArgs	Event triggered when the target element is clicked.
Mouse move	JavaMouseMotionArgs	Event triggered when the mouse is moved over the target element.
Focus gained	EmptyArgs	Event triggered when the target element gains focus.
Focus lost	EmptyArgs	Event triggered when the target element loses focus.
Enabled	EmptyArgs	Event triggered when the target element is enabled.
Disabled	EmptyArgs	Event triggered when the target element is disabled.
Selection changed	SelectionChangedArgs	Event triggered when the target element selection value changes.
Mouse entered	JavaMouseMotionArgs	Event triggered when the mouse enters the visible part of the target element.
Mouse exited	JavaMouseMotionArgs	Event triggered when the mouse exits the visible part of the target element.
Cell selected	JavaCellSelectedArgs	Event triggered when the target element is a table cell and it gets selected.
Cell value changed	JavaCellValueChangedArgs	Event triggered when the target element is a table cell and its value is changed.
Mouse pressed	JavaMouseActionArgs	Event triggered when any mouse button is pressed over the target element.
Mouse released	JavaMouseActionArgs	Event triggered when any mouse button is released over the target element.
Menu selected	EmptyArgs	Event triggered when the target element is a menu and it gets selected.
Menu deselected	EmptyArgs	Event triggered when the target element is a menu and it gets deselected.
Menu canceled	EmptyArgs	Event triggered when the target element is a menu and it gets canceled.
Popup menu visible	EmptyArgs	Event triggered when the target element is a popup menu and it becomes visible.
Popup menu invisible	EmptyArgs	Event triggered when the target element is a popup menu and it becomes invisible.
Popup menu canceled	EmptyArgs	Event triggered when the target element is a popup menu and it gets canceled.

WEBCTRL events - UI elements

Note:

Starting with UiPath.UIAutomation.Activities v23.10.3 we added support for:

WEBCTRL based native events in native embedded browsers (such as Slack, Discord, Electron).

Event type	TriggerEventArgs type	Description
Appeared	EmptyArgs	Event triggered when the target element appears.
Disappeared	EmptyArgs	Event triggered when the target element disappears.
Text changed	TextChangedArgs	Event triggered when the text of the target element changes.
Key pressed	WebKeyPressArgs	Event triggered when a key is pressed while focus is inside the target element.
Click	WebMouseEventArgs	Event triggered when the target element is clicked.
Double click	WebMouseEventArgs	Event triggered when the target element is double-clicked.
Right click	WebMouseEventArgs	Event triggered when the target element is right-clicked.
Mouse move	WebMouseEventArgs	Event triggered when the mouse is moved over the target element.
Mouse pressed	WebMouseEventArgs	Event triggered when any mouse button is pressed over the target element.
Mouse released	WebMouseEventArgs	Event triggered when any mouse button is released over the target element.
Mouse entered	WebMouseEventArgs	Event triggered when the mouse enters the visible part of the target element.
Mouse exited	WebMouseEventArgs	Event triggered when the mouse exits the visible part of the target element.
Focus gained	EmptyArgs	Event triggered when the target element gains focus.
Focus lost	EmptyArgs	Event triggered when the target element loses focus.
Text selection changed	WebTextSelectionChangedArgs	Event triggered when the selected text of the target element changes.

HTML events - UI elements

Note: The following event types are only supported for web applications identified by <html> selectors that have only the app attribute:

Download state changed
Tab activated
Tab created
Tab removed
Tab updated

For now, these events are allowed only when the Window selector contains the <html> part, such as:

<html
                           app='chrome.exe' />

. Other attributes such as title or url are not allowed. If the Window selector contains attributes other than app, a runtime error is generated.

Strict selector should be empty.

These event types are not supported for embedded browsers.

Event Type	TriggerEventArgs Type	Description
Download state changed	DownloadChangedArgs	Event triggered when any of a `DownloadItem`'s properties changes.
Tab activated	TabActivatedArgs	Event triggered when the active tab in a window changes. Note: The tab's URL may not be set at the time this event fired, but you can listen to `onUpdated` events to be notified when a URL is set.
Tab created	TabCreatedArgs	Event triggered when a tab is created. Note: The tab's URL and tab group membership may not be set at the time this event is fired, but you can listen to `onUpdated` events to be notified when a URL is set or the tab is added to a tab group.
Tab removed	TabRemovedArgs	Event triggered when a tab is closed.
Tab updated	TabUpdatedArgs	Event triggered when a tab is updated.
Tab navigation started	TabNavigationStartedArgs	Event triggered when the tab navigation to a specific URL started.
Tab navigation completed	TabNavigationCompletedArgs	Event triggered when the tab navigation to a specific URL completed.
Window focus changed	HtmlWindowFocusChangedArgs	Event triggered when the currently focused window changes.
Window bounds changed	HtmlWindowBoundsChangedArgs	Event triggered when a window has been resized. It is only dispatched when the new bounds are committed, and not for in-progress changes.
Window created	HtmlWindowCreatedArgs	Event triggered when a window is created.
Window removed	HtmlWindowRemovedArgs	Event triggered when a window is removed (closed).
Web request: Before redirect	WebRequestBeforeRedirectArgs	Event triggered when a server-initiated redirect is about to occur.
Web request: Before request	WebRequestBeforeRequestArgs	Event triggered when a request is about to occur.
Web request: Before send HTTP headers	WebRequestBeforeSendHeadersArgs	Event triggered when a request is about to occur and the initial headers have been prepared. The event is intended to allow extensions to add, modify, and delete request headers.
Web request: Completed	WebRequestCompletedArgs	Event triggered when a web request has been processed successfully.
Web request: Error occurred	WebRequestErrorOccurredArgs	Event triggered when a web request could not be processed successfully. The web request API guarantees that for each request, either `Completed` or `Error occurred` is fired as the final event with one exception.
Web request: HTTP headers received	WebRequestHeadersReceivedArgs	Event triggered each time that an HTTP(S) response header is received. Due to redirects and authentication requests this can happen multiple times per request.
Web request: Response started	WebRequestResponseStartedArgs	Event triggered when the first byte of the response body is received. For HTTP requests, this means that the status line and response headers are available. This event is informational and handled asynchronously. It does not allow modifying or canceling the request.
Web request: Send HTTP headers	WebRequestSendHeadersArgs	Event triggered after all extensions have had a chance to modify the request headers, and presents the final version. The event is triggered before the headers are sent to the network. This event is informational and handled asynchronously. It does not allow modifying or cancelling the request.

UIA events - UI elements

Event type	TriggerEventsArgs type	Description
Appeared	EmptyArgs	Event triggered when the target element appears.
Disappeared	EmptyArgs	Event triggered when the target element disappears.
Key pressed	KeyPressArgs	Event triggered when a key is pressed while focus is inside the target element.
Click	MouseClickedArgs	Event triggered when the target element is clicked.
Text changed	TextChangedArgs	Event triggered when the text of the target element changes.
Text selection changed	UiaTextSelectionChangedArgs	Event triggered when the selected text of the target element changes.
Focus gained	EmptyArgs	Event triggered when the target element gains focus.
Focus lost	EmptyArgs	Event triggered when the target element loses focus.
Invoked	EmptyArgs	Event triggered when the target element gets invoked.
Selected	SelectionChangedArgs	Event triggered when the target element gets selected.
Deselected	SelectionChangedArgs	Event triggered when the target element gets deselected.
Toggled	UiaToggledArgs	Event triggered when the target element gets toggled.

TriggerEventArgs properties

TriggerArgs

Base class for all args classes related to triggers.

Property	Type	Description
`TriggerName`	String	The name of the trigger activity which emitted this event (displayed as activity name).
`TriggerType`	Type	The .NET type of the trigger activity which emitted this event.

UiElementTriggerArgs

Inheritance: TriggerArgs > UiElementTriggerArgs

Property	Type	Description
`Selector`	String	The selector of the target element.
`TargetElement`	UiElement	The target element that is monitored.

NativeTriggerBaseArgs

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

Property	Type	Description
`SelectorIndex`	Integer	The index of the target element selector.

EmptyArgs

Returns data from the following events:

Appeared
Disappeared
Focus gained
Focus lost
Enabled
Disabled
Menu selected
Menu deselected
Menu canceled
Popup menu visible
Popup menu invisible
Popup menu canceled

Inheritance: TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

Returns data from the following events:

Text changed
Title changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

Property	Type	Description
`Text`	String	The new text for the target element.

StateChangedArgs

Returns data from the following events:

State changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

Property	Type	Description
`State`	String	The new state for the target element.

SelectionChangedArgs

Returns data from the following events:

Selection changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

Property	Type	Description
`Selection`	String	The new selection for the target element.

LocationChangedArgs

Returns data from the following events:

Location changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs> LocationChangedArgs

Property	Type	Description
`Location`	Rectangle	Rectangle of the changed location, with information about the size of the element and its position.

HwndArgs

Returns data from the following events:

Foreground gained
Foreground lost
Minimized
Restored

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

Property	Type	Description
`Hwnd`	IntPtr	Window handle.
`HwndAsString`	String	Window handle as string.

KeyPressArgs

Returns data from the following events from WND and CTRL elements:

Key pressed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs

Property	Type	Description
`Key`	Integer	The key that was interacted with.
`ScanCode`	Integer	The scan code corresponding to the key that was interacted with.
`KeyAction`	Integer	Indicates whether the key was pressed or released. Possible values: `0` - key was pressed `1` - key was released
`KeyModifiers`	NKeyModifiers	The key modifier used alongside the key. Possible values: `None` = 0 `Alt` = 1 `Ctrl` = 2 `Shift` = 4 `Win` = 8

MouseClickedArgs

Returns data from the following events from WND and CTRL elements:

Click

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs

Property	Type	Description
`X`	Integer	The X coordinate of the mouse pointer.
`Y`	Integer	The Y coordinate of the mouse pointer.
`MouseButton`	Integer	The mouse button that was clicked. Possible values: `0` - None `1` - Left `2` - Middle `3` - Right
`MouseAction`	Integer	Indicates whether the mouse button was pressed or released. Possible values: `0` - mouse button was pressed `1` - mouse button was released
`KeyModifiers`	NKeyModifiers	The key modifier used alongside the mouse button. Possible values: `None` = 0 `Alt` = 1 `Ctrl` = 2 `Shift` = 4 `Win` = 8

JavaKeyPressArgs

Returns data from the following events for Java:

Key pressed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

Property	Type	Description
`KeyChar`	String	The character corresponding to the key pressed.
`KeyCode`	Integer	The code corresponding to the key pressed.
`ExtendedKeyCode`	Integer	The extended key code for the key pressed. Unlike `KeyCode`, this value depends on the current keyboard layout.
`Location`	String	The location of the key that originated the event.
`KeyModifiers`	NKeyModifiers	The key modifier used alongside the key. Possible values: `None` = 0 `Alt` = 1 `Ctrl` = 2 `Shift` = 4 `Win` = 8

JavaMouseActionArgs

Returns data from the following events for Java:

Click
Mouse pressed
Mouse released

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

Property	Type	Description
`X`	Integer	The X coordinate of the mouse pointer.
`Y`	Integer	The Y coordinate of the mouse pointer.
`Button`	Integer	The mouse button that was clicked. Possible values: `1` - Left `2` - Middle `3` - Right
`ClickCount`	Integer	The number of times the button was clicked.
`KeyModifiers`	NKeyModifiers	The key modifier used alongside the mouse button. Possible values: `None` = 0 `Alt` = 1 `Ctrl` = 2 `Shift` = 4 `Win` = 8

JavaMouseMotionArgs

Returns data from the following events for Java:

Mouse move
Mouse entered
Mouse exited

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

Property	Type	Description
`X`	Integer	The X coordinate of the mouse pointer.
`Y`	Integer	The Y coordinate of the mouse pointer.
`MouseButton`	Integer	The mouse button that was clicked Possible values: `0` - None `1` - Left `2` - Middle `3` - Right

JavaCellSelectedArgs

Returns data from the following events for Java:

Click

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

Property	Type	Description
`Row`	Integer	Selected cell row.
`Column`	Integer	Selected cell column.

JavaCellValueChangedArgs

Returns data from the following events for Java:

Click

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

Property	Type	Description
`Row`	Integer	Cell row.
`Column`	Integer	Cell column.
`Value`	String	New value of the cell.

WebMouseEventArgs

Returns data from the following events for WEBCTRL:

Click
Double click
Right click
Mouse move
Mouse entered
Mouse exited
Mouse pressed
Mouse released

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Note: It follows the property names defined for Mouse Events.

Property	Type	Description
`AltKey`	Boolean	If the ALT key is pressed.
`Button`	Integer	Which mouse button is pressed. Possible values: `0` - Left `1` - Middle `2` - Right
`ClientX`	Integer	The X coordinate of the mouse pointer (window relative).
`ClientY`	Integer	The Y coordinate of the mouse pointer (window relative).
`CtrlKey`	Boolean	If the CTRL key is pressed.
`MetaKey`	Boolean	If the META key is pressed.
`MovementX`	Integer	The X coordinate of the mouse pointer (relative to the position of the last `mousemove` event).
`MovementY`	Integer	The Y coordinate of the mouse pointer (relative to the position of the last `mousemove` event).
`OffsetX`	Integer	The X coordinate of the mouse pointer (target relative).
`OffsetY`	Integer	The Y coordinate of the mouse pointer (target relative).
`PageX`	Integer	The X coordinate of the mouse pointer (document relative).
`PageY`	Integer	The Y coordinate of the mouse pointer (document relative).
`ScreenX`	Integer	The X coordinate of the mouse pointer (screen relative).
`ScreenY`	Integer	The Y coordinate of the mouse pointer (screen relative).
`ShiftKey`	Boolean	If the SHIFT key is pressed.

WebKeyPressArgs

Returns data from the following events for WEBCTRL:

Key pressed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Note: It follows the property names defined for Keyboard Events.

Property	Type	Description
`AltKey`	Boolean	If the ALT key is pressed.
`Code`	String	The code of the key that triggered the event (e.g., `KeyA`, `KeyB`, `ControlLeft`, `ControlRight`).
`CtrlKey`	Boolean	If the CTRL key is pressed.
`IsComposing`	Boolean	If the state of the event is composing or not.
`Key`	String	The value of the key that triggered the event (e.g. `a`, `b`, `Control`).
`Location`	Integer	The location of a key on the keyboard or device. Possible values: `0` - Standard - represents almost every key on the keyboard `1` - Left key was pressed `2` - Right key was pressed `3` - The key was pressed on the numeric keypad
`MetaKey`	Boolean	If the META key is pressed.
`Repeat`	Boolean	If a key is being hold down repeatedly, or not.
`ShiftKey`	Boolean	If the SHIFT key is pressed.

WebTextSelectionChangedArgs

Returns data from the following events for WEBCTRL:

Text selection changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Note: It follows the property names defined for Keyboard Events.

Property	Type	Description
`AnchorClientBounds`	Rectangle	The anchor client bounds: information about the size of the element and its position relative to the viewport.
`AnchorElement`	UiElement	The anchor UI element.
`AnchorOffset`	Integer	The 0-based index of the character where the text selection started (from the full text of the target element).
`FocusClientBounds`	Rectangle	The focus client bounds: information about the size of the element and its position relative to the viewport.
`FocusElement`	UiElement	The focus UI element.
`FocusOffset`	Integer	The 0-based index of the character where the text selection ended (from the full text of the target element).
`SelectedText`	String	The new text selection for the target element.

DownloadChangedArgs

Returns data from the following events for WEBCTRL:

Download state changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

Property	Type	Description
`State`	String	The string describing a change in a `downloads.DownloadItem`'s `state`.
`Id`	String	The `id` of the `downloads.DownloadItem` that changed.
`FileName`	String	The string describing a change in a `downloads.DownloadItem`'s `url`.
`Url`	String	The string describing a change in a `downloads.DownloadItem`'s `filename`.
`StartTime`	String	The string describing a change in a `downloads.DownloadItem`'s `startTime`.
`EndTime`	String	The string describing a change in a `downloads.DownloadItem`'s `endTime`.
`Error`	String	The string describing a change in a `downloads.DownloadItem`'s `error` status.

TabActivatedArgs

Returns data from the following events for WEBCTRL:

Tab activated

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

Property	Type	Description
`TabId`	String	The ID of the tab that has become active.
`WindowId`	String	The ID of the window the selected tab changed inside of.
`Title`	String	The tab's new title.
`Url`	String	The tab's URL if it has changed.

TabCreatedArgs

Returns data from the following events for WEBCTRL:

Tab created

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

Property	Type	Description
`TabId`	String	The ID of the tab that has been created.
`WindowId`	String	The ID of the window that contains the tab.
`Title`	String	The tab's new title.
`Url`	String	The tab's URL.

TabRemovedArgs

Returns data from the following events for WEBCTRL:

Tab removed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

Property	Type	Description
`TabId`	String	The ID of the tab that has been removed.
`WindowId`	String	The ID of the window whose tab is closed.
`IsWindowClosing`	Boolean	`True` when the tab was closed because its parent window was closed.

TabUpdatedArgs

Returns data from the following events for WEBCTRL:

Tab updated

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

Property	Type	Description
`TabId`	String	The ID of the tab that has been updated.
`WindowId`	String	The ID of the window that contains the tab.
`Status`	String	The tab's loading status.
`Title`	String	The tab's new title.
`Url`	String	The tab's URL if it has changed.
`Active`	Boolean	Whether the tab is active in its window. Does not necessarily mean the window is focused.

TabNavigationStartedArgs

Returns data from the following events for HTML:

Tab navigation started

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

Property	Type	Description
`Url`	String	The URL currently associated with the frame, if the frame identified by the `FrameId` existed at one point in the given tab. The fact that an URL is associated with a given `FrameId` does not imply that the corresponding frame still exists.
`TabId`	Integer	The ID of the tab in which the frame is.
`FrameId`	Integer	The ID of the frame within the tab, for which the started event was fired, resulting in tab navigation. Frames are uniquely identified by their `TabId` and `FrameId`.
`TimeStampMs`	Double	The time at which the tab navigation started, in milliseconds since the epoch. The web navigation's events' `TimeStampMs` property is only guaranteed to be internally consistent. Comparing one event to another event will give you the correct offset between them, but comparing them to the current time inside the extension (via `(new Date()).getTime()`, for instance) might give unexpected results.
`DateTime`	Date	The date and time when the tab navigation started (UTC).

TabNavigationCompletedArgs

Returns data from the following events for HTML:

Tab navigation completed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

Property	Type	Description
`Url`	String	The URL currently associated with this frame, if the frame identified by the `FrameId` existed at one point in the given tab. The fact that an URL is associated with a given `FrameId` does not imply that the corresponding frame still exists.
`TabId`	Integer	The ID of the tab in which the frame is..
`FrameId`	Integer	The ID of the frame within the tab, for which the completed event was fired, resulting in tab navigation. Frames are uniquely identified by their `TabId` and `FrameId`.
`TimeStampMs`	Double	The time at which the tab navigation completed, in milliseconds since the epoch. The web navigation's events' `TimeStampMs` property is only guaranteed to be internally consistent. Comparing one event to another event will give you the correct offset between them, but comparing them to the current time inside the extension (via `(new Date()).getTime()`, for instance) might give unexpected results.
`DateTime`	Date	The date and time when the tab navigation completed (UTC).

HtmlWindowFocusChangedArgs

Returns data from the following events for HTML:

Window focus changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

Property	Type	Description
`TabId`	String	The ID of the newly-focused tab.
`WindowId`	String	The ID of the window that contains the tab.
`Title`	String	The tab’s title.
`Url`	String	The tab's URL if it has changed.

HtmlWindowBoundsChangedArgs

Returns data from the following events for HTML:

Window bounds changed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

Property	Type	Description
`WindowId`	String	The ID of the window whose bounds have changed.
`Focused`	Boolean	Whether the window is currently the focused window.
`Top`	Integer	The offset of the window from the top edge of the screen in pixels.
`Left`	Integer	The offset of the window from the left edge of the screen in pixels.
`Width`	Integer	The width of the window, including the frame, in pixels.
`Height`	Integer	The height of the window, including the frame, in pixels.

HtmlWindowCreatedArgs

Returns data from the following events for HTML:

Window created

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Property	Type	Description
`WindowId`	String	The ID of the created window.

HtmlWindowRemovedArgs

Returns data from the following events for HTML:

Window removed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Property	Type	Description
`WindowId`	String	The ID of the removed window.

WebRequestBaseArgs

Base class for Web Request events args for HTML.

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs

Property	Type	Description
`FrameId`	String	The ID of the frame in which the request happens.
`Initiator`	String	The origin where the request was initiated.
`Method`	String	Standard HTTP method.
`ParentFrameId`	String	The ID of frame that wraps the frame which sent the request.
`RequestId`	String	The ID of the request.
`TabId`	String	The ID of the tab in which the request takes place.
`TimeStamp`	String	The time when this signal is triggered, in milliseconds since the epoch.
`Type`	String	How the requested resource will be used.
`Url`	String	The URL.

WebRequestHeadersReceivedArgs

Returns data from the following events for HTML:

Web request: HTTP headers received

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs

Property	Type	Description
`ResponseHeaders`	String	The HTTP response headers that have been received with this response.
`StatusCode`	String	Standard HTTP status code returned by the server.
`StatusLine`	String	HTTP status line of the response.

WebResponseCacheDetailsArgs

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs

Property	Type	Description
`FromCache`	Boolean	Indicates if this response was fetched from disk cache.
`Ip`	String	The server IP address that the request was actually sent to.

WebRequestBeforeRedirectArgs

Returns data from the following events for HTML:

Web request: Before redirect

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebResponseCacheDetailsArgs > WebRequestBeforeRedirectArgs

Property	Type	Description
`RedirectUrl`	String	The redirect URL.

WebRequestBeforeRequestArgs

Returns data from the following events for HTML:

Web request: Before request

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeRequestArgs

WebRequestBeforeSendHeadersArgs

Returns data from the following events for HTML:

Web request: Before send HTTP headers

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeSendHeadersArgs

Property	Type	Description
`RequestHeaders`	String	The HTTP request headers that are going to be sent out with this request.

WebRequestCompletedArgs

Returns data from the following events for HTML:

Web request: Completed

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestCompletedArgs

WebRequestErrorOccurredArgs

Returns data from the following events for HTML:

Web request: Error occurred

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestErrorOccurredArgs

Property	Type	Description
`Error`	String	The error description.
`FromCache`	Boolean	Indicates if this response was fetched from disk cache.
`Ip`	String	The server IP address that the request was actually sent to.

WebRequestResponseStartedArgs

Returns data from the following events for HTML:

Web request: Response started

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs → WebRequestHeadersReceivedArgs→ WebResponseCacheDetailsArgs→ WebRequestResponseStartedArgs

WebRequestSendHeadersArgs

Returns data from the following events for HTML:

Web request: Send HTTP headers

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestSendHeadersArgs

Property	Type	Description
`RequestHeaders`	String	The HTTP request headers that are going to be sent out with this request.

UiaToggledArgs

Returns data from the following events for UIA:

Toggled events

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

Property	Type	Description
`State`	String	The new state for the target element.

UiaTextSelectionChangedArgs

Returns data from the following events for UIA:

Text selection changed events

Inheritance: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

Property	Type	Description
`TextRanges`	UiaTextRange()	Array that holds different information about the selected text elements in the target element (we can have multiple selected text elements in case non-adjacent text selection). Each item from this array exposes the following information: `Text` (type `String`) - Text selection for that selected text element. Example: `TriggerEventArgs.TextRanges(0).Text` represents the text of the first selected text element. `BoundingRectangles` (type `Rectangle())` - Array of bounding rectangles for the selected text element. A selected text element can have multiple bounding rectangles associated with it if it spans multiple lines. Each bounding rectangle is of type `Rectangle` {`X`, `Y`, `Width`, `Height`} and it provides information about the position and size of the element. Example: `TriggerEventArgs.TextRanges(0).BoundingRectangles(0)` represents the bounding rectangle of the first line in the first selected text element.

Event Inspection Tool

In the context of trigger-based attended automation, the Event Inspection Tool can be used to identify the type of native events triggered when you interact with certain UI elements in an application, and then it can be used for configuring the Application Event Trigger activity. The tool captures and monitors all the selected event types, such as Click, Key pressed, Focus gained, Focus lost, and other relevant interactions, enabling you to analyze the actions performed and, if applicable, diagnose issues.

The Event Inspection Tool can be opened from the UI Explorer, once a valid UI element is selected, by clicking the Inspect Events toolbar button.

The toolbar consists of the following options:

Record - The events generated by interacting with the UI element are recorded and added to the events list.
Pause - The events generated by the UI element when you interact with it are no longer recorded.
Highlight - Shows the contour of the target element and brings it to the foreground for a few seconds. The highlight stays on until it is disabled.
Open in UI Explorer - The monitored element is opened in UI Explorer where you can observe the selector of that element.

Once you start event recording, two more options become available:

Clear - Deletes all the recorded events.
CSV - The captured events can be exported to a .csv file for further analysis.

The Event Inspection Tool window has two main sections:

Event filter - Allows selecting the types of events you want to monitor for the target element.
Event list - Displays information about captured events.

You can filter event types to be captured by enabling or disabling the checkboxes from the list of event types. The list may vary based on the selected element technology.

All mouse event types (Mouse move, Mouse pressed, Mouse released, Mouse entered, Mouse exited), specific for Web or Java UI elements, are disabled by default because the event list, in such cases, can become quite large. Our recommendation is to enable the mouse event types only if you have a specific need to monitor them.

It is worth also mentioning that event types can be enabled or disabled even after you started the event recording.

The event list has three columns:

Event Name - The event type.
Time Stamp - The date and hour when the event was performed.
Event Data - The associated data and parameters for a certain event.

Each column can be sorted in ascending or descending order. The events are displayed by default in the order they were performed.

When the Disappeared event type is found, you can no longer continue monitoring and an error message is displayed on the screen. When clicking any option from the toolbar, the same error message is displayed on the screen. The only available options are to either clear the data or export it to a .csv file. To start monitoring again, close the window and open another instance of the Event Inspection Tool.