智能识别后点击

命令说明

智能识别后点击元素

命令原型

UiDetection.Click(objUiElement,iButton,iType,iTimeOut,optionArgs)

命令参数

参数	必选	类型	默认值	说明
objUiElement	True	expression	{}	选取的智能识别后的目标元素及锚点元素的特征值
iButton	True	enum	"left"	鼠标按键 {left:左键, right:右键, middle:中键}
iType	True	enum	"click"	点击类型 {click:单击, dbclick:双击, down:按下, up:弹起}
iTimeOut	True	number	30000	查找目标引发异常之前等待命令重试运行的时间量，以毫秒为单位。默认30000(30秒)
bContinueOnError	False	boolean	False	指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False
iDelayAfter	False	number	300	执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒
iDelayBefore	False	number	200	活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒
bSetForeground	False	boolean	True	进行操作之前，是否先将目标窗口激活
sCursorPosition	False	enum	"Center"	描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项：TopLeft，TopRight，BottomLeft，BottomRight和Center。默认选项是Center
iCursorOffsetX	False	number	0	根据在“位置”字段中选择的选项，光标位置的水平位移
iCursorOffsetY	False	number	0	根据在“位置”字段中选择的选项，光标位置的垂直位移
sKeyModifiers	False	set	[]	触发鼠标动作时同时按下的键盘按键，可以使用以下选项：Alt，Ctrl，Shift，Win
sSimulate	False	enum	"simulate"	可选择操作类型为：后台操作(uia)、模拟操作(simulate)、系统消息(message)，默认选择：模拟操作(simulate)

运行实例

/*********************************智能识别后点击***************************************
命令原型：
     UiDetection.Click({},"left","click",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})
入参：
     objUiElement--识别目标。
     iButton--鼠标点击。注：鼠标按键 {left:左键, right:右键, middle:中键}
     iType--点击类型。注：点击类型 {click:单击, dbclick:双击, down:按下, up:弹起}  
     iTimeOut--超时时间。注：指定在SelectorNotFoundException引发异常之前等待活动运行的时间量（以毫秒为单位）。默认值为10000毫秒（10秒）
     optionArgs--可选参数(包括：错误继续执行、执行后延时、执行前延时、激活窗口、光标位置、横坐标偏移、纵坐标偏移、辅助按键、操作类型).Type:Dict
注意事项：
     1.该命令只进行点击操作，需要结合智能识别屏幕范围命令一同使用。
     2.执行命令前需要目标屏幕存在，否则会报错。
********************************************************************************/
#icon("@res:38688e20-7f20-11ec-ab08-1d7b5faf0fee.png")
UiDetection.Click({"wnd":[{"cls":"Chrome_WidgetWin_1","title":"Click - 飞书云文档 - Google Chrome","app":"chrome"}],"cv_engine_version":1,"cv_region":{"x":0,"y":0,"width":0,"height":0},"cv_descriptor":{"anchors":[{"cls_type":100,"height":41,"text":"Click","width":89,"x":584,"y":225}],"confidence":0.800000011920929,"cv_handle":"\"2b3223b0-7f20-11ec-ab08-1d7b5faf0fee\"","match_version":1,"target":{"cls_type":100,"height":41,"text":"智能识别后点击","width":205,"x":584,"y":296}}},"left","click",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})

可视化样例