窗口操作
移动、置顶、显示或关闭指定的 Windows 窗口。要先按标题或进程找到窗口,用 获取窗口信息/查找窗口。
当前模块定义
sys:windowOperations输入 11 · 输出 2 · 枚举 2
输入参数
- 类型
typeEnum必填操作类型
12 个选项移动窗口、移动窗口(增强、置顶窗口
移动窗口默认move移动窗口(增强move_ex置顶窗口setTopmost切换置顶状态toggleTopMost取消置顶窗口removeTopmost置底窗口setBottom设置显示状态show设置为前台窗口SET_FOREGROUND关闭close强制关闭kill设置或更新透明度set_trans设置边框颜色setBorderColor - 窗口句柄
hWndInteger可选要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
- X坐标
xInteger可选窗口左上角X坐标
- Y坐标
yInteger可选窗口左上角Y坐标
- 宽度
widthInteger可选窗口宽度。-1时表示不更改窗口尺寸。
- 高度
heightInteger可选窗口高度。-1时表示不更改窗口尺寸。
- 目标位置
areaText可选窗口左,上,右,下的位置坐标
- 显示状态
showCmdEnum必填窗口显示状态,具体说明请参考Win32接口。
6 个选项最大化(SW_MAXIMIZE、最小化(SW_MINIMIZE、显示并恢复大小(SW_RESTORE
最大化(SW_MAXIMIZE默认3最小化(SW_MINIMIZE6显示并恢复大小(SW_RESTORE9隐藏(SW_HIDE0显示(SW_SHOW5切换最大化/恢复TOGGLE_MAXMIZE - 不透明度Alpha
alphaText可选数字0-255:0为全透明,255为不透明。-数字:将当前透明度增加一些。+数字:将透明度减少一些。
- 窗口边框颜色
borderColorText可选颜色格式:#RRGGBB。留空表示去除边框颜色。
- 失败后停止
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 是否置顶
isTopmostBoolean操作后窗口是否为置顶
概述
窗口句柄 留空或 0 表示操作前台窗口。换 类型 后会显示对应参数。
窗口操作
Window窗口相关操作
参数说明
类型:移动窗口、移动窗口(增强)、置顶窗口、切换置顶状态、取消置顶窗口、置底窗口、设置显示状态、设置为前台窗口、关闭、强制关闭、设置或更新透明度、设置边框颜色。
窗口句柄:要操作的窗口句柄。留空表示前台窗口。
失败后停止:失败是否中止动作。默认开启。
移动窗口
窗口操作
Window窗口相关操作
X坐标 / Y坐标:窗口左上角。屏幕左上角为 0,0,向右 X 增加,向下 Y 增加。
宽度 / 高度:像素。-1 或小于 0 表示不改尺寸。
移动窗口(增强)
按百分比或像素指定左、上、右、下:
50%,0,100%,100%:右侧半屏25%,25%,75%,75%:屏幕中央、约为屏幕 1/4100,100,500,500:绝对坐标100,100,50%,50%:像素和百分比混用
窗口操作
Window窗口相关操作
目标位置:左,上,右,下。

置顶 / 置底 / 前台 / 关闭
- 置顶窗口 / 切换置顶状态 / 取消置顶窗口:改置顶。
- 置底窗口:把窗口放到其它窗口后面。
- 设置为前台窗口:显示并取得焦点。
- 关闭:相当于点右上角 ×,窗口可能询问是否保存。
- 强制关闭:可能造成数据丢失。
设置显示状态
窗口操作
Window窗口相关操作
显示状态:最大化、最小化、显示并恢复大小、隐藏、显示、切换最大化/恢复。对应 Win32 ShowWindow。
设置或更新透明度
窗口操作
Window窗口相关操作
不透明度Alpha:
0–255的整数:0全透明,255不透明。+数字:减少透明度(更不透明),加号不能省。-数字:增加透明度(更透明)。
设置边框颜色
窗口边框颜色:#RRGGBB。留空表示去掉边框颜色。
输出
- 是否成功
- 是否置顶:仅 切换置顶状态。操作后窗口是否置顶。
限制与排障
部分全屏或受保护窗口无法移动或改透明度。强制关闭前确认没有未保存内容。1.24.28 起支持更多操作类型。
相关链接
更新于