QWebEngineView 类

成员函数文档

[显式] QWebEngineView::QWebEngineView(QWidget *parent = nullptr)

构建一个空网页视图，父级为 parent。

另请参阅 load。

[显式，自6.4起] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

使用 profile 构建一个空网页视图，父级为 parent。

此功能自Qt 6.4起介绍。

另请参阅 load。

[显式，自6.4起] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

构建包含父 parent 的 page 的网页视图。

此功能自Qt 6.4起介绍。

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

[虚函数 noexcept] QWebEngineView::~QWebEngineView()

销毁网页视图。

[槽函数] void QWebEngineView::back()

这是一个方便的槽函数，用于加载由链接导航构建的文档列表中的上一个文档。如果没有上一个文档，则不做任何操作。

它与以下操作等价：

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

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

[重载虚保护函数] void QWebEngineView::closeEvent(QCloseEvent *event)

重新实现: QWidget::closeEvent(QCloseEvent *event)。

[重载虚保护函数] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

重新实现: QWidget::contextMenuEvent(QContextMenuEvent *event)。

QMenu *QWebEngineView::createStandardContextMenu()

创建一个标准上下文菜单，并返回其对指针。

[虚保护函数] QWebEngineView *QWebEngineView::createWindow(QWebEnginePage::WebWindowType type)

每当要创建指定 type 的新窗口时，都会从关联的 QWebEnginePage 的 createWindow() 方法调用此函数。例如，当通过 JavaScript 请求在新窗口中打开文档时。

另请参阅 QWebEnginePage::createWindow()。

[重载虚保护函数] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

重新实现: QWidget::dragEnterEvent(QDragEnterEvent *event)。

[重载虚保护函数] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

重新实现: QWidget::dragLeaveEvent(QDragLeaveEvent *event)。

[重载虚保护函数] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

重新实现: QWidget::dragMoveEvent(QDragMoveEvent *event)。

[重写虚保护] void QWebEngineView::dropEvent(QDropEvent *e)

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

[重写虚保护] 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。

[静态，自6.2以来] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

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

此函数是在Qt 6.2中引入的。

另请参阅：page()和setPage。

[槽函数] void QWebEngineView::forward()

这是一个方便的槽函数，用于加载由导航链接构建的文档列表中的下一个文档。如果没有下一个文档，则不执行任何操作。

它与以下操作等价：

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

另请参阅：back()和pageAction。

[重写虚保护] void QWebEngineView::hideEvent(QHideEvent *event)

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

QWebEngineHistory *QWebEngineView::history() const

返回指向视图已导航的网页历史记录的指针。

它与以下操作等价：

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

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

当与视图关联的图标("favicon")改变时，发出此信号。新图标由icon指定。

另请参阅：icon()，iconUrl()和iconUrlChanged。

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

当与视图关联的图标（收藏夹图标）的URL发生变化时，会发出此信号。新URL由url指定。

另请参阅：iconUrl(), icon(), 和 iconChanged().

[自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().

[信号] void QWebEngineView::loadFinished(bool ok)

当页面加载完成时，会发出此信号。ok将指示加载是否成功或发生错误。

另请参阅：loadStarted().

[信号] void QWebEngineView::loadProgress(int progress)

每当WebView中的某个元素完成加载时（例如内嵌的图像或脚本），都会发出此信号。因此，它跟踪加载WebView的总进度。

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

另请参阅：loadStarted() 和 loadFinished().

[信号] void QWebEngineView::loadStarted()

当开始新的页面加载时，会发出此信号。

另请参阅：loadProgress() 和 loadFinished().

QWebEnginePage *QWebEngineView::page() const

返回底层网页的指针。

另请参阅：setPage().

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

返回指向一个封装了指定网页操作的QAction指针。如果QAction缺少图标，此函数还将其设置为默认样式图标。

[信号, 自6.2版本开始] void QWebEngineView::pdfPrintingFinished(const QString &filePath, bool success)

当网页打印到PDF文件完成时发出此信号。filePath将包含请求创建文件的路径，而success将根据文件是否成功创建返回true或false。

此函数是在Qt 6.2中引入的。

另请参阅 printToPdf。

[自6.2版本开始] void QWebEngineView::print(QPrinter *printer)

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

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

完成后，将发出信号printFinished()，对于成功或失败分别带有true或false。

用户负责确保在发出printFinished()之前printer保持有效。

此函数是在Qt 6.2中引入的。

[信号, 自6.2版本开始] void QWebEngineView::printFinished(bool success)

当调用print()请求打印完成时发出此信号。参数success对于成功返回true或对于失败返回false。

此函数是在Qt 6.2中引入的。

另请参阅 print。

[信号, 自6.2版本开始] void QWebEngineView::printRequested()

当调用JavaScript window.print()方法或用户按下PDF查看器插件的打印按钮时发出此信号。通常，信号处理程序可以简单地调用print()。

此函数是在Qt 6.2中引入的。

另请参阅 print。

[自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的const引用作为参数。如果打印成功，此字节数组将包含PDF数据，否则，字节数组将为空。

此函数是在Qt 6.2中引入的。

[槽函数] void QWebEngineView::reload()

重新加载当前文档。

另请参阅stop、pageAction和loadStarted。

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

当渲染进程以非零退出状态终止时发出此信号。terminationStatus是进程的终止状态，exitCode是进程终止时的状态码。

[信号] void QWebEngineView::selectionChanged()

每当选择发生更改时，都会发出此信号。

另请参阅selectedText。

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

将网页视图的内容设置为数据。如果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，例如引用的图像或样式表。例如，如果html是从http://www.example.com/documents/overview.html（基URL）检索到的，则使用相对URL引用的图像diagram.png应位于http://www.example.com/documents/diagram.png。

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

在此方法中，除非指定否则，Qt WebEngine假定外部资源（例如JavaScript程序或样式表）使用UTF-8编码。例如，可以通过HTML script标签的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();

[覆盖虚拟受保护] void QWebEngineView::showEvent(QShowEvent *event)

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

[覆盖虚函数] QSize QWebEngineView::sizeHint() const

重新实现属性访问函数：QWidget::sizeHint。

[槽函数] void QWebEngineView::stop()

方便的槽函数，用于停止文档的加载。

它与以下操作等价：

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

另见 reload()，pageAction()，以及 loadFinished()。

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

每当视图的标题发生变化时，发出此信号。

另见 title()。

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

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

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

    view->triggerPageAction(QWebEnginePage::Copy);

另见 pageAction()。

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

当视图的URL发生变化时，发出此信号。

另见 url()以及load()。