如何在Delphi 10.2 Tokyo的FMX项目中用CEF4Delphi显示网页?
在Delphi 10.2 Tokyo的FMX项目中用CEF4Delphi实现网页显示
我刚好有过在Delphi 10.2 Tokyo的FMX项目里用CEF4Delphi做网页显示的经验,给你整理个清晰的实操步骤,亲测可行:
一、准备工作
- 确保你安装的CEF4Delphi版本适配Delphi 10.2 Tokyo,并且已经正确加载了FMX相关的包(比如
CEF4DelphiFMX.dpk和CEF4DelphiFMX.dproj)。 - 确认CEF的架构(32位/64位)和你的项目编译目标一致,同时把CEF的资源文件(
locales文件夹、swiftshader文件夹、各种.dll文件)复制到你的EXE输出目录,不然CEF启动会失败。
二、核心组件选择
别纠结离屏渲染示例了,CEF4Delphi专门提供了TChromiumFMX组件,完全满足你“只显示网页内容”的需求,而且比离屏渲染更简单直接。
三、具体实现步骤
- 添加组件:新建FMX项目后,在Form上拖放一个
TChromiumFMX组件,调整它的大小铺满整个Form(或者你需要显示网页的区域)。 - 初始化CEF:在Form的
OnCreate事件里加入以下代码:procedure TForm1.FormCreate(Sender: TObject); begin // 初始化CEF主进程,这是必须的步骤 if not GlobalCEFApp.StartMainProcess then begin ShowMessage('CEF初始化失败'); Application.Terminate; Exit; end; // 加载目标网页 ChromiumFMX1.LoadURL('https://www.example.com'); end; - 优雅关闭:在Form的
OnClose事件里处理CEF的关闭逻辑,避免内存泄漏:procedure TForm1.FormClose(Sender: TObject; var Action: TCloseAction); begin // 通知Chromium关闭浏览器 ChromiumFMX1.CloseBrowser(True); // 等待CEF进程结束 while ChromiumFMX1.Browser <> nil do Application.ProcessMessages; Action := TCloseAction.caFree; end;
四、隐藏URL相关元素
放心,TChromiumFMX本身就没有自带的地址栏、导航按钮这些控件,只要你不额外添加相关UI元素,界面上就只会显示网页内容,完全符合你的需求。
额外提示
- 如果需要监听网页加载状态(比如加载完成、加载错误),可以用
TChromiumFMX的OnLoadEnd、OnLoadError等事件来处理。 - 如果遇到网页显示异常,先检查CEF资源文件是否齐全,或者尝试切换CEF的渲染模式(在
GlobalCEFApp里设置相关属性)。
内容的提问来源于stack exchange,提问作者SeoYong Moon
相关产品推荐
相关产品推荐

