Windows 本质上是一个”消息驱动”的操作系统。每一个鼠标点击、键盘按键、窗口移动、控件重绘——背后都是一条消息在流转。
AutoHotkey v2 的一大优势就是能直接参与这个”消息生态系统”:你可以监听消息、拦截消息、发送消息,甚至接管某个窗口的消息处理函数。掌握了窗口消息系统,你就真正拥有了对 Windows 的底层控制能力。
本文从零开始,覆盖 OnMessage、SendMessage、PostMessage、WM_COMMAND、子类化(Subclassing)等核心话题,附完整可运行代码。
一、Windows 消息机制基础
在 Windows 中,消息用 MSG 结构体表示:
typedef struct {
HWND hwnd; // 目标窗口句柄
UINT message; // 消息ID(如 WM_CLOSE=0x0010)
WPARAM wParam; // 附加参数1
LPARAM lParam; // 附加参数2
DWORD time; // 消息时间
POINT pt; // 消息发生时鼠标位置
} MSG;
每个窗口都有一个”窗口过程”(Window Procedure),系统把消息发送到对应窗口的过程函数,由它决定怎么处理。AHK v2 的 Gui 控件本质上也是窗口,同样参与消息循环。
| 消息ID | 名称 | 触发时机 |
|---|---|---|
| 0x0001 | WM_CREATE | 窗口创建时 |
| 0x0002 | WM_DESTROY | 窗口销毁时 |
| 0x0005 | WM_SIZE | 窗口尺寸变化 |
| 0x0010 | WM_CLOSE | 点击关闭按钮 |
| 0x0084 | WM_NCHITTEST | 鼠标命中测试 |
| 0x0200 | WM_MOUSEMOVE | 鼠标移动 |
| 0x0201 | WM_LBUTTONDOWN | 鼠标左键按下 |
| 0x0100 | WM_KEYDOWN | 按键按下 |
| 0x0111 | WM_COMMAND | 控件通知/菜单命令 |
二、OnMessage — 消息监听器
OnMessage 是 AHK v2 中最易用的消息 API。你可以注册一个回调函数,当指定消息到达 AHK 管理的窗口时自动触发。它本质上是一个”消息观察者”——消息仍然会被窗口处理,你只是在它经过时”偷看”一眼。
2.1 基础用法:监听窗口关闭
2.2 OnMessage 回调函数签名
; 回调接收四个参数:
MyCallback(wParam, lParam, msg, hwnd) {
; wParam/lParam — 消息附加参数(含义因消息而异)
; msg — 消息ID
; hwnd — 接收消息的窗口句柄
; 返回 0 → 继续传递,非0 → 拦截
}
2.3 监听鼠标消息
💡 lParam 的位操作
在很多消息中(WM_MOUSEMOVE、WM_SIZE),lParam 同时携带两个值:低16位(X/宽度)和高16位(Y/高度)。用 lParam & 0xFFFF 取低16位,lParam >> 16 取高16位。
三、SendMessage / PostMessage — 主动发送消息
如果说 OnMessage 是”被动监听”,SendMessage 和 PostMessage 就是”主动出击”。你可以向任何窗口发送自定义消息,控制其行为。
3.1 SendMessage vs PostMessage
| 特性 | SendMessage | PostMessage |
|---|---|---|
| 发送方式 | 同步(等处理完) | 异步(立即返回) |
| 返回值 | ✅ 能拿到结果 | ❌ 只返回投递状态 |
| 可能卡住? | ⚠️ 会卡 | ✅ 不会 |
| 适用场景 | 需要返回结果 | 发完不管 |
3.2 实战:模拟按钮点击
⚠️ SendMessage 卡死风险:如果目标窗口不响应消息,SendMessage 会一直阻塞。可用 PostMessage 替代,或用 WinGet 先检查窗口状态。
四、窗口子类化(Subclassing)
子类化是窗口消息处理的最强形态——它直接替换窗口的过程函数,让你在消息到达原始处理函数之前截获并处理。
OnMessage 只能监听 AHK 自己创建的 Gui 窗口。子类化则可以接管任何窗口——包括记事本、浏览器、第三方软件。
💡 OnMessage vs 子类化
OnMessage 是在消息被处理完后”偷看一眼”;子类化是在消息被处理之前”截胡”。子类化可以修改消息参数、阻止消息传递、伪造返回值。代价是实现更复杂,需要 DllCall + CallbackCreate。
4.1 安全释放子类化
子类化必须在脚本退出前恢复原始窗口过程,否则目标窗口会崩溃:
五、自定义消息与跨脚本通信
Windows 预留了 WM_USER (0x0400) 到 WM_APP (0x8000) 的范围供自定义消息使用。你可以实现:
- 两个 AHK 脚本之间的通信
- AHK 脚本与其他程序的通信
- 脚本内部模块间的解耦
接收端脚本:
六、综合实战:无标题栏窗口拖拽
综合运用 WM_NCHITTEST 消息,实现无标题栏窗口的拖拽——AHK 中最常见的自定义窗口需求之一。
💡 WM_NCHITTEST 返回值速查
HTCLIENT=1(客户区)| HTCAPTION=2(标题栏,可拖动)| HTLEFT=10 | HTRIGHT=11 | HTTOP=12 | HTBOTTOM=15
七、常见消息ID速查表
| 常量名 | 值 | 说明 |
|---|---|---|
| WM_CREATE | 0x0001 | 窗口创建 |
| WM_CLOSE | 0x0010 | 窗口关闭 |
| WM_SETTEXT | 0x000C | 设置文本 |
| WM_GETTEXT | 0x000D | 获取文本 |
| WM_COMMAND | 0x0111 | 控件通知 |
| WM_NCHITTEST | 0x0084 | 命中测试 |
| WM_SIZE | 0x0005 | 大小变化 |
| WM_KEYDOWN | 0x0100 | 按键按下 |
| WM_LBUTTONDOWN | 0x0201 | 左键按下 |
| WM_MOUSEMOVE | 0x0200 | 鼠标移动 |
| WM_USER | 0x0400 | 自定义消息起点 |
八、避坑总结
- v2 回调参数数量:OnMessage 回调在 v2 中接收 4 个参数,不是 v1 的 3 个。
- 子类化必须恢复:脚本退出前用 SetWindowLongPtr 恢复原始过程。忘记恢复会导致目标窗口崩溃。
- SendMessage 可能卡死:向无响应窗口发送同步消息会一直阻塞。必要时用 PostMessage 替代。
- 自定义消息防冲突:从 WM_USER+100 以上使用,避免和系统消息冲突。用 RegisterWindowMessage 确保唯一。
- CallbackCreate 是资源:用完记得 CallbackFree,否则内存泄漏。
- 64位指针:Always use
"Ptr"type in DllCall, never"Int"for pointers on 64-bit AHK.
🌟 AutoAHK.com — 中文 AutoHotkey 社区
✅ 收藏本站,不错过每一篇实用教程
✅ 评论区可以交流提问,有问必答

