桌面程序控制-鼠标操作

鼠标操作

桌面程序控制 / 鼠标操作 类动作。

点击

mouse_click

桌面程序控制鼠标操作

用途:点击图标或坐标

写法:点击 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

点击 目标='导出按钮,导出按钮2' 随机偏移='4,6,3,2'

# 说明:按候选图标点击,并在默认点位附近随机点击

错误示例

点击 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

双击

mouse_double_click

桌面程序控制鼠标操作

用途:双击图标或坐标

写法:双击 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

双击 坐标='100,200,300,400'

# 说明:在随机范围内双击

错误示例

双击 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

右键点击

mouse_right_click

桌面程序控制鼠标操作

用途:右键点击图标或坐标

写法:右键点击 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

右键点击 目标='导出按钮'

# 说明:对图标位置执行右键点击

错误示例

右键点击 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

鼠标滚动

scroll_mouse_wheel

桌面程序控制鼠标操作

用途:滚动鼠标滚轮。

写法:鼠标滚动 [滚动格数=<滚动格数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

鼠标滚动 滚动格数="示例值" 窗口句柄=123456

错误示例

鼠标滚动 滚动格数="示例值" 错误参数=1

为什么错:使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
滚动格数clicks正数通常向上滚动,负数通常向下滚动。1
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
滚动格数integer未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

移动到

mouse_move_to

桌面程序控制鼠标操作

用途:移动到图标或坐标

写法:移动到 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

移动到 目标='导出按钮'

# 说明:移动到图标位置

错误示例

移动到 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

拖动到

mouse_drag_to

桌面程序控制鼠标操作

用途:拖动到图标或坐标

写法:拖动到 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

拖动到 坐标='100,200'

# 说明:左键拖动到指定坐标

错误示例

拖动到 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

右键拖动到

mouse_right_drag_to

桌面程序控制鼠标操作

用途:右键拖动到图标或坐标

写法:右键拖动到 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

右键拖动到 目标='导出按钮'

# 说明:右键拖动到图标位置

错误示例

右键拖动到 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

中键点击

mouse_middle_click

桌面程序控制鼠标操作

用途:中键点击图标或坐标

写法:中键点击 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

中键点击 坐标='100,200'

# 说明:对坐标位置执行中键点击

错误示例

中键点击 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

中键拖动到

mouse_middle_drag_to

桌面程序控制鼠标操作

用途:中键拖动到图标或坐标

写法:中键拖动到 [目标=<目标>] [坐标=<坐标>] [随机偏移=<随机偏移>] [移动时长=<移动时长>] [执行次数=<执行次数>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

中键拖动到 坐标='100,200'

# 说明:中键拖动到指定坐标

错误示例

中键拖动到 目标="示例值" 坐标="100,200"

为什么错:这两个参数不能同时填写:目标、坐标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目标target目标内容;写图标名时按图标查找,写 100,200 或 100,200,300,400 时按坐标处理。
坐标coordinate显式指定坐标;按 100% 缩放基准填写;支持 100,200 或 100,200,300,400 随机范围。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在目标点基础上追加网格随机偏移,按 100% 缩放基准填写。
移动时长move_speed鼠标移动到目标前的过渡时长,单位秒;0 表示直接移动。0
执行次数count覆盖默认执行次数;双击通常不用手动填写。
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。坐标点击在两者都没有时会回退当前前台窗口;图标点击在两者都没有时改为全屏识图。图标固定偏移请写入图标库匹配配置。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string | null未提供说明
是否命中图标boolean | null未提供说明
窗口句柄integer | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
鼠标按钮string未提供说明
执行次数integer未提供说明
移动时长number未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

获取鼠标状态

get_mouse_state

桌面程序控制鼠标操作

用途:读取物理鼠标左右中键状态和屏幕坐标,不包含脚本模拟输入。

写法:获取鼠标状态

保存为

默认保存主结果,通常就是 状态 这个字段。

正确示例

获取鼠标状态 保存为=鼠标状态

# 说明:读取物理鼠标按键和屏幕/项目坐标。

错误示例

获取鼠标状态 错误参数=1

为什么错:使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
状态object未提供说明
状态.屏幕坐标array未提供说明
状态.屏幕坐标[*]integer数组元素
状态.项目坐标array未提供说明
状态.项目坐标[*]integer数组元素
状态.左键object未提供说明
状态.左键.是否按下boolean未提供说明
状态.左键.状态string未提供说明
状态.左键.刚刚按下boolean未提供说明
状态.左键.刚刚释放boolean未提供说明
状态.右键object未提供说明
状态.右键.是否按下boolean未提供说明
状态.右键.状态string未提供说明
状态.右键.刚刚按下boolean未提供说明
状态.右键.刚刚释放boolean未提供说明
状态.中键object未提供说明
状态.中键.是否按下boolean未提供说明
状态.中键.状态string未提供说明
状态.中键.刚刚按下boolean未提供说明
状态.中键.刚刚释放boolean未提供说明
状态.是否有按键按下boolean未提供说明
状态.来源string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 状态。