当前位置：首页 > news >正文

告别黑盒！用Qt的QWindow和WId把Windows记事本、计算器“装”进你的应用界面

news 2026/5/5 2:30:33

告别黑盒！用Qt的QWindow和WId把Windows记事本、计算器“装”进你的应用界面

你是否想过，能让Windows自带的记事本或计算器直接运行在你的Qt应用里？这听起来像是某种黑魔法，但实际上只需要理解几个关键概念：QWindow、WId和Windows的窗口句柄。本文将带你一步步实现这个有趣的功能，同时深入探讨背后的原理和实际应用中的坑点。

1. 理解窗口嵌入的核心概念

在开始编码之前，我们需要先搞清楚几个关键术语：

HWND：Windows操作系统中每个窗口都有一个唯一的标识符，称为窗口句柄（Handle to Window）。它是一个不透明的指针值，通过Windows API函数可以获取和操作它。
WId：Qt框架中用来表示窗口标识符的类型，实际上是底层原生窗口系统句柄的抽象。在Windows平台，WId就是HWND的别名。
QWindow：Qt中表示窗口的基类，封装了与窗口系统交互的功能。通过QWindow::fromWinId()，我们可以将一个原生窗口句柄包装成Qt窗口对象。

窗口嵌入的本质是将一个外部应用程序的窗口"重定向"到我们的Qt应用中。这涉及到：

找到目标窗口的HWND
将其转换为Qt能识别的WId
创建一个容器来承载这个外部窗口
处理窗口大小变化、焦点切换等事件

2. 实战：嵌入Windows计算器

让我们以嵌入Windows计算器为例，看看具体如何实现。

2.1 准备工作

首先创建一个基本的Qt Widgets Application项目，然后在主窗口类中添加以下代码：

#include <QWidget> #include <QWindow> #include <Windows.h> class MainWindow : public QWidget { Q_OBJECT public: explicit MainWindow(QWidget *parent = nullptr); protected: void resizeEvent(QResizeEvent *event) override; private: QWidget *m_container = nullptr; };

2.2 查找并嵌入计算器窗口

在构造函数中，我们需要：

启动计算器程序
查找其主窗口
创建容器来承载它

MainWindow::MainWindow(QWidget *parent) : QWidget(parent) { // 启动计算器 QProcess::startDetached("calc.exe"); // 给计算器一点启动时间 QThread::msleep(500); // 查找计算器窗口 HWND hwndCalc = FindWindow(L"ApplicationFrameWindow", L"计算器"); if (!hwndCalc) { qWarning() << "找不到计算器窗口"; return; } // 将HWND转换为QWindow QWindow *calcWindow = QWindow::fromWinId(reinterpret_cast<WId>(hwndCalc)); if (!calcWindow) { qWarning() << "无法创建QWindow"; return; } // 创建容器 m_container = QWidget::createWindowContainer(calcWindow, this); m_container->setGeometry(0, 0, width(), height()); }

2.3 处理窗口大小变化

当主窗口大小改变时，我们需要同步调整容器大小：

void MainWindow::resizeEvent(QResizeEvent *event) { QWidget::resizeEvent(event); if (m_container) { m_container->setGeometry(0, 0, event->size().width(), event->size().height()); } }

3. 进阶技巧与问题解决

3.1 处理不同Windows版本的差异

Windows 10和Windows 11上的计算器窗口类名可能不同：

Windows版本	窗口类名	窗口标题
Windows 10	ApplicationFrameWindow	计算器
Windows 11	Windows.UI.Core.CoreWindow	计算器

更健壮的查找方式：

HWND findCalculatorWindow() { HWND hwnd = FindWindow(L"ApplicationFrameWindow", L"计算器"); if (!hwnd) { hwnd = FindWindow(L"Windows.UI.Core.CoreWindow", L"计算器"); } return hwnd; }

3.2 解决焦点问题

嵌入的外部窗口可能会有焦点问题，我们需要处理：

bool MainWindow::eventFilter(QObject *watched, QEvent *event) { if (watched == m_container && event->type() == QEvent::FocusIn) { // 当容器获得焦点时，确保外部窗口也获得焦点 if (m_calcWindow) { SetForegroundWindow(reinterpret_cast<HWND>(m_calcWindow->winId())); } } return QWidget::eventFilter(watched, event); }

3.3 样式融合技巧

为了使外部窗口更好地融入你的应用，可以尝试：

移除外部窗口的边框
设置统一的背景色
调整窗口的Z序

// 移除计算器窗口的边框 LONG_PTR style = GetWindowLongPtr(hwndCalc, GWL_STYLE); style &= ~(WS_CAPTION | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX | WS_SYSMENU); SetWindowLongPtr(hwndCalc, GWL_STYLE, style);

4. 实际应用场景与限制

4.1 适用场景

这种技术特别适合以下情况：

需要集成现有Windows工具到你的应用中
快速原型开发，验证概念
教学演示，展示窗口系统工作原理

4.2 限制与注意事项

虽然功能强大，但这种嵌入方式有一些限制：

性能问题：外部窗口的渲染仍然由其原始进程处理，可能会有性能开销
稳定性风险：如果外部程序崩溃，可能会影响你的应用
UI不一致：外部窗口的样式可能与你的应用不匹配
安全考虑：某些程序可能不允许被嵌入

提示：在生产环境中使用此技术前，务必进行充分的测试和评估。

5. 扩展应用：嵌入记事本和其他程序

同样的技术可以应用于其他Windows自带程序，如记事本：

// 查找记事本窗口 HWND hwndNotepad = FindWindow(L"Notepad", nullptr); if (hwndNotepad) { QWindow *notepadWindow = QWindow::fromWinId(reinterpret_cast<WId>(hwndNotepad)); QWidget *container = QWidget::createWindowContainer(notepadWindow, this); container->setGeometry(0, 0, width(), height()); }

对于更复杂的应用，你可能需要：