Qt中文网站 > 使用教程 > Qt如何做Web集成 Qt WebEngine模块如何使用
Qt如何做Web集成 Qt WebEngine模块如何使用
发布时间:2025/07/21 11:55:10

品牌型号:联想 E550C ThinkPad

系统:Windows 11

软件版本:Qt 6

生活中我们无处不在地看到应用与Web网页的无缝集成,如微信打开普通的H5网页、小程序的WebView视图、抖音的内嵌浏览器,甚至是桌面软件中的在线帮助文档。这种混合应用模式已经成为现代软件开发的标准配置,它既保留了原生应用的性能优势,又兼具Web应用的灵活性和易更新特性,在Qt中,其通过其强大的WebEngine模块为开发者们提供了实现这种混合架构的理想工具。因此,本文就来讲一讲Qt如何做Web集成,Qt WebEngine模块如何使用。

一、Qt如何做Web集成

Qt中进行Web网页集成,有两种不同的方式,分别是:

1、Qt WebKit。这是一个老的Qt Web集成方案,它在Qt 5.6后停止维护,但仍然可以进行使用,它支持基础的HTTP和HTTPS协议,以及HTML、Java、CSS的渲染执行。

使用时我们需要添加“webkit webkitwidgets”依赖,再在cpp文件中定义一个QWebView对象并调用load方法加载Web网页,通过back、reload、stop等方法进行网页操作。

Qt Webkit集成
图1:Qt Webkit集成

2、Qt WebEngine。Qt WebEngine基于Chromium项目,提供了对现代Web标准的完整支持,它使用与谷歌浏览器相同的渲染引擎,确保了与各种网站的兼容性,并且性能更加出色,安全更新及时,还支持Service Worker等现代Web API,非常适合现代应用程序Web网页集成方案。

WebEngine架构
图2:WebEngine架构

二、Qt WebEngine模块如何使用

上文提到Qt WebEngine可用于集成和渲染网页,那么我们到底该如何使用它呢?

1、打开Qt维护工具,点击“添加或移除组件”功能,在搜索框中搜索“WebEngine”安装该模块,从Qt 6.8.3开始该模块就在Extensions中安装,在此之前则在Qt对应版本的Additional Libraries中安装,安装完成后通过配置文件添加“webenginewidgets”导入依赖。

安装WebEngine
图3:安装WebEngine

2、在主文件中,使用“#include ”引入头文件,再通过“QWebEngineView *view = new QWebEngineView(parent)”定义一个view视图对象,在“view.load()”方法中传入一个QUrl网页地址对象来加载网页,最后使用“view.show()”方法展示网页,这样一个简单的web集成功能就做好了。

渲染网页
图4:渲染网页

3、QWebEngineView对象还有很多公共函数方法,我们在“https://doc.qt.io/qt-6/zh/qwebengineview.html”文档中可以查阅到。常用的方法有history查看历史记录、printToPdf打印为PDF、setHtml设置网页内容等。

WebEngine公共方法
图5:WebEngine公共方法

4、QWebEngineView还有一些信号绑定事件,可以在某个事件触发时触发自定义信号槽方法来执行特定动作,如loadFinished网页加载完成事件、urlChanged地址跳转事件、printRequested打印请求事件、loadProgress加载元素完成事件。

WebEngine事件绑定
图6:WebEngine事件绑定

在当今网页与原生应用深度融合的时代,Qt WebEngine模块凭借其基于Chromium的先进架构,为开发者提供了强大的Web集成能力。通过本文的系统讲解,我们完整掌握了Qt如何做Web集成,Qt WebEngine模块如何使用的主要方法,相信通过合理运用这些功能,我们也能够构建出既保留原生应用性能优势,又具备Web灵活特性的高质量应用程序。

读者也访问过这里:
135 2431 0251