Mouse actions

How to use the mouse actions

The mouse actions are usable for all applications, including for mobile applications (the click corresponds to a tap on the screen).

The menu is accessible directly in the toolbar, or by dropping a locator in the editor:

Mouse menu in the Agilitest editor...
...or by dropping a locator

In both cases, the menus are identical.

The possibilities of actions are as follows:

Mouse click

By clicking on the edition of the generated action, you have access to a sub-menu that allows you to select the type of click you want to generate: left click, scroll wheel, right, double-click, and pressing the key CONTROL or SHIFT.

Mouse clic menu

By default the click is in the center of the element.

However, you may want to click on a staggered area or on another element whose Cartesian coordinates you know relative to the selected interface element.

For this, you can select a corner, or side of the element from which you will specify a cartesian offset.

The positive coordinates always define a point inside the element. For example, if you select the right / top corner and an offset of 10 in x and 10 in Y, the point of the click will be inside the bounding box of the interface element, 10 pixels to left and bottom of the top / right point.

Cartesian coordinate click


Hovering lets you indicate that you want to fly over a specific area of ​​the screen.

For example, this allows you to activate drop-down menus.

In this case, the positioning in Cartesian coordinates also works.

Hover a specific cartesian coordinate

Drag, swipe, drop

The drag, swipe, and drop actions simulate a movement of the mouse during which the left mouse button is held down. Actions must be performed in this order:

  • Begin with a drag action by defining the element from which the user wishes to start his left click and maintain it.
  • Insert zero or more sweeping actions: definitions of scan areas that are visited by the mouse with the mouse button held down.
  • a drop action by defining the element on which the mouse button is released.

This action is very often used to perform drag-drop operations between several windows of one or more applications.

Drag, drop, swipe actions


The scroll action simulates a rotation of the mouse wheel causing scrolling of the displayed page. In the case of a mobile application, the scrolling results in a swipe action of the screen (swipe).

In both cases, Agilitest is used to indicate the number of pixels scrolling up or down. This number is positive if you want to scroll down.

To be effective, the selected interface element must answer to a scrolling action. You can perform this action on the main application window by not selecting an interface element.

Scroll action using the application root  

The action is usable on sub-windows, DIV, which have scrolling options, by selecting the element including the desired window.

Still require support?
Contact support