鼠标输入
移动指针、点击、滚动,或按窗口、找图结果把鼠标移到目标位置。
当前模块定义
sys:mouse输入 19 · 输出 5 · 枚举 5
输入参数
- 类型
typeEnum必填操作类型
24 个选项还原鼠标位置、移动距离、移动到(x,y分别指定
还原鼠标位置默认restore移动距离move移动到(x,y分别指定moveTo移动到(x,y一同指定moveToXy单击click双击dbclick按下down抬起up滚动scroll按下CtrlctrlDown松开CtrlctrlUp按下ShiftshiftDown松开ShiftshiftUp移动到窗口位置:相对于窗口左上角toWinTL移动到窗口位置:相对于窗口右上角toWinTR移动到窗口位置:相对于窗口左下角toWinBL移动到窗口位置:相对于窗口右下角toWinBR移动到窗口位置:窗口中心toWinCenter移动到窗口位置:xy一同指定moveToWinXy移动到位图位置(图片文件locateByBitmap移动到位图位置(图片变量locateByBitmapVar获取鼠标位置(弹出面板前位置getMouseOriginPosition获取鼠标位置及指针类型(当前位置getMouseCurrentPosition显示鼠标位置提示showIndicator - 窗口句柄
hWndInteger可选目标窗口的句柄。留空或 0 表示操作前台窗口。
- 按钮
btnEnum必填操作哪个按钮
5 个选项左键、右键、中键
左键默认left右键right中键middleX1x1X2x2 - 位图路径
bmpText必填需要在屏幕中查找的位图路径。位图必须和屏幕图像完全匹配,不能压缩。此时X、Y的值为相对于搜索位图的左上角的偏移。
- 位图变量
bmpVarImage必填需要在屏幕中查找的位图。位图必须和屏幕图像完全匹配,不能压缩。此时X、Y的值为相对于搜索位图的左上角的偏移。
- 查找范围
bmpTargetTypeEnum可选位图查找范围
4 个选项主屏幕、当前窗口、坐标范围
主屏幕默认MainScreen当前窗口CurrentWindow坐标范围Rect所有屏幕AllScreens - 查找坐标范围
searchRectText可选当"查找范围"为"坐标范围"时有效,格式为:left,top,right,bottom
- 定位位置
bmpPositionEnum可选查找到图片后,鼠标指针移动到的位置
5 个选项位图中间、左上角、右上角
位图中间默认Center左上角TopLeft右上角TopRight左下角BottomLeft右下角BottomRight - 颜色容差
bmpColorErrorInteger可选匹配像素时允许每个颜色通道的偏差值0-100,0表示精确匹配,速度最快。
- 最大匹配数量
maxFindCountInteger可选找图的最大匹配数量。将对每个查找到的目标执行附加动作。
- 重试次数
retryCountInteger可选未找到位图时的重试次数。每次重试间隔300ms。
- X
xInteger必填水平方向的坐标/坐标偏移/移动距离(像素) 或 滚动数量(clicks。正值向右,负值向左)
- Y
yInteger必填垂直方向的坐标/坐标偏移/移动距离 或 滚动数量(clicks。正值向前,负值向后)
- 坐标
xyText必填格式为:x,y,如:100,200。也可以使用百分比表示,如:50%,50% 表示屏幕中心。
- 相对坐标
xyForWinText必填格式为:x,y,如:100,200(相对于窗口左上角向右100,向下200)。也可以使用百分比表示,如:50%,50% 表示窗口中心。
- 逐渐移动到目标
slowMoveBoolean可选逐渐移动而不是直接移动到目标位置。
- 移动后操作
extActionEnum必填移动位置后,需要执行的动作
5 个选项无、左键单击、左键双击
无默认none左键单击left左键双击leftDbClick右键单击right中键单击middle - 操作完成后恢复鼠标位置
restoreMousePosBoolean可选 - 失败后中止动作
stopIfFailBoolean可选获取位置失败后,是否停止后续动作的执行。
输出参数
- 找图定位是否成功
isSuccessBoolean操作是否成功
- 鼠标位置
mouseLocationText格式为X,Y的文本
- 鼠标位置X
mouseXInteger鼠标位置X坐标
- 鼠标位置Y
mouseYInteger鼠标位置Y坐标
- 光标类型
cursorTypeText当前的鼠标指针形状类型
概述
先选 类型,再填该类型需要的坐标、按钮或找图参数。默认类型是 还原鼠标位置。
鼠标输入
屏幕坐标
主屏幕左上角是原点 (0, 0)。多屏时仍以主屏左上角为原点。X 向右增大,Y 向下增大。在下图里移动指针,可直接读出坐标。
通用参数
这些项只在部分类型下出现。
移动后操作:移到目标后立刻执行的点击。可选:无、左键单击、左键双击、右键单击、中键单击。
操作完成后恢复鼠标位置:点完后把指针移回操作前的位置。
逐渐移动到目标:分成多次挪过去,用来触发某些软件对“鼠标经过”的响应。
窗口句柄:相对窗口定位时指定目标窗口。留空或 0 表示前台窗口(当前有输入焦点的窗口)。句柄是 Windows 给窗口的数字,可用获取窗口类模块得到。
操作类型
还原鼠标位置
把指针送回弹出 Quicker 面板之前的位置。用面板点选动作时指针会先移到动作上,需要在原处点击时用这个类型。
用悬浮按钮、悬浮面板或快捷键触发时,拿不到“弹出面板前”的位置,这一步会无效。
移动距离
从当前位置平移,单位像素。X 正右负左,Y 正下负上。
鼠标输入
移动到(x、y 分别指定)
移到屏幕绝对坐标,X、Y 分两个参数。
鼠标输入
移动到(x、y 一同指定)
一个文本参数写 x,y,例如 100,200。也可用百分比:50%,50% 是屏幕中心,50%,100 是水平居中、Y=100。
软件里可点坐标框右侧准星,在屏幕上点选。也可用 Snipaste 等工具读坐标。
鼠标输入
单击、双击、按下、抬起
在当前指针位置发送按键事件。按钮可选左键、右键、中键、X1、X2。
鼠标输入
滚动
对指针所在窗口发送滚轮消息。X、Y 填 click 数(通常一格滚轮 = 1 click):
- Y:正值向前(向上翻),负值向后(向下翻)
- X:正值向右,负值向左
鼠标输入
不要用悬浮按钮直接触发滚动(指针还在按钮上)。用面板触发时,若动作一开始就滚,先加等待时间等面板关掉。有的软件要循环发多次滚动才生效。
按下 / 松开 Ctrl、Shift
用来做「Ctrl + 点击」这类组合:先按下修饰键,再鼠标,再松开。也可以改用按键操作。修饰键和鼠标步骤之间建议加 10ms 以上延时(键盘、鼠标不在同一消息队列)。
移动到窗口位置
窗口位置或大小会变、但目标相对窗口固定时用。参考点:左上、右上、左下、右下、中心。
X / Y 是相对参考点的偏移,X 正右、Y 正下。相对右下角时,偏移通常是负值才能落到窗口内。
鼠标输入
移动到窗口位置:xy 一同指定 效果相当于相对左上角,但用一个字符串:100,200 或 50%,50%(窗口中心)。
鼠标输入
获取鼠标位置
获取鼠标位置(弹出面板前位置):和「还原鼠标位置」用的是同一处坐标。
鼠标输入
获取鼠标位置及指针类型(当前位置):取执行到这一步时的指针位置和形状,不是弹出面板前。
鼠标输入
光标类型常见值:Arrow(默认)、IBeam(文本)、Hand(链接)、SizeAll / SizeWE / SizeNS / SizeNESW / SizeNWSE(移动或拉伸)、Wait、Appstarting。认不出来时返回原始数字。请在目标软件里实测。
显示鼠标位置提示
在当前指针处播一个由小变大的水波纹,用来标位置。
点击示意区可重播
鼠标输入
移动到位图位置(找图)
按小图在屏幕或窗口里查找,找到后把指针移过去。位图必须和屏幕像素一致,不能压缩。
只找位置、或要自己决定怎么点,请用屏幕找图。后续新动作也建议用那个模块。容错更高可用子程序 屏幕找图增强版。
位图路径 / 位图变量:要找的小图。
查找范围:主屏幕、当前窗口、所有屏幕,或 坐标范围(再填 查找坐标范围,格式 left,top,right,bottom)。
定位位置:移到匹配区域的中间或四角。下图 A 是左上角,B 是中间。

颜色容差:每个颜色通道允许的偏差,0–100。0 是精确匹配,最快。默认 10。
最大匹配数量:最多处理几个匹配;每个匹配都会执行 移动后操作。默认 1。
重试次数:找不到时重试,每次间隔 300ms。
X / Y:在定位点上再偏移。
失败后中止动作:找不到是否停掉后面的步骤。默认开启。
找图定位是否成功:布尔输出。
鼠标输入
示例:截图后点击匹配位置
先截一块图存进 img,再循环找图并点击。参考 分享动作。
限制与排障
- 滚动只作用在指针所在窗口。悬浮按钮触发时指针还在按钮上,滚动会打偏。
- Ctrl/Shift + 鼠标时,键盘步骤和鼠标步骤之间加 10ms 以上延时。
- 「还原 / 获取弹出面板前位置」依赖面板触发;快捷键、悬浮按钮没有这个坐标。
- 找图对压缩、缩放、主题变化敏感;对不上就加大容差,或改用屏幕找图。
相关链接
更新于