mfc使用 cef2623

### 如何在MFC应用程序中嵌入和使用CEF浏览器 #### 创建新的MFC项目并配置环境 为了使 MFC 应用程序能够成功加载 CEF 浏览器，创建一个新的基于对话框的 MFC 工程是第一步。接着需要引入 `cefsimple` 中的相关文件来构建项目的架构[^3]。 #### 添加必要的源码和支持文件 将 Chromium Embedded Framework 的简单示例工程 (`cefsimple`) 下的所有 .cpp 和 .h 文件复制到新建立的 MFC 项目之中。这些文件包含了启动 CEF 所必需的核心逻辑以及初始化过程所需的函数定义。 #### 调整预编译头设置 由于默认情况下 MFC 使用预编译头 (PCH)，这可能会与 CEF 的某些特性发生冲突。因此建议关闭该项目内的 PCH 功能以避免潜在的问题。具体操作是在属性管理器里找到对应的选项并将它设为不使用预编译头文件[^1]。 #### 配置包含路径和链接库 为了让 Visual Studio 正确识别来自 CEF SDK 的接口声明和其他依赖项，需指定额外的包含目录以便访问头文件；同时也要指明静态或动态链接时所要用到的库的位置。通常做法是在项目属性页下的 VC++ 目录节点下添加相应的文件夹路径。 - **头文件夹**: 将 CEF 安装包解压后的 include 子目录加入全局包含路径列表； - **库文件夹**: 对于 Release 版本应指向 \path\to\cef_binary\[version]\Release ，Debug 则对应 Debug 文件夹。 #### 解决可能出现的编译问题 初次尝试编译时很可能会遇到一些警告甚至错误提示。针对这些问题逐一排查修正直至整个解决方案能顺利通过编译阶段。常见的调整包括但不限于： - 修改宏定义 `_WIN32_WINNT=0x0A00` 或更高版本确保 Windows API 支持程度满足要求； - 如果存在未解析外部符号，则检查是否遗漏了某个重要的导入库(.lib)或者拼写有误。 #### 实现基本的功能扩展 完成上述准备工作之后就可以着手开发具体的业务逻辑了。比如自定义窗口类重载 WM_CREATE 消息处理函数用于实例化 CefWindowInfo 结构体并调用 CefBrowserHost::CreateBrowser() 方法创建实际可见的 web 页面容器对象。 ```cpp // 在对话框类中增加成员变量保存客户端适配器句柄 HWND hWndClient; // OnCreate 函数内部片段示意 if (!CefCurrentlyOn(TID_UI)) { // Ensure all CEF operations happen on UI thread. CefPostTask(TID_UI, base::BindOnce(&YourDialogClass::OnCreate, this)); } // Initialize the window info structure. CefWindowInfo window_info; #if defined(OS_WIN) window_info.SetAsChild(hWndClient); #endif // Create browser instance with default settings and no client handler. CefBrowserSettings browser_settings; CefBrowserHost::CreateBrowser(window_info, nullptr /*client*/, "https://www.example.com", browser_settings, nullptr /*extra_info*/); return TRUE; // return TRUE unless you set the focus to a control // EXCEPTION: OCX Property Pages should return FALSE ``` #### 加入清单文件支持 对于现代操作系统而言，应用程序可能还需要附带一个 application manifest 来声明其运行权限级别以及其他元数据信息。可以通过资源视图向导轻松地把 app.manifest 文件纳入工程项目当中去，并适当编辑其中的内容使其适应当前场景的需求。 ---

### MFC 集成 CEF 使用教程及示例代码 将 Chromium Embedded Framework (CEF) 集成到 Microsoft Foundation Classes (MFC) 应用中，可以显著提升桌面应用的交互性和功能扩展能力。以下是集成 CEF 到 MFC 应用的具体步骤和示例代码[^1]。 #### 1. 初始化 CEF 环境 在 MFC 应用程序的入口点（通常是 `WinMain` 或 `InitInstance` 方法）中，需要初始化 CEF 的运行环境。以下是一个完整的初始化代码示例： ```cpp #include "include/cef_app.h" #include "include/cef_client.h" #include "include/cef_browser.h" HINSTANCE hInstance = AfxGetInstanceHandle(); int exit_code; void* sandbox_info = nullptr; // 初始化 CEF 参数 CefMainArgs main_args(hInstance); exit_code = CefExecuteProcess(main_args, nullptr, sandbox_info); if (exit_code >= 0) { return exit_code; } CefRefPtr<CefCommandLine> command_line = CefCommandLine::CreateCommandLine(); command_line->InitFromString(::GetCommandLineW()); CefSettings settings; settings.no_sandbox = true; // 禁用沙盒模式以简化调试 CefRefPtr<SimpleApp> app(new SimpleApp); // 自定义的 CEF 应用类 CefInitialize(main_args, settings, app.get(), sandbox_info); ``` 上述代码完成了 CEF 的初始化工作，并设置了必要的参数，例如禁用沙盒模式以避免复杂性[^3]。 #### 2. 创建浏览器窗口 在 MFC 应用中嵌入 CEF 浏览器窗口，需要创建一个自定义的 CEF 客户端类，并将其与 MFC 的窗口控件关联。以下是一个简单的实现： ```cpp class SimpleClient : public CefClient, public CefLifeSpanHandler { public: CefRefPtr<CefLifeSpanHandler> GetLifeSpanHandler() override { return this; } void OnAfterCreated(CefRefPtr<CefBrowser> browser) override { CEF_REQUIRE_UI_THREAD(); m_Browser = browser; } private: CefRefPtr<CefBrowser> m_Browser; }; void CreateBrowser(CefWindowInfo& window_info, CefRefPtr<CefClient>& client, const CefString& url) { CefBrowserHost::CreateBrowser(window_info, client, url, CefBrowserSettings()); } ``` 此代码定义了一个简单的客户端类 `SimpleClient`，并提供了创建浏览器窗口的功能。通过调用 `CreateBrowser` 函数，可以在指定的窗口中加载网页。 #### 3. 将 CEF 嵌入 MFC 窗口 为了将 CEF 浏览器嵌入到 MFC 的窗口中，需要设置 `CefWindowInfo` 并将其与 MFC 的窗口句柄关联。以下是一个示例： ```cpp CefWindowInfo window_info; window_info.SetAsChild((HWND)m_hWnd); // 将 CEF 嵌入到 MFC 窗口中 CefRefPtr<SimpleClient> client(new SimpleClient()); CreateBrowser(window_info, client, "https://www.example.com"); ``` 这段代码将 CEF 浏览器嵌入到当前 MFC 窗口的句柄中，并加载指定的 URL 地址[^3]。 #### 4. 清理资源 在应用程序退出时，需要正确释放 CEF 的资源以避免内存泄漏。以下是一个清理代码示例： ```cpp CefShutdown(); ``` 确保在应用程序的退出逻辑中调用 `CefShutdown()`，以完成资源的释放。 --- ###