Word加载项自动补全：子类化窗口无法捕获WM_CHAR消息

我之前做类似的Word加载项自动补全功能时，也碰到过一模一样的问题——子类化窗口只能抓到WM_KEYDOWN，就是收不到WM_CHAR。给你几个实际可行的排查方向和解决方案：

• 先确认你子类化的窗口是不是真的接收WM_CHAR的那个
  Word的编辑界面是嵌套的多层窗口，你找到的“接收键盘输入的窗口”可能只是外层容器，真正处理WM_CHAR的是内部的RichEdit类子窗口。建议用Spy++（Windows SDK自带工具）跟踪消息流，看看WM_CHAR到底发往哪个窗口句柄——你会发现，真正的目标窗口可能是类名为_WwG或者类似的子窗口（不同Word版本可能有差异）。

• 检查子类化的回调函数是否符合规范
  用SetWindowSubclass时，回调函数的签名必须严格匹配SUBCLASSPROC，而且处理完消息后一定要调用DefSubclassProc让原始窗口继续处理消息链。如果漏了这一步，不仅WM_CHAR可能被拦截，还会导致Word的正常输入逻辑出问题。举个正确的回调示例：

  LRESULT CALLBACK MyEditSubclassProc(
      HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam,
      UINT_PTR uIdSubclass, DWORD_PTR dwRefData
  ) {
      if (uMsg == WM_CHAR) {
          // 这里处理你的自动补全逻辑，比如获取输入的字符
          TCHAR inputChar = (TCHAR)wParam;
          // 执行自动补全判断与操作...
      }
      // 必须调用这个，让Word的原始窗口处理剩余消息
      return DefSubclassProc(hWnd, uMsg, wParam, lParam);
  }
  

• 如果子类化行不通，试试全局低级键盘钩子
  要是确认窗口后还是抓不到WM_CHAR，可以改用WH_KEYBOARD_LL低级钩子。这种钩子不需要注入到Word进程，只需要在你的加载项进程里处理，而且能捕获所有键盘输入，之后你只需要判断当前焦点是否在Word的编辑窗口即可。示例代码大概是这样：

  HHOOK hKeyboardHook = nullptr;
  
  LRESULT CALLBACK KeyboardLowLevelProc(int nCode, WPARAM wParam, LPARAM lParam) {
      if (nCode >= 0 && wParam == WM_CHAR) {
          KBDLLHOOKSTRUCT* pHookData = reinterpret_cast<KBDLLHOOKSTRUCT*>(lParam);
          // 判断当前活动窗口是不是Word的编辑窗口
          HWND foregroundWnd = GetForegroundWindow();
          TCHAR className[256];
          GetClassName(foregroundWnd, className, sizeof(className)/sizeof(TCHAR));
          // 类名根据Word版本调整，比如内部编辑窗口常为"_WwG"
          if (_tcscmp(className, _T("_WwG")) == 0) {
              TCHAR inputChar = static_cast<TCHAR>(pHookData->vkCode);
              // 处理自动补全逻辑...
          }
      }
      // 一定要传递给下一个钩子，避免影响系统其他程序
      return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
  }
  
  // 加载项初始化时安装钩子
  hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardLowLevelProc, GetModuleHandle(nullptr), 0);
  
  // 加载项退出时卸载钩子
  if (hKeyboardHook) {
      UnhookWindowsHookEx(hKeyboardHook);
  }
  

• 避免手动生成WM_CHAR的坑
  有些朋友会想在WM_KEYDOWN里手动生成WM_CHAR，但这其实很不靠谱——因为WM_CHAR是系统根据键盘状态（Shift、CapsLock、输入法状态等）转换后的字符，手动生成很容易出现字符编码错误，尤其是处理中文等非ASCII字符的时候，所以尽量别这么干。

内容的提问来源于stack exchange，提问作者Chris Kerridge