点击图像

命令原型

Image.Click(objUiElement,objRect,sImagePath,iAccuracy,iButton,iType,iTimeOut,optionArgs)

命令说明

在指定范围内搜索图像并单击它。

参数说明

必填信息

objUiElement--对应需要操作的UI元素，当参数传递为 字符串 类型时，作为特征串查找UI元素，当参数传递为 UiElement 类型时，直接对 UiElement 对应的UI元素进行点击操作。

objRect--需要查找的范围，程序会在控件这个范围内进行文字识别，如果范围传递为 {"x":0,"y":0,"width":0,"height":0}，则进行控件矩形区域范围内的文字识别。

sImagePath--要查找的图片路径，一般在res文件夹。

iAccuracy--查找图片时使用的相似度，相似度范围从 0.5 - 1.0，表示 50% - 100% 相似。

iButton--鼠标按键 {left:左键, right:右键, middle:中键}。

iType--点击类型 {click:单击, dbclick:双击, down:按下, up:弹起}。

iTimeOut-- 指定在SelectorNotFoundException引发错误之前等待活动运行的时间量（以毫秒为单位）。默认值为10000毫秒（10秒）。

可选参数

bContinueOnError--指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False。

iDelayAfter--执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒。

iDelayBefore--活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒。

bSetForeground--进行操作之前，是否先将目标窗口激活。

sCursorPosition--描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项：TopLeft，TopRight，BottomLeft，BottomRight和Center。默认选项是Center。

iCursorOffsetX--根据在“位置”字段中选择的选项，光标位置的水平位移。

iCursorOffsetY--根据在“位置”字段中选择的选项，光标位置的垂直位移。

sKeyModifiers--触发鼠标动作时同时按下的键盘按键，可以使用以下选项：Alt，Ctrl，Shift，Win。

sSimulate--模拟类型， {default:默认UIA方式, simulate:模拟点击, message:windows消息}。

sMatchType--指定查找图像的匹配方式，“灰度匹配”速度快，但在极端情况下可能会匹配失败，“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。

iSerialNo--指定图像匹配到多个目标时的序号，序号为从1开始的正整数，在屏幕上从左到右从上到下依次递增，匹配到最靠近屏幕左上角的目标序号为1。