Help files

Move Mouse to Image Action

Description:

This Action moves the mouse over an image found on the screen or on the foreground window. This Action uses the Image Recognition feature.

movemousetoimage.png
movemousetoimage2.png
Properties:

Image to move mouse on:

This is the Image that the action will move the mouse to. Press 'Capture Image' to select the image. If you need to open a menu or perform steps first, press 'Capture with Delay'.

Search for Image on:

Choose whether you want to search for the specified Image in the foremost Window only, or the entire visible screen. Neither choice will find the Image if it is not clearly visible on the screen.

Search Mode:

Specify whether you want to scan the entire screen (or window) to find the supplied image or only a narrowed down subregion of it.

X1, Y1, X2, Y2:

Specify the subregion of the screen or window to narrow down the scan for the supplied image to. You can visually select a subregion of the screen or window by pressing the "Select a Different Subregion" button.

Mouse position relative to image:

Choose which section of the image the mouse will be moved to.

Offset X:

Offset the mouse from the Position by this many pixels to the right.

Offset Y:

Offset the mouse from the Position by this many pixels down.

Tolerance:

Specify a value for how much the Image searched for can differ from the originally chosen Image.

Move Mouse From Previous Position:

Choose the style of movement in which the mouse will move from its current position to the position of the image found. The mouse can move instantly (jump) to the new position or navigate smoothly at three different speeds (slow/normal/fast).

Location of Image Found:

Enter the names to be the variables that will hold the X and Y coordinate of the point where the image is found on the screen. If the image is being searched for on the foreground window, the coordinates returned are relative to the top left corner of the window.

Wait for image to appear:

Choose whether you want the action to wait if the image is not found on the screen or foreground window. If this property is not checked and the image is not found the action will through an exception, otherwise the action will wait until the image appears. In the next property, you can specify the maximum number of seconds (timeout) to wait.

Fail if image does not appear within x seconds:

Choose whether the Action should wait indefinitely for the image to appear or it will throw an exception after a set number of seconds if the specified Image has not been found. You can then go to the Exception Handling tab at the top to specify how the Exception will be handled, otherwise, if the image is not found within the timeout, the Process will stop and issue an error message.

Send a Left Click after moving mouse:

Choose whether you want the Action to send a left click after the mouse is positioned over the image.