Hover Activity

The Hover activity positions the mouse cursor over a specific UI element within a native Windows desktop application without performing a click, useful for triggering tooltips or hover-based menus.

Field	Description	Requirement
Application instance	The reference name of the application instance previously opened or attached.	Required
Element	The JSON-based selector identifying the target element.	Required
Label	An alternative to `Element` that identifies the target by label instead of a selector.	Optional
Label match type	Defines how `Label` is compared against candidate elements (e.g., `Equals`, `Contains`).	Optional
X-coordinate offset	Adjusts the horizontal hover position relative to the element by a specified pixel value.	Optional
Y-coordinate offset	Adjusts the vertical hover position relative to the element by a specified pixel value.	Optional

Action Types & Examples

Element Hover

Format: string (element locator)
Example Result: Cursor positioned over a toolbar icon.

Implementation Examples

Field Setup - Application instance: ${appInstance} - Element: the toolbar icon identified by the UI Automation Inspector

Execution Parameters - X-coordinate offset: 0 - Y-coordinate offset: 0

Technical Notes

Label and Label match type provide an alternative to Element for identifying the target, useful when a stable selector is not available. Provide either Element or Label, not both.