WPF 怎么接收 Windows 消息？一篇讲透 `WndProc`、`HwndSource` 和常见消息处理方法

目标关键词：WPF 怎么接收 Windows 消息

在做 WPF 开发时，很多人都会遇到一个问题：
界面已经是 WPF 的了，但我还想接收 Windows 原生消息，比如窗口大小变化、鼠标穿透、热键、拖拽、关闭前拦截，甚至和某些旧版 Win32 控件通信。这时候就会用到 Windows 消息接收机制。

WPF 本身不是纯 Win32 窗口模型，但它底层依然依赖 HWND，所以完全可以接收 Windows 消息。只不过和 WinForms 的 WndProc 不一样，WPF 需要通过 消息钩子 来处理。

一、问题分析：WPF 为什么不能直接写 `WndProc`？

如果你接触过 WinForms，应该知道它可以直接重写：

protected override void WndProc(ref Message m)
{
    base.WndProc(ref m);
}

但 WPF 没有这个入口，原因很简单：

WPF 的 UI 是基于 Visual 树和渲染系统，不是直接暴露 WndProc
WPF 窗口底层虽然有 HWND，但消息处理被 WPF 框架封装了
如果想接收 Windows 消息，需要从 HwndSource 下手

简单理解就是：

WPF 不是不能收消息，而是不能像 WinForms 那样直接收，要通过消息过滤器或窗口句柄挂钩来做。

二、最常用方案：通过 `HwndSource.AddHook` 接收 Windows 消息

这是 WPF 里最常见、最标准的做法。
适合处理：

WM_HOTKEY 全局热键
WM_COPYDATA 跨进程通信
WM_CLOSE、WM_SIZE、WM_NC* 等窗口消息
鼠标、键盘、拖拽相关的底层消息

1. 基本写法

在 WPF 窗口加载完成后，拿到窗口句柄，再挂钩消息处理函数。

示例代码

using System;
using System.Windows;
using System.Windows.Interop;

namespace WpfApp1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            SourceInitialized += MainWindow_SourceInitialized;
        }

        private void MainWindow_SourceInitialized(object? sender, EventArgs e)
        {
            var source = HwndSource.FromHwnd(new WindowInteropHelper(this).Handle);
            source?.AddHook(WndProc);
        }

        private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
        {
            const int WM_CLOSE = 0x0010;
            const int WM_SIZE = 0x0005;
            const int WM_HOTKEY = 0x0312;

            switch (msg)
            {
                case WM_CLOSE:
                    MessageBox.Show("窗口即将关闭");
                    break;

                case WM_SIZE:
                    // 窗口尺寸变化
                    break;

                case WM_HOTKEY:
                    MessageBox.Show("检测到全局热键");
                    handled = true;
                    break;
            }

            return IntPtr.Zero;
        }
    }
}

2. 为什么要在 `SourceInitialized` 里挂钩？

很多新手会直接在构造函数里写：

var source = HwndSource.FromHwnd(new WindowInteropHelper(this).Handle);

这样经常会拿不到句柄，或者句柄还没创建成功。

正确时机是：

SourceInitialized
或者 OnSourceInitialized

因为这时候窗口句柄已经生成，HWND 已可用。

三、`WndProc` 参数怎么理解？

WPF 里挂钩消息的方法一般长这样：

private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)

这几个参数分别代表：

hwnd：当前窗口句柄
msg：消息编号，比如 WM_SIZE、WM_CLOSE
wParam：附加参数 1
lParam：附加参数 2
handled：是否已处理

`handled` 的作用

handled = true：告诉 WPF，这条消息我处理完了，别再往下传了
handled = false：让 WPF 继续默认处理

比如你想拦截窗口关闭，可以这样写：

case WM_CLOSE:
    MessageBox.Show("禁止关闭");
    handled = true;
    break;

这样窗口就不会继续关闭。

四、常见 Windows 消息示例

下面列几个 WPF 项目里非常实用的消息处理场景。

1. 接收全局热键 `WM_HOTKEY`

如果你想让程序即使不在前台，也能响应快捷键，就要注册全局热键。

注册热键代码

using System.Runtime.InteropServices;

public partial class MainWindow : Window
{
    private const int WM_HOTKEY = 0x0312;
    private const int HOTKEY_ID = 9000;

    [DllImport("user32.dll")]
    private static extern bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk);

    [DllImport("user32.dll")]
    private static extern bool UnregisterHotKey(IntPtr hWnd, int id);

    public MainWindow()
    {
        InitializeComponent();
        SourceInitialized += MainWindow_SourceInitialized;
        Closed += MainWindow_Closed;
    }

    private void MainWindow_SourceInitialized(object? sender, EventArgs e)
    {
        var handle = new WindowInteropHelper(this).Handle;
        var source = HwndSource.FromHwnd(handle);
        source?.AddHook(WndProc);

        // 注册 Ctrl + Alt + A
        RegisterHotKey(handle, HOTKEY_ID, 0x0002 | 0x0001, (uint)System.Windows.Forms.Keys.A);
    }

    private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
    {
        if (msg == WM_HOTKEY && wParam.ToInt32() == HOTKEY_ID)
        {
            MessageBox.Show("全局热键触发");
            handled = true;
        }
        return IntPtr.Zero;
    }

    private void MainWindow_Closed(object? sender, EventArgs e)
    {
        var handle = new WindowInteropHelper(this).Handle;
        UnregisterHotKey(handle, HOTKEY_ID);
    }
}

注意

热键会被系统或其他软件占用，注册失败时要做判断
记得窗口关闭时释放热键，否则会残留占用

2. 接收跨进程消息 `WM_COPYDATA`

如果你要做两个程序之间传字符串、路径、命令，可以用 WM_COPYDATA。

接收端示例

private const int WM_COPYDATA = 0x004A;

[StructLayout(LayoutKind.Sequential)]
public struct COPYDATASTRUCT
{
    public IntPtr dwData;
    public int cbData;
    public IntPtr lpData;
}

private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    if (msg == WM_COPYDATA)
    {
        var cds = Marshal.PtrToStructure<COPYDATASTRUCT>(lParam);
        byte[] buffer = new byte[cds.cbData];
        Marshal.Copy(cds.lpData, buffer, 0, cds.cbData);

        string text = System.Text.Encoding.UTF8.GetString(buffer).TrimEnd('\0');
        MessageBox.Show("收到消息：" + text);

        handled = true;
    }

    return IntPtr.Zero;
}

适合场景

单实例程序互相通知
老旧程序和 WPF 程序通信
简单传递文本数据

3. 拦截关闭按钮 `WM_CLOSE`

如果你想在用户点击右上角关闭按钮时弹出确认框，可以处理 WM_CLOSE。

private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    const int WM_CLOSE = 0x0010;

    if (msg == WM_CLOSE)
    {
        var result = MessageBox.Show("确定要退出吗？", "提示", MessageBoxButton.YesNo);
        if (result == MessageBoxResult.No)
        {
            handled = true;
        }
    }

    return IntPtr.Zero;
}

说明

handled = true 后窗口不会继续关闭
如果用户选“是”，就让 WPF 默认关闭即可

4. 响应窗口大小变化 `WM_SIZE`

这个消息常用于：

自定义布局
全屏窗口处理
兼容某些老控件

private const int WM_SIZE = 0x0005;

private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    if (msg == WM_SIZE)
    {
        // 窗口大小变化
    }

    return IntPtr.Zero;
}

如果只是想做布局响应，其实 WPF 里很多时候直接用 SizeChanged 事件就够了，不一定非要上消息层。

五、如果想处理键盘、鼠标消息，怎么做？

这类场景有两种思路：

方式 1：优先用 WPF 自带事件

比如：

KeyDown
MouseDown
MouseMove
PreviewKeyDown

适合大多数界面交互，写法简单。

方式 2：接收底层消息

适合以下场景：

自定义无边框窗口拖动
截获系统级按键
与低层 Win32 控件联动
处理消息穿透、鼠标消息精细控制

例如鼠标左键按下消息：

private const int WM_LBUTTONDOWN = 0x0201;

然后在 WndProc 里判断即可。

六、另一种方法：`Application.AddHook`

如果你想在整个应用层面接收消息，可以使用 Application.AddHook，不过实际项目里更常见的还是窗口级别的 HwndSource.AddHook。

适合做：

全局消息监听
应用内统一处理逻辑

但要注意，消息依然要基于具体 HwndSource，并不是完全脱离窗口句柄。

七、新手最容易踩的坑

1. 在句柄没创建前就去挂钩

这是最常见的问题。
解决方法：放到 SourceInitialized 里。

2. 忘记释放资源

比如注册了全局热键，关闭时没注销，会导致热键残留。

解决方法：

UnregisterHotKey
关闭时解除钩子
不要长期占用系统资源

3. `handled` 没设置对

如果该拦截的消息没拦住，可能会被 WPF 默认逻辑继续处理，导致行为异常。

4. 不同系统消息值写错

消息编号必须准确，建议直接写成常量，避免手打错误。

例如：

private const int WM_HOTKEY = 0x0312;
private const int WM_COPYDATA = 0x004A;
private const int WM_CLOSE = 0x0010;

5. 32 位和 64 位下 `IntPtr` 使用不当

不要随便把 IntPtr 强转成 int，尤其在 64 位程序里容易出问题。

建议：

用 IntPtr
必要时用 ToInt64()
只在明确安全时再转换

八、推荐的完整写法模板

下面给你一个比较实用的 WPF 接收消息模板，直接可以改造使用。

using System;
using System.Windows;
using System.Windows.Interop;

namespace WpfApp1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            SourceInitialized += MainWindow_SourceInitialized;
        }

        private void MainWindow_SourceInitialized(object? sender, EventArgs e)
        {
            var hwnd = new WindowInteropHelper(this).Handle;
            var source = HwndSource.FromHwnd(hwnd);
            source?.AddHook(WndProc);
        }

        private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
        {
            switch (msg)
            {
                case 0x0010: // WM_CLOSE
                    // 这里做关闭拦截
                    break;

                case 0x0312: // WM_HOTKEY
                    // 这里处理热键
                    handled = true;
                    break;
            }

            return IntPtr.Zero;
        }
    }
}

九、进阶场景：WPF 和 Win32 混合开发

如果你的 WPF 项目里嵌了 Win32 控件，比如：

HwndHost
第三方老控件
ActiveX
原生子窗口

那接收 Windows 消息就更重要了。
这类项目中常常要处理：

子窗口消息传递
焦点切换
输入法状态
鼠标穿透
非客户区绘制

这时 HwndSource.AddHook 往往是核心手段之一。

十、总结：WPF 接收 Windows 消息的正确思路

如果你只记住一句话，那就是：

WPF 接收 Windows 消息，核心是拿到窗口句柄，再通过 HwndSource.AddHook 挂消息处理函数。

具体步骤可以记成这 4 步：

在窗口 SourceInitialized 之后获取 HWND
用 HwndSource.FromHwnd(hwnd) 获取消息源
用 AddHook(WndProc) 注册消息钩子
在 WndProc 里判断消息编号并处理，必要时设置 handled = true

十一、实际开发建议

如果是普通界面交互，优先用 WPF 自带事件，比如：

Click
KeyDown
SizeChanged
Closing

只有当你遇到下面这些需求时，再去用 Windows 消息：

全局热键
关闭拦截更底层控制
跨进程通信
原生窗口/老控件兼容
无边框窗体深度定制

这样代码会更清晰，也更不容易出 bug。

十二、常用消息速查

消息名	消息值	用途
`WM_CLOSE`	`0x0010`	窗口关闭
`WM_SIZE`	`0x0005`	窗口尺寸变化
`WM_HOTKEY`	`0x0312`	全局热键
`WM_COPYDATA`	`0x004A`	跨进程通信
`WM_LBUTTONDOWN`	`0x0201`	鼠标左键按下
`WM_KEYDOWN`	`0x0100`	键盘按下