Find Image on Element#

This block allows you to save an image of a section of a control element (application window, panel, or another element within the window) during the development of the Robot, and then during the execution of the script, the Robot will find a similar section of the screen (even if it is in a different location on the screen) and return the coordinates of the top-left corner of the found image.

Selector[Selector] The identifier of the user interface element within which the specified image needs to be found.
Process ID

[Link] A variable that stores the Process ID. Indicates which application needs to be worked with.

If the specified application is minimized or its window is covered by other windows, it will be brought to the foreground. When working with browsers, the Process ID additionally specifies the particular browser tab that the block should work with.

If the property is left empty, or if the Process ID variable was not previously assigned at the moment of launching the application or opening the browser, the application and browser tab will be determined from the content of the corresponding selector line.

The Process ID can be obtained, for example, using the "Launch Application" or "Get Process" blocks.

ImageThe identifier of the sought image. The image itself is saved in the project's Images folder and is included in the Robot file upon publication.
Image Number[Number] The ordinal number of the found image. Numbering starts from zero.
Comparison TypeSelection of the type of image comparison.
Match Threshold[Number] The match threshold. The value is set in percentage from 0 to 100.
Timeout[Number] The maximum timeout for the image to appear in seconds.
X Coordinate[Number] The X coordinate of the found image.
Y Coordinate[Number] The Y coordinate of the found image.
Error Handling Level

Selection of the error handling level. Possible values:

  • "Default" - default;
  • "Ignore" - errors are ignored;
  • "Handle" - errors are handled.

If "Default" is selected, the value of the "Start" block of this diagram will be used.

Message Level

Selection of the message level that the blocks will output during operation. Possible values:

  • "Default" - default;
  • "Release" - output is disabled;
  • "Debug" - outputs main information;
  • "Detailed" - outputs detailed information.

If "Default" is selected, the value of the "Start" block of this diagram will be used.

Error Text[Text] Returns detailed information about the error in case of incorrect execution of the block's work.