QWebEngineView Class

成员函数文档

[explicit] QWebEngineView::QWebEngineView(QWidget *parent = nullptr)

用父parent 构建一个空的网络视图。

另请参阅 load() 。

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

构造一个包含page 和父parent 的网络视图。

此函数在 Qt 6.4 中引入。

另请参阅 load() 和setPage()。

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

使用profile 与父parent 构建一个空网络视图。

此函数在 Qt 6.4 中引入。

另请参阅 load()。

[virtual noexcept] QWebEngineView::~QWebEngineView()

销毁网页视图。

[slot] void QWebEngineView::back()

在通过导航链接建立的文档列表中加载前一个文档的便利槽。如果没有前一个文档，则不执行任何操作。

它等同于

    view->page()->triggerAction(QWebEnginePage::Back);

另请参阅 forward() 和pageAction()。

[override virtual protected] void QWebEngineView::closeEvent(QCloseEvent *event)

重实现：QWidget::closeEvent(QCloseEvent *event).

[override virtual protected] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

重实现：QWidget::contextMenuEvent(QContextMenuEvent *event).

QMenu *QWebEngineView::createStandardContextMenu()

创建标准上下文菜单并返回指向该菜单的指针。

[virtual protected] QWebEngineView *QWebEngineView::createWindow(QWebEnginePage::WebWindowType type)

每次页面要为给定的type 创建新窗口时，都会从相关QWebEnginePage 的createWindow() 方法中调用该函数。例如，当发出在新窗口中打开文档的 JavaScript 请求时。

另请参阅 QWebEnginePage::createWindow()。

[override virtual protected] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

重实现：QWidget::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

重实现：QWidget::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

重实现：QWidget::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)

重实现：QWidget::dropEvent(QDropEvent *event).

[override virtual protected] bool QWebEngineView::event(QEvent *ev)

重实现：QWidget::event(QEvent *event).

void QWebEngineView::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

使用给定的options 在页面中查找指定的字符串subString 。

要清除选择，只需传递空字符串即可。

resultCallback 必须包含一个QWebEngineFindTextResult 参数。

另请参阅 selectedText() 和selectionChanged()。

[static, since 6.2] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

返回与page 关联的视图（如有）。

此函数在 Qt 6.2 中引入。

另请参阅 page() 和setPage()。

[slot] void QWebEngineView::forward()

便利槽，用于加载通过导航链接建立的文档列表中的下一个文档。如果没有下一个文档，则不执行任何操作。

它等同于

    view->page()->triggerAction(QWebEnginePage::Forward);

另请参阅 back() 和pageAction()。

[override virtual protected] void QWebEngineView::hideEvent(QHideEvent *event)

重实现：QWidget::hideEvent(QHideEvent *event).

QWebEngineHistory *QWebEngineView::history() const

返回视图历史导航网页的指针。

它等同于

    view->page()->history();

[signal] void QWebEngineView::iconChanged(const QIcon &icon)

当与视图关联的图标（"favicon"）发生变化时，将发出该信号。新图标由icon 指定。

另请参阅 icon()、iconUrl() 和iconUrlChanged()。

[signal] void QWebEngineView::iconUrlChanged(const QUrl &url)

当与视图关联的图标（"favicon"）的 URL 发生变化时，就会发出该信号。新 URL 由url 指定。

另请参阅 iconUrl()、icon() 和iconChanged()。

[since 6.2] QWebEngineContextMenuRequest *QWebEngineView::lastContextMenuRequest() const

返回当前上下文菜单的附加数据。只有在调用contextMenuEvent() 时才保证有效。

此函数在 Qt 6.2 中引入。

另请参阅 createStandardContextMenu()。

void QWebEngineView::load(const QUrl &url)

加载指定的url 并显示。

另请参阅 load()、setUrl( )、url( )、urlChanged() 和QUrl::fromUserInput() 。

void QWebEngineView::load(const QWebEngineHttpRequest &request)

发出指定的request 并加载响应。

另请参阅 load(),setUrl(),url(),urlChanged() 和QUrl::fromUserInput().

[signal] void QWebEngineView::loadFinished(bool ok)

该信号在页面加载完成时发出。ok 将显示加载成功还是出错。

另请参见 loadStarted().

[signal] void QWebEngineView::loadProgress(int progress)

每次网页视图中的元素（如嵌入式图像或脚本）加载完成时，都会发出该信号。因此，它可以跟踪网页视图的整体加载进度。

当前值由progress 提供，范围从 0 到 100，这是QProgressBar 的默认范围。

另请参阅 loadStarted() 和loadFinished()。

[signal] void QWebEngineView::loadStarted()

该信号在开始加载新页面时发出。

另请参阅 loadProgress() 和loadFinished()。

QWebEnginePage *QWebEngineView::page() const

返回指向底层网页的指针。

另请参见 setPage()。

QAction *QWebEngineView::pageAction(QWebEnginePage::WebAction action) const

返回指向QAction 的指针，该指针封装了指定的网络操作action 。如果QAction 缺少默认样式图标，该函数也会将其设置为默认样式图标。

[signal, since 6.2] void QWebEngineView::pdfPrintingFinished(const QString &filePath, bool success)

当将网页打印为 PDF 文件的过程结束时，将发出该信号。filePath 将包含请求创建文件的路径，如果文件创建成功，success 将为true ，否则为false 。

此函数在 Qt 6.2 中引入。

另请参阅 printToPdf()。

[since 6.2] void QWebEngineView::print(QPrinter *printer)

将页面当前内容渲染为临时 PDF 文档，然后使用printer 打印。

创建和打印 PDF 文档的设置将从printer 对象中获取。

完成后，将发出printFinished() 信号，成功则表示true ，失败则表示false 。

用户有责任确保printer 在printFinished() 发送之前一直有效。

此函数在 Qt 6.2 中引入。

[signal, since 6.2] void QWebEngineView::printFinished(bool success)

当使用print() 请求的打印完成时，将发出该信号。成功时，参数success 为true ；失败时，参数false 。

此函数在 Qt 6.2 中引入。

另请参阅 print()。

[signal, since 6.2] void QWebEngineView::printRequested()

当调用 JavaScriptwindow.print() 方法或用户按下 PDF 阅读器插件的打印按钮时，就会发出该信号。通常，信号处理程序只需调用print() 即可。

自 6.8 版起，该信号只在主帧中发出，而不是在任何请求打印的帧中发出。

该函数在 Qt 6.2 中引入。

另请参阅 printRequestedByFrame() 和print()。

[signal, since 6.8] void QWebEngineView::printRequestedByFrame(QWebEngineFrame frame)

在frame 上调用 JavaScriptwindow.print() 方法时，会发出该信号。如果该帧是主帧，则会发出printRequested 。

此函数在 Qt 6.8 中引入。

另请参阅 printRequested() 和print()。

[since 6.2] void QWebEngineView::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

将页面的当前内容渲染为 PDF 文档，并保存到filePath 中指定的位置。生成的 PDF 文档的页面大小和方向取自layout 中指定的值，而打印页面的范围取自ranges ，默认为打印所有页面。

该方法发出异步请求，将网页打印成 PDF，并立即返回。要了解请求结果，请连接信号pdfPrintingFinished() 。

如果在提供的文件路径下已经存在文件，该文件将被覆盖。

此函数在 Qt 6.2 中引入。

另请参阅 pdfPrintingFinished().

[since 6.2] void QWebEngineView::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

将页面的当前内容渲染为 PDF 文档，并返回一个包含 PDF 数据的字节数组作为resultCallback 的参数。生成的 PDF 文档的页面大小和方向取自layout 中指定的值，而打印页面的范围取自ranges ，默认为打印所有页面。

resultCallback 必须将QByteArray 的常量引用作为参数。如果打印成功，该字节数组将包含 PDF 数据，否则该字节数组将为空。

此函数在 Qt 6.2 中引入。

[slot] void QWebEngineView::reload()

重新读取当前文件。

另请参阅 stop()、pageAction() 和loadStarted()。

[signal] void QWebEngineView::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

terminationStatus 是进程的终止状态，exitCode 是进程终止时的状态代码。

[signal] void QWebEngineView::selectionChanged()

每当选择内容发生变化时，就会发出该信号。

另请参阅 selectedText().

void QWebEngineView::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

将网页视图的内容设置为data 。如果mimeType 参数为空，则假定内容为text/plain,charset=US-ASCII 。

内容中引用的外部对象位于baseUrl 的相对位置。要加载带有相对 URL 的外部对象，baseUrl 不能为空。

数据立即加载；外部对象异步加载。

另请参阅 load()、setHtml() 和QWebEnginePage::toHtml()。

void QWebEngineView::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

将网页视图的内容设置为指定的html 内容。

baseUrl 是可选项，用于解析文档中的相对 URL，如引用的图像或样式表。例如，如果 是通过 （基本 URL）获取的，那么使用相对 URL 引用的图像应位于 。html http://www.example.com/documents/overview.html diagram.png http://www.example.com/documents/diagram.png

HTML 文档是立即加载的，而外部对象则是异步加载的。

使用这种方法时，除非另有说明，否则Qt WebEngine 假定外部资源（如 JavaScript 程序或样式表）是以 UTF-8 编码的。例如，可以通过 HTML 脚本标记的charset 属性指定外部脚本的编码。另外，编码也可以由网络服务器指定。

这是一个相当于setContent(html, "text/html;charset=UTF-8", baseUrl) 的方便函数。

另请参阅 load(),setContent(),QWebEnginePage::toHtml() 和QWebEnginePage::setContent() 。

void QWebEngineView::setPage(QWebEnginePage *page)

使page 成为网页视图的新网页。

所提供页面的父QObject 仍然是该对象的所有者。如果当前页面是网页视图的子页面，它将被删除。

另请参阅 page()。

QWebEngineSettings *QWebEngineView::settings() const

返回指向视图或页面特定设置对象的指针。

它等同于

    view->page()->settings();

[override virtual protected] void QWebEngineView::showEvent(QShowEvent *event)

重实现：QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QWebEngineView::sizeHint() const

重构属性访问函数：QWidget::sizeHint 。

[slot] void QWebEngineView::stop()

方便停止加载文档的插槽。

它等同于

    view->page()->triggerAction(QWebEnginePage::Stop);

另请参阅 reload()、pageAction() 和loadFinished()。

[signal] void QWebEngineView::titleChanged(const QString &title)

每当视图的title 发生变化时，就会发出该信号。

另请参见 title().

void QWebEngineView::triggerPageAction(QWebEnginePage::WebAction action, bool checked = false)

触发指定的action 。如果是可选中操作，则假定指定的checked 状态。

下面的示例触发了复制操作，因此会将任何选中的文本复制到剪贴板。

    view->triggerPageAction(QWebEnginePage::Copy);

另请参阅 pageAction().

[signal] void QWebEngineView::urlChanged(const QUrl &url)

当视图的url 发生变化时会发出该信号。

另请参阅 url() 和load()。