公众号:cpp手艺人
QWebEngine 常用 API 全面梳理(超全版本)
Qt WebEngine 基于 Chromium,但提供了 Qt 风格的 API。本文对 QWebEngine 的常用类与 API 进行系统梳理,帮助你快速掌握其开发全景。
1. QWebEngineView(视图层)
QWebEngineView 是最常用的 UI 控件,主要负责:
- 加载 URL
- 渲染 HTML
- 对接 QWebEnginePage
- 提供滚动、缩放、键鼠事件等
1、常用 API
| 功能 | API |
|---|---|
| 加载网页 | load(QUrl) |
| 设置页面对象 | setPage(QWebEnginePage*) |
| 获取页面对象 | page() |
| 加载 HTML 字符串 | setHtml(QString html, QUrl baseUrl) |
| 后退 / 前进 / 刷新 | back()/forward()/reload() |
| 放大缩小 | setZoomFactor() |
| 触发打印 | print()/ Qt6:printToPdf() |
| 获取标题 | titleChangedsignal |
| URL 变化 | urlChangedsignal |
| 右键菜单 | 重写contextMenuEvent()或设置setContextMenuPolicy() |
2. QWebEnginePage(页面控制层)
页面逻辑核心,包括:
- 页面事件
- 权限控制(地理位置、摄像头、麦克风等)
- JS 执行
- 导航控制
- 下载、拦截等
1、常用 API
| 功能 | API |
|---|---|
| 加载控制 |