如何在MFC项目中将WebView2控件添加到CDialog资源中？

我来帮你搞定把WebView2集成到CDialog里的问题！其实和你之前在View里的操作思路差不多，只是要针对对话框的特性调整几个关键步骤，具体如下：

首先确认下：你已经跑通了View风格的WebView2项目，那WebView2的依赖配置（头文件、链接库、运行时环境）应该没问题，咱们直接进入对话框适配部分。

1. 先给WebView2准备占位容器 #

打开你的对话框资源模板，添加一个**静态控件（Static Control）**作为WebView2的占位区域，记得记下它的ID（比如设为IDC_WEBVIEW_CONTAINER）。这个控件的大小和位置，就是WebView2最终显示的区域；如果你想让WebView2铺满整个对话框客户区，也可以跳过这一步，直接用对话框本身作为容器。

2. 在对话框类里添加WebView2成员 #

在你的CDialog派生类头文件中，添加WebView2的核心成员变量：

#include "WebView2.h"
#include "WebView2Environment.h"

class CMyDialog : public CDialog
{
    // 其他已有成员...
private:
    Microsoft::WRL::ComPtr<ICoreWebView2> m_webView;          // WebView2核心对象
    Microsoft::WRL::ComPtr<ICoreWebView2Environment> m_webEnv; // WebView2环境对象
};

3. 异步初始化WebView2并绑定到对话框 #

WebView2的初始化是异步的，咱们要在对话框的OnInitDialog()方法里完成环境初始化，再创建控件并挂载到占位容器上：

BOOL CMyDialog::OnInitDialog()
{
    CDialog::OnInitDialog();

    // 第一步：初始化WebView2运行环境
    HRESULT hr = CreateCoreWebView2EnvironmentWithOptions(nullptr, nullptr, nullptr,
        Callback<ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
            [this](HRESULT result, ICoreWebView2Environment* env) -> HRESULT {
                if (SUCCEEDED(result))
                {
                    m_webEnv = env;
                    // 获取占位控件的窗口句柄
                    CWnd* pContainer = GetDlgItem(IDC_WEBVIEW_CONTAINER);
                    if (pContainer)
                    {
                        HWND hContainer = pContainer->GetSafeHwnd();
                        // 第二步：创建WebView2控制器并绑定到容器
                        m_webEnv->CreateCoreWebView2Controller(hContainer,
                            Callback<ICoreWebView2CreateCoreWebView2ControllerCompletedHandler>(
                                [this, hContainer](HRESULT result, ICoreWebView2Controller* controller) -> HRESULT {
                                    if (SUCCEEDED(result))
                                    {
                                        // 获取WebView2核心对象
                                        controller->get_CoreWebView2(&m_webView);
                                        // 设置WebView2大小和占位容器一致
                                        RECT containerRect;
                                        GetClientRect(hContainer, &containerRect);
                                        controller->put_Bounds(containerRect);

                                        // 可选：注册导航完成事件，做自定义逻辑
                                        m_webView->add_NavigationCompleted(
                                            Callback<ICoreWebView2NavigationCompletedEventHandler>(
                                                [this](ICoreWebView2*, ICoreWebView2NavigationCompletedEventArgs* args) -> HRESULT {
                                                    // 这里可以写导航完成后的处理代码
                                                    return S_OK;
                                                }).Get(), nullptr);

                                        // 加载目标网页（本地文件或在线URL都可以）
                                        m_webView->Navigate(L"https://www.microsoft.com");
                                    }
                                    return S_OK;
                                }).Get());
                    }
                }
                return S_OK;
            }).Get());

    return TRUE;
}

4. 适配对话框大小变化（可选） #

如果你的对话框支持调整窗口大小，记得在OnSize()方法里同步更新WebView2的尺寸：

void CMyDialog::OnSize(UINT nType, int cx, int cy)
{
    CDialog::OnSize(nType, cx, cy);

    if (m_webView && nType != SIZE_MINIMIZED)
    {
        CWnd* pContainer = GetDlgItem(IDC_WEBVIEW_CONTAINER);
        if (pContainer)
        {
            RECT rect;
            pContainer->GetClientRect(&rect);
            pContainer->ClientToScreen(&rect);
            ScreenToClient(&rect);

            Microsoft::WRL::ComPtr<ICoreWebView2Controller> controller;
            m_webView->get_Controller(&controller);
            if (controller)
            {
                controller->put_Bounds(rect);
            }
        }
    }
}

几个关键提醒 #

• 一定要异步操作：WebView2的环境初始化和控件创建都是异步的，所有后续操作必须放在对应的回调函数里，不能在OnInitDialog里同步执行。
• 运行时检查：确保目标机器安装了WebView2运行时，或者你的项目打包了WebView2的 redistributable 包。
• 无占位容器的情况：如果不需要静态控件占位，直接把对话框的HWND（this->GetSafeHwnd()）传给CreateCoreWebView2Controller，再把Bounds设为对话框的客户区即可。

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