桌面程序控制-窗口操作

显示全部

窗口操作

桌面程序控制 / 窗口操作类动作。

激活窗口

activate_window

桌面程序控制窗口操作

用途：激活指定窗口，支持显式句柄、标题关键字或上下文窗口。

写法：激活窗口 [窗口句柄=<窗口句柄>] [窗口关键字=<窗口关键字>] [窗口状态=<窗口状态>]

保存为

默认保存主结果，通常就是 是否成功 这个字段。

正确示例

激活窗口 窗口句柄=123456 窗口关键字="示例值"

错误示例

激活窗口 窗口句柄=123456 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
窗口句柄	`hwnd`	可选；显式指定窗口句柄时优先使用它；激活成功后会写入上下文。	否	无
窗口关键字	`window_keyword`	可选；按窗口标题关键字查找窗口；不传 hwnd 时才会使用它。	否	无
窗口状态	`window_state`	可选；支持正常、最大化、置顶。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`是否成功`	boolean	是	未提供说明
`是否找到窗口`	boolean	是	未提供说明
`窗口`	object \| null	是	未提供说明

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

置顶窗口

set_window_top

桌面程序控制窗口操作

用途：把指定窗口置顶。

写法：置顶窗口窗口关键词=<窗口关键词>

保存为

默认保存主结果，通常就是 是否找到窗口 这个字段。

正确示例

置顶窗口 窗口关键词="示例值"

错误示例

置顶窗口

为什么错：漏写了必填参数：窗口关键词。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
窗口关键词	`window_keyword`	窗口标题关键字；命中后会置顶窗口。	是	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`是否找到窗口`	boolean	是	未提供说明

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

列出窗口

list_desktop_windows

桌面程序控制窗口操作

用途：列出当前桌面窗口，支持按标题关键字或类名过滤。

写法：列出窗口 [窗口关键字=<窗口关键字>] [类名=<类名>] [仅可见窗口=<仅可见窗口>]

保存为

默认保存主结果，通常就是 窗口列表 这个字段。

正确示例

列出窗口 窗口关键字="示例值" 类名="示例名称"

错误示例

列出窗口 窗口关键字="示例值" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
窗口关键字	`window_keyword`	可选；只返回标题中包含该关键字的窗口。	否	无
类名	`class_name`	可选；只返回类名完全匹配的窗口。	否	无
仅可见窗口	`visible_only`	可选；默认只返回可见窗口。	否	True

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`窗口列表`	array	是	未提供说明
`窗口列表[*]`	object	否	数组元素
`窗口列表[*].窗口句柄`	integer	是	未提供说明
`窗口列表[*].标题`	string	是	未提供说明
`窗口列表[*].类名`	string	是	未提供说明
`窗口列表[*].进程ID`	integer	是	未提供说明
`窗口列表[*].进程名`	string	是	未提供说明
`窗口列表[*].进程路径`	string	是	未提供说明
`窗口列表[*].是否可见`	boolean \| null	是	未提供说明
`窗口列表[*].是否可用`	boolean \| null	是	未提供说明
`窗口列表[*].父窗口句柄`	integer	是	未提供说明
`窗口列表[*].矩形`	object \| null	是	未提供说明
`数量`	integer	是	未提供说明

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

获取窗口信息

get_window_info

桌面程序控制窗口操作

用途：按窗口句柄、关键字或上下文窗口获取窗口信息。

写法：获取窗口信息 [窗口句柄=<窗口句柄>] [窗口关键字=<窗口关键字>]

保存为

默认保存主结果，通常就是 窗口 这个字段。

正确示例

获取窗口信息 窗口句柄=123456 窗口关键字="示例值"

错误示例

获取窗口信息 窗口句柄=123456 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
窗口句柄	`hwnd`	可选；显式指定窗口句柄时优先使用它。	否	无
窗口关键字	`window_keyword`	可选；按窗口标题关键字查找窗口；不传 hwnd 时才会使用它。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`是否找到窗口`	boolean	是	未提供说明
`窗口`	object \| null	是	未提供说明

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

关闭干扰弹窗

clear_interrupt_popups

桌面程序控制窗口操作

用途：机会型清理常见弹窗，不存在则跳过。

写法：关闭干扰弹窗 [要关闭的弹窗=<要关闭的弹窗>] [最多尝试轮数=<最多尝试轮数>] [每轮等待秒数=<每轮等待秒数>]

保存为

默认保存主结果，通常就是 已点击图标 这个字段。

正确示例

关闭干扰弹窗

# 说明：按默认取消、确定、关闭按钮清理弹窗

错误示例

关闭干扰弹窗 要关闭的弹窗="示例值" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
要关闭的弹窗	`icons`	未提供说明	否	取消按扭,确定按扭,关闭按扭
最多尝试轮数	`repeat_count`	未提供说明	否	2
每轮等待秒数	`interval`	未提供说明	否	0.15

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`已点击图标`	array	是	未提供说明
`已点击图标[*]`	string	否	数组元素

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

关闭窗口

close_window

桌面程序控制窗口操作

用途：关闭匹配到的窗口，支持按句柄、标题关键字、类名、进程名或进程 ID 定位。

写法：关闭窗口 [窗口句柄=<窗口句柄>] [窗口关键字=<窗口关键字>] [类名=<类名>] [进程名=<进程名>] [进程ID=<进程ID>] [关闭数量=<关闭数量>] [仅可见窗口=<仅可见窗口>]

保存为

默认保存主结果，通常就是 关闭数量 这个字段。

正确示例

关闭窗口 窗口关键字="剪映"

# 说明：关闭一个标题里包含“剪映”的窗口。

错误示例

关闭窗口 窗口句柄=123456 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
窗口句柄	`hwnd`	可选；显式指定窗口句柄时优先关闭该窗口。	否	无
窗口关键字	`window_keyword`	可选；按窗口标题关键字筛选要关闭的窗口。	否	无
类名	`class_name`	可选；按窗口类名精确筛选要关闭的窗口。	否	无
进程名	`process_name`	可选；按进程名筛选要关闭的窗口，例如 JianyingPro.exe 或 notepad.exe。	否	无
进程ID	`process_id`	可选；按进程 ID 筛选要关闭的窗口。	否	无
关闭数量	`close_count`	可选；传正整数表示最多关闭多少个窗口，传“全部”表示关闭全部命中窗口。	否	1
仅可见窗口	`visible_only`	可选；默认只关闭当前可见窗口。	否	True

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`是否成功`	boolean	是	未提供说明
`是否找到窗口`	boolean	是	未提供说明
`关闭数量`	integer	是	未提供说明
`命中窗口列表`	array	是	未提供说明

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