窗口操作
底层窗口操作工具函数，基于 Windows API。
窗口状态
minimize_window(hwnd, mode="send")
最小化窗口。
maximize_window(hwnd, mode="send")
最大化窗口。
restore_window(hwnd, mode="send")
还原窗口。
close_window(hwnd, mode="send")
关闭窗口。
show_window(hwnd, mode="send")
显示窗口。
hide_window(hwnd, mode="send")
隐藏窗口。
toggle_window(hwnd, status)
切换窗口状态。
- status
str— 目标状态
窗口操作
focus_window(hwnd, mode="send")
聚焦窗口。
activate_window(hwnd, mode="send")
激活窗口（前台显示）。
deactivate_window(hwnd, mode="send")
取消激活窗口。
move_window(hwnd, x, y, mode="send")
移动窗口到指定位置。
resize_window(hwnd, width, height, mode="send")
调整窗口大小。
move_window_offscreen(hwnd, x=-9999, y=-9999)
将窗口移到屏幕外。
move_window_back(hwnd, x=100, y=100)
将窗口移回屏幕内。
is_window_offscreen(hwnd)
判断窗口是否在屏幕外。
- 返回
bool
鼠标操作
click_window(hwnd, x, y, mode="send")
在窗口指定坐标点击。
double_click_window(hwnd, x, y, mode="send")
双击。
right_click_window(hwnd, x, y, mode="send")
右键点击。
middle_click_window(hwnd, x, y, mode="send")
中键点击。
mouse_move_window(hwnd, x, y, mode="send")
移动鼠标到窗口内指定坐标。
scroll_window(hwnd, x, y, delta=120, mode="send")
在窗口内滚动。
- delta
int— 滚动量（正值向上，负值向下）
键盘操作
key_down_window(hwnd, key, mode="send")
按下键。
key_up_window(hwnd, key, mode="send")
释放键。
key_press_window(hwnd, key, mode="send")
按下并释放键。
key_hotkey_window(hwnd, modifier, key, mode="send")
发送组合键。
- modifier
int— 修饰键（如 VK_CONTROL） - key
int— 按键
key_type_window(hwnd, text, mode="send")
输入文本。
- text
str— 要输入的文本
窗口查找
get_hwnd(title=None, mode="exact", pid=None)
按标题查找窗口句柄。
- title
str | None— 窗口标题 - mode
"exact" | "wildcard" | "regex"— 匹配模式 - pid
int | None— 进程 PID - 返回
int | None
get_hwnds_by_pid(pid, visible_only=True)
获取指定进程的所有窗口句柄。
- 返回
List[int]
wx_pid_to_hwnd(pid)
微信 PID 转主窗口句柄。
- 返回
int | None
进程
find_process(name)
按名称查找进程。
- 返回
List[dict]—[{"pid": int, "name": str}]
mode 参数说明
大多数窗口操作函数支持 mode 参数：
| 值 | 说明 |
|---|---|
"send" | 使用 SendMessage（同步，等待处理完成） |
"post" | 使用 PostMessage（异步，立即返回） |