跳到主要内容

窗口操作

移动、置顶、显示或关闭指定的 Windows 窗口。要先按标题或进程找到窗口,用 获取窗口信息/查找窗口

当前模块定义

sys:windowOperationsWindows系统Action
标准模块
输入 11 · 输出 2 · 枚举 2

输入参数

  • 类型typeEnum必填

    操作类型

    填写 固定输入默认 move
    12 个选项移动窗口、移动窗口(增强、置顶窗口
    移动窗口默认move
    移动窗口(增强move_ex
    置顶窗口setTopmost
    切换置顶状态toggleTopMost
    取消置顶窗口removeTopmost
    置底窗口setBottom
    设置显示状态show
    设置为前台窗口SET_FOREGROUND
    关闭close
    强制关闭kill
    设置或更新透明度set_trans
    设置边框颜色setBorderColor
  • 窗口句柄hWndInteger可选

    要操作的窗口句柄(数字)。0或留空表示操作前台窗口。

    填写 输入或变量
  • X坐标xInteger可选

    窗口左上角X坐标

    填写 输入或变量条件 仅:move默认 100
  • Y坐标yInteger可选

    窗口左上角Y坐标

    填写 输入或变量条件 仅:move默认 100
  • 宽度widthInteger可选

    窗口宽度。-1时表示不更改窗口尺寸。

    填写 输入或变量条件 仅:move默认 500
  • 高度heightInteger可选

    窗口高度。-1时表示不更改窗口尺寸。

    填写 输入或变量条件 仅:move默认 500
  • 目标位置areaText可选

    窗口左,上,右,下的位置坐标

    填写 输入或变量条件 仅:move_ex默认 25%,25%,75%,75%
  • 显示状态showCmdEnum必填

    窗口显示状态,具体说明请参考Win32接口。

    填写 固定输入条件 仅:show默认 3
    6 个选项最大化(SW_MAXIMIZE、最小化(SW_MINIMIZE、显示并恢复大小(SW_RESTORE
    最大化(SW_MAXIMIZE默认3
    最小化(SW_MINIMIZE6
    显示并恢复大小(SW_RESTORE9
    隐藏(SW_HIDE0
    显示(SW_SHOW5
    切换最大化/恢复TOGGLE_MAXMIZE
  • 不透明度AlphaalphaText可选

    数字0-255:0为全透明,255为不透明。-数字:将当前透明度增加一些。+数字:将透明度减少一些。

    填写 输入或变量条件 仅:set_trans默认 128
  • 窗口边框颜色borderColorText可选

    颜色格式:#RRGGBB。留空表示去除边框颜色。

    填写 输入或变量条件 仅:setBorderColor
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 是否置顶isTopmostBoolean

    操作后窗口是否为置顶

    条件 仅:toggleTopMost

概述

窗口句柄 留空或 0 表示操作前台窗口。换 类型 后会显示对应参数。

窗口操作

Window窗口相关操作
类型
操作类型
窗口句柄
 
要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
X坐标
100
窗口左上角X坐标
Y坐标
100
窗口左上角Y坐标
宽度
500
窗口宽度。-1时表示不更改窗口尺寸。
高度
500
窗口高度。-1时表示不更改窗口尺寸。
是否成功
-- 选择变量 --
操作是否成功

参数说明

类型:移动窗口、移动窗口(增强)、置顶窗口、切换置顶状态、取消置顶窗口、置底窗口、设置显示状态、设置为前台窗口、关闭、强制关闭、设置或更新透明度、设置边框颜色。

窗口句柄:要操作的窗口句柄。留空表示前台窗口。

失败后停止:失败是否中止动作。默认开启。

移动窗口

窗口操作

Window窗口相关操作
类型
操作类型
窗口句柄
 
要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
X坐标
100
窗口左上角X坐标
Y坐标
100
窗口左上角Y坐标
宽度
500
窗口宽度。-1时表示不更改窗口尺寸。
高度
500
窗口高度。-1时表示不更改窗口尺寸。

X坐标 / Y坐标:窗口左上角。屏幕左上角为 0,0,向右 X 增加,向下 Y 增加。

宽度 / 高度:像素。-1 或小于 0 表示不改尺寸。

移动窗口(增强)

按百分比或像素指定左、上、右、下:

  • 50%,0,100%,100%:右侧半屏
  • 25%,25%,75%,75%:屏幕中央、约为屏幕 1/4
  • 100,100,500,500:绝对坐标
  • 100,100,50%,50%:像素和百分比混用

窗口操作

Window窗口相关操作
类型
操作类型
窗口句柄
 
要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
目标位置
25%,25%,75%,75%
窗口左,上,右,下的位置坐标

目标位置左,上,右,下

置顶 / 置底 / 前台 / 关闭

  • 置顶窗口 / 切换置顶状态 / 取消置顶窗口:改置顶。
  • 置底窗口:把窗口放到其它窗口后面。
  • 设置为前台窗口:显示并取得焦点。
  • 关闭:相当于点右上角 ×,窗口可能询问是否保存。
  • 强制关闭:可能造成数据丢失。

设置显示状态

窗口操作

Window窗口相关操作
类型
操作类型
窗口句柄
 
要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
显示状态
窗口显示状态,具体说明请参考Win32接口。
是否成功
-- 选择变量 --
操作是否成功

显示状态:最大化、最小化、显示并恢复大小、隐藏、显示、切换最大化/恢复。对应 Win32 ShowWindow

设置或更新透明度

窗口操作

Window窗口相关操作
类型
操作类型
窗口句柄
 
要操作的窗口句柄(数字)。0或留空表示操作前台窗口。
不透明度Alpha
128
数字0-255:0为全透明,255为不透明。-数字:将当前透明度增加一些。+数字:将透明度减少一些。

不透明度Alpha

  • 0255 的整数:0 全透明,255 不透明。
  • +数字:减少透明度(更不透明),加号不能省。
  • -数字:增加透明度(更透明)。

设置边框颜色

窗口边框颜色#RRGGBB。留空表示去掉边框颜色。

输出

  • 是否成功
  • 是否置顶:仅 切换置顶状态。操作后窗口是否置顶。

限制与排障

部分全屏或受保护窗口无法移动或改透明度。强制关闭前确认没有未保存内容。1.24.28 起支持更多操作类型。

相关链接

更新于