如何将WinUI 3集成至现有MFC应用？求相关学习资料

一、集成步骤 #

1. 准备环境 #

确保你的开发环境满足：

• Visual Studio 2022（需安装「Desktop development with C++」和「Universal Windows Platform development」工作负载）
• 现有MFC项目已设置为Unicode字符集（WinUI 3仅支持Unicode）

2. 添加WinUI 3项目到解决方案 #

• 右键解决方案 → 「添加」→ 「新建项目」
• 选择「WinUI 3 Desktop Application」，推荐选「Blank App, WinUI 3 in Desktop」（非打包版本，减少复杂度）
• 在解决方案属性中，设置MFC项目依赖于WinUI 3项目，确保编译顺序正确

3. 在MFC窗口中嵌入WinUI 3内容 #

核心思路是将WinUI 3窗口作为MFC窗口的子控件嵌入，关键代码示例（以MFC对话框为例）：

// 在对话框类头文件中添加成员变量
#include <winrt/Microsoft.UI.Xaml.h>
#include <winrt/Microsoft.UI.Xaml.Controls.h>

class CMyMfcDialog : public CDialogEx
{
    // ... 其他代码
private:
    winrt::Microsoft::UI::Xaml::Window m_winuiWindow;
};

// 在OnInitDialog中初始化嵌入逻辑
BOOL CMyMfcDialog::OnInitDialog()
{
    CDialogEx::OnInitDialog();

    // 初始化WinRT环境（全局仅需调用一次，也可放在App启动时）
    static bool isWinrtInited = false;
    if (!isWinrtInited)
    {
        winrt::init_apartment(winrt::apartment_type::single_threaded);
        isWinrtInited = true;
    }

    // 获取MFC窗口的HWND
    HWND hWndMfc = this->m_hWnd;

    // 创建WinUI 3内容
    auto textBlock = winrt::Microsoft::UI::Xaml::Controls::TextBlock();
    textBlock.Text(L"WinUI 3 Content Embedded in MFC");
    textBlock.FontSize(24);
    textBlock.HorizontalAlignment(winrt::Microsoft::UI::Xaml::HorizontalAlignment::Center);
    textBlock.VerticalAlignment(winrt::Microsoft::UI::Xaml::VerticalAlignment::Center);

    // 创建WinUI 3窗口并设置内容
    m_winuiWindow.Content(textBlock);

    // 将WinUI窗口嵌入到MFC窗口
    auto hWndWinui = reinterpret_cast<HWND>(winrt::get_abi(m_winuiWindow)->WindowHandle());
    SetParent(hWndWinui, hWndMfc);

    // 调整WinUI窗口大小匹配MFC客户区
    RECT rcClient;
    GetClientRect(hWndMfc, &rcClient);
    SetWindowPos(hWndWinui, nullptr, 0, 0, rcClient.right - rcClient.left, rcClient.bottom - rcClient.top, SWP_NOZORDER);

    return TRUE;
}

4. 处理消息循环同步 #

WinUI 3依赖DispatcherQueue处理UI消息，需在MFC的消息循环中加入WinUI消息处理：

• 找到MFC应用的CWinApp派生类的Run函数，修改为：

int CMyMfcApp::Run()
{
    // ... 原有代码
    while (PumpMessage())
    {
        // 处理WinUI 3的DispatcherQueue消息
        if (auto dispatcherQueue = winrt::Microsoft::UI::Dispatching::DispatcherQueue::GetForCurrentThread())
        {
            dispatcherQueue.TryProcessEvents(winrt::Microsoft::UI::Dispatching::DispatcherQueueProcessing::ProcessAllIfPresent);
        }
    }
    // ... 原有代码
}

5. 主题与资源整合 #

• 确保WinUI 3的主题与MFC窗口一致：在WinUI 3项目的App.xaml中设置RequestedTheme为和MFC匹配的值（Light/Dark）
• 避免资源命名冲突：MFC和WinUI 3的资源ID尽量不重复，必要时使用命名空间区分

二、推荐学习资料 #

书籍 #

• 《Windows Programming with C++》（最新版）：包含Win32与WinUI 3互操作的核心逻辑，可直接迁移到MFC场景，帮助理解底层窗口交互机制
• 《MFC Programming in Visual C++》：虽无WinUI 3直接内容，但能巩固MFC窗口管理、HWND操作等基础，是集成的必备前置知识

官方文档 #

• WinUI 3官方文档「Interop with Win32」章节：讲解Win32窗口与WinUI 3的交互方法，MFC作为Win32的封装，可直接套用这些逻辑
• MFC官方文档「Window Management」部分：深入理解MFC窗口的创建、HWND获取及消息循环机制

社区示例 #

• 微软官方WinUI 3示例仓库中的「Win32 Interop」项目：提供Win32嵌入WinUI 3的完整代码，只需将Win32窗口替换为MFC窗口的HWND即可复用

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