如何将原生Win32事件投递到Qt的事件循环中

我之前对接第三方窗口系统时也碰到过一模一样的需求——手里攥着Win32的MessageProc回调，想把外部窗口的事件传给Qt的QML事件循环，当时也在找像你说的QEvent::fromNative这种一步到位的API，翻遍文档都没找着，后来折腾出来一套可行的方案，给你唠唠：

首先得明确：Qt并没有直接提供把Win32消息一键转成QEvent的公开API，但我们可以用它提供的原生事件交互接口来实现需求，核心思路是把外部Win32窗口和Qt的窗口对象绑定，然后把原生消息投递到Qt的事件循环里。

具体步骤走一波： #

• 先把外部窗口给Qt“登记”一下
  你得先把第三方窗口的HWND句柄，包装成Qt能识别的QWindow对象，这一步用公开API就能搞定：

  // 替换成你的第三方窗口句柄
  HWND externalHwnd = ...;
  QWindow* qtWrapperWindow = QWindow::fromWinId((WId)externalHwnd);
  

  注意哈，这个QWindow只是个包装壳，不会创建新窗口，就是让Qt能“认得出”这个外部窗口而已。

• 在MessageProc里转发原生消息
  接下来就在你的Win32消息回调函数里，把收到的每个消息打包成Win32的MSG结构体，然后用Qt的sendNativeEvent或者postNativeEvent投递给Qt的事件循环：

  LRESULT CALLBACK ExternalMessageProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
  {
      // 先检查这个窗口是不是我们已经绑定过的那个
      QWindow* qtWindow = QWindow::fromWinId((WId)hwnd);
      if (qtWindow) {
          // 打包成Win32的MSG结构
          MSG win32Msg = {hwnd, msg, wParam, lParam, GetMessageTime(), GetMessagePos()};
          // 把原生消息投递给Qt事件循环，sendNativeEvent是同步处理，postNativeEvent是异步
          bool isProcessed = QGuiApplication::sendNativeEvent(
              QByteArrayLiteral("windows_generic_MSG"),
              &win32Msg,
              nullptr
          );
          // 如果Qt已经处理了这个消息，就不用传给原窗口过程了
          if (isProcessed) {
              return 0;
          }
      }
      // 要是Qt没处理，就交给原来的窗口过程继续处理
      return CallWindowProc(yourOriginalWndProc, hwnd, msg, wParam, lParam);
  }
  

• 额外要注意的坑

  • 必须确保QGuiApplication（或者QApplication，如果你用了Widget）已经在主线程初始化了，Qt的所有事件处理都依赖它，没它啥都干不了。
  • 别随便销毁那个qtWrapperWindow，除非你确定外部窗口已经关闭了，不然容易崩。
  • 像WM_PAINT这种涉及绘制的消息，可能要协调好第三方窗口和Qt的绘制逻辑，避免画面打架，比如可以让Qt接管绘制，或者在第三方绘制完成后再让Qt处理。
  • 要是你用的是QML，记得把你的QML根对象挂载到这个qtWrapperWindow上，比如用QQmlApplicationEngine的setInitialProperties或者把QQuickView的winId设置成外部窗口的句柄，这样QML控件才能收到事件。

最后补一句：Qt 5和Qt 6的逻辑基本通用，个别参数的类型可能有小变化，比如WId的定义，编译时注意看报错调整就行。

内容来源于stack exchange