Find-Image
Command Description
Find the image in the specified area
Command Prototype
objPoint = Image.Find(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)
Parameter Description
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| objUiElement | True | decorator | @ui"" | When the attribute is transferred as a string, it is used as the characteristic string to find the interface element. When the attribute is transferred as UiElement, directly click on the corresponding interface element |
| objRect | True | dictionary | {"x": 0, "y": 0, "width": 0, "height": 0} | Perform text recognition in the search area. If the area is passed as {"x":0,"y":0,"width":0,"height":0}, then the text will be recognized in the rectangle area of the control element |
| sImagePath | True | path | '''C:\Users''' | The path of the image to be found, generally in the res folder |
| iAccuracy | True | number | 0.9 | Similarity to be used for finding images, ranging from 0.5 - 1.0, ie. similarity of 50% - 100% |
| iTimeOut | True | number | 10000 | Specify the amount of time (in milliseconds) that wait for the event to run before selectorNotFoundException to trigger an error (in milliseconds) The default value is 10,000 ms (10 seconds) |
| bContinueOnError | None | boolean | None | Specify whether the automation should continue to support this field even if the activity is incorrect, it is only supported by the Boolean value (true, false) default value |
| iDelayAfter | None | number | 300 | Delay time (in milliseconds) after executing the activity is 300 milliseconds |
| iDelayBefore | None | number | 200 | The delay time (in milliseconds) before any operations are executed is by default 200 milliseconds |
| bSetForeground | None | boolean | True | Whether to activate the target window before executing |
| sMatchType | None | enum | "GrayMatch" | Specify a match type for an image. Gray-scale matching is fast, but it may fail in extreme situations. The color matching is more accurate, but the matching speed is slightly slower |
| iSerialNo | None | number | 1 | The specified image is matched to multiple targets. The sequence number of the targets is a positive integer starting from 1 and increases from left to right and from top to botton on the screen. The sequence number of the target closest to the upper left corner of the screen is 1 |
return
objPoint，The variable used to save the output of the command.
Demo
TracePrint "--------------------Find Image--------------------"
// --------------------------------------------------------
// [Remarks] To find images, the Demo needs to use IE to open the URL below
// url: http://www.vrbrothers.com/cn/wqm/demo/pages/Demo-ComplexForm.aspx
// Input parameter 1:
// objUiElement--target element
// Input parameter 2:
// objRect--identification range
// Input parameter 3:
// sImagePath--find pictures
// Input parameter 4:
// iAccuracy--similarity
// Input parameter 5:
// iTimeOut--timeout time. Default unit: milliseconds. Type: Int
// Input parameter 6:
// optionArgs--Optional parameters (including: error continue execution/delay after execution/delay before execution/activation window/matching method/matching number).Type:Dict
// Output parameters:
// objPoint--the variable to which the output of the function call is saved
// 命令原型:objPoint = Image.Find(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)
// --------------------------------------------------------
objPoint = Image.Find (@ui "Yuguchi_www.vrbrothers.com/cn/wqm/demo/pages/Demo-Compl6", {"x": 0, "y": 0, " width ": 0, " height ": 0}, @ res" efec82e0-ae64-11ec-896f-a79dc01a345c.png ", 0.9,10000, {"bContinueOnError ": false, " iDelayAfter ": 300 , "iDelayBefore": 200, "bSetForeground": true, "sMatchType": "GrayMatch", "iSerialNo": 1})
TracePrint(objPoint)