Windows下Qt5.5.1 DLL中QWidget如何设置HWND父窗口？

我刚好碰到过几乎一模一样的场景，给你梳理下正确的解决思路和代码：

首先，你遇到的两个问题本质是：

• 用WinAPI的SetParent()会把Qt窗口变成原生子窗口，而原生子窗口默认会被父窗口强制裁剪，所以没法超出边界
• Qt 5确实废弃了QWidget::create()中window参数的作用，这个方法现在只能用来创建窗口句柄，完全不支持指定父窗口

正确的实现步骤 #

Qt 5提供了原生窗口和Qt窗口交互的官方方式，我们可以通过QWindow来桥接原生HWND和Qt的QWidget：

1. 把原生HWND转换成Qt的QWindow对象
   用QWindow::fromWinId()方法可以直接将HWND包装成Qt能识别的QWindow，这是Qt 5处理原生窗口的标准方式。

2. 调整QWidget的窗口标志
   要让QWidget能超出父窗口边界，必须把它设置为顶级窗口类型（比如Qt::Window），这样它不会被父窗口的区域限制。如果用默认的子窗口标志，还是会被裁剪。

3. 关联QWidget和原生父窗口
   通过QWidget的windowHandle()获取它对应的QWindow，然后调用setParent()把刚才包装好的原生父QWindow传进去，这样既保持了Qt窗口的特性，又能依附于原生父窗口。

完整代码示例 #

// 假设你已经拿到了父窗口的HWND
HWND hwndParent = ...;

// 1. 包装原生HWND为QWindow
QWindow* nativeParent = QWindow::fromWinId(static_cast<WId>(hwndParent));

// 2. 初始化你的库中的QWidget
QWidget* myDllWidget = new QWidget();
// 设置窗口标志为顶级窗口，可根据需求调整（比如Qt::Dialog、Qt::Tool等）
myDllWidget->setWindowFlags(Qt::Window | Qt::WindowTitleHint | Qt::WindowMinimizeButtonHint);

// 3. 确保QWidget创建了窗口句柄（show()或者createWinId()都可以）
myDllWidget->createWinId();

// 4. 关联到原生父窗口
myDllWidget->windowHandle()->setParent(nativeParent);

// 测试显示，此时窗口可以超出原生父窗口的边界
myDllWidget->show();
myDllWidget->move(50, 50); // 哪怕这个位置超出父窗口范围，也能正常显示

为什么这个方法可行？ #

• 这种方式是Qt官方推荐的原生窗口集成方案，不会破坏Qt的事件循环、窗口层级等管理逻辑
• 设置Qt::Window标志让QWidget拥有顶级窗口的特性，避免了原生子窗口的裁剪限制
• 通过QWindow的父子关联，既保证了QWidget依附于原生父窗口（比如最小化父窗口时QWidget也会跟着最小化），又保留了Qt窗口的灵活性

避坑提醒 #

• 绝对不要混合使用WinAPI的SetParent()和Qt的窗口管理方法，这会导致Qt的事件传递、窗口状态同步出现各种奇怪的问题
• 如果你的QWidget是已经创建好的，只需要调整窗口标志（记得先调用setWindowFlags()，再调用createWinId()或者先hide再show来刷新窗口属性），然后执行关联步骤即可

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