Determine-If-Image-Exists
Command Description
Find the image in the specified range. True = found. False = otherwise
Command Prototype
bRet = Image.Exists(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 |
return
bRet，The variable used to save the output of the command.
Demo
TracePrint "--------------------Determine whether the image exists--------------------"
// --------------------------------------------------------
// [Remarks] To determine whether the image exists, 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).Type:Dict
// Output parameters:
// bRet--The variable to which the output of the function call is saved
// 命令原型:bRet = Image.Exists(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)
// --------------------------------------------------------
bRet = Image.Exists(@ui"window_www.vrbrothers.com/cn/wqm/demo/pages/Demo-Compl7",{"x": 0, "y": 0, " width": 0, "height": 0},@res"28bd5770-ae65-11ec-896f-a79dc01a345c.png",0.9,10000,{"bContinueOnError": false, "iDelayAfter": 300 , "iDelayBefore": 200, "bSetForeground": true, "sMatchType":"GrayMatch"})
TracePrint(bRet)