桌面程序控制-图标与截图

图标与截图

桌面程序控制 / 图标与截图 类动作。

截图

capture_screenshot

桌面程序控制图标与截图

用途:保存当前窗口或屏幕截图。

写法:截图 图片路径=<图片路径> [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 图片路径 这个字段。

正确示例

截图 图片路径="D:/output/screen.png"

# 说明:保存当前窗口或全屏截图

错误示例

截图 窗口句柄=123456

为什么错:漏写了必填参数:图片路径。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
图片路径image_path截图文件保存路径。建议使用 .png。
窗口句柄hwnd可选;显式指定窗口句柄时优先截取该窗口,不传时回退到上下文窗口;两者都没有时截全屏。

返回结果

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

返回结果

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

字段路径类型必有说明
图片路径string未提供说明
文件大小字节integer | null未提供说明
图片尺寸object | null未提供说明
截图原点object未提供说明
截图原点.xinteger未提供说明
截图原点.yinteger未提供说明
截图范围string未提供说明
截图坐标系string未提供说明
DPI比例number未提供说明

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

查找屏幕图标

find_screen_icon

桌面程序控制图标与截图

用途:查找当前屏幕上的图标,返回查找结果和命中详情。

写法:查找屏幕图标 图标=<图标> [窗口句柄=<窗口句柄>]

保存为

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

正确示例

查找屏幕图标 图标="导出按钮" 窗口句柄=123456

错误示例

查找屏幕图标 窗口句柄=123456

为什么错:漏写了必填参数:图标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
图标icon未提供说明
窗口句柄hwnd未提供说明

返回结果

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

返回结果

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

字段路径类型必有说明
查找结果string未提供说明
是否找到boolean未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
位置object | null未提供说明
图标string | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
匹配度number | null未提供说明
截图尺寸object | null未提供说明

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

等待图标出现

wait_screen_icon_appear

桌面程序控制图标与截图

用途:等待图标出现。

写法:等待图标出现 图标=<图标> [最多等多久=<最多等多久>] [隔多久看一次=<隔多久看一次>] [窗口句柄=<窗口句柄>]

保存为

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

正确示例

等待图标出现 图标="导出按钮" 最多等多久=1

错误示例

等待图标出现 最多等多久=1

为什么错:漏写了必填参数:图标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
图标icon未提供说明
最多等多久timeout未提供说明-1
隔多久看一次interval未提供说明
窗口句柄hwnd未提供说明

返回结果

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

返回结果

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

字段路径类型必有说明
查找结果string未提供说明
是否找到boolean未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
位置object | null未提供说明
图标string | null未提供说明
坐标Xinteger | null未提供说明
坐标Yinteger | null未提供说明
匹配度number | null未提供说明
截图尺寸object | null未提供说明

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

等待图标消失

wait_screen_icon_disappear

桌面程序控制图标与截图

用途:等待图标消失。

写法:等待图标消失 图标=<图标> [最多等多久=<最多等多久>] [隔多久看一次=<隔多久看一次>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 是否已消失 这个字段。

正确示例

等待图标消失 图标="导出按钮" 最多等多久=1

错误示例

等待图标消失 最多等多久=1

为什么错:漏写了必填参数:图标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
图标icon未提供说明
最多等多久timeout未提供说明-1
隔多久看一次interval未提供说明
窗口句柄hwnd未提供说明

返回结果

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

返回结果

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

字段路径类型必有说明
是否已消失boolean未提供说明
查找结果string未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明

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

找到就点击图标

click_icon_if_found

桌面程序控制图标与截图

用途:图标存在就点击,不存在或缺少图标时返回是否点击=False。

写法:找到就点击图标 图标=<图标> [随机偏移=<随机偏移>] [点击前等待=<点击前等待>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 是否点击 这个字段。

正确示例

找到就点击图标 图标='取消按钮'

# 说明:找到取消按钮就点,找不到就跳过

错误示例

找到就点击图标 随机偏移="10,-5"

为什么错:漏写了必填参数:图标。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
图标icon要匹配的图标模板名。
随机偏移random_offset可写 cell_w,cell_h,columns,rows;表示在图标库默认点击点基础上追加网格随机偏移,按 100% 缩放基准填写。
点击前等待before_wait执行识图点击前先等待的秒数。0
窗口句柄hwnd未提供说明

返回结果

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

返回结果

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

字段路径类型必有说明
是否点击boolean未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
是否命中图标boolean未提供说明

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