[TOC]

# QWebEngineView Class

QWebEngineView类提供了一个widget, 被使用去查看和编辑web元素。

属性方法
头文件#include
qmake参数QT += webenginewidgets
继承QWidget

特性

属性名类型
hasSelectionconst bool
titleconst QString
iconconst QIcon
zoomFactorqreal
selectedTextconst QString

公共成员函数

类型函数名
QWebEngineView(QWidget *parent = Q_NULLPTR)]
virtual~QWebEngineView()
voidfindText(const QString &subString, QWebEnginePage::FindFlags options = ..., const QWebEngineCallback &resultCallback = ...)]
boolhasSelection() const
QWebEngineHostory *history() const
QIconicon() const
QUrliconUrl() const
voidload(const QUrl &url)
voidload(const QWebEngineHttpRequest &request)
QWebEnginePage *page() const
QAction *pageAction(QWebEnginePage::WebAction action) const
QStringselectedText() const
voidsetContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())
voidsetHtml(const QString &html, const QUrl &baseUrl = QUrl())
voidsetPage(QWebEnginePage *page)
voidsetUrl(const QUrl &url)
voidsetZoomFactor(qreal factor)
QWebEngineSettings *settings() const
QStringtitle() const
voidtriggerPageAction(QWebEnginePage::WebAction action, bool checked = false)
QUrlurl() const
qrealzoomFactor() const

重实现公共成员函数

virtual QSize sizeHint() const override

  • 216 个公共成员函数继承自 QWidget
  • 31 个公共成员函数继承自 QObject
  • 14 个公共成员函数继承自 QPaintDevice

公有槽函数

类型函数名
voidback()
voidforward()
voidreload()
voidstop()
  • 19 个公共槽函数继承自 QWidget
  • 1 个公共槽函数继承自 QObject

信号

类型函数名
voidiconChanged(const QIcon &icon)
voidiconUrlChanged(const QUrl &url)
voidiconUrlChanged(const QUrl &url)
voidloadProgress(int progress)
voidloadStarted()
voidrenderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)
voidselectionChanged()
voidtitleChanged(const QString &title)
voidurlChanged(const QUrl &url)
  • 3 signals inherited from QWidget
  • 2 signals inherited from QObject

静态公有成员函数

  • 5 个静态公有成员函数继承自 QWidget
  • 9 个静态公有成员函数 QObject

保护成员函数

virtual QWebEngineView * createWindow(QWebEnginePage::WebWindowType type)

重实现保护成员函数

类型函数名
vitrual voidcontextMenuEvent(QContextMenuEvent *event) override
virtual voiddragEnterEvent(QDragEnterEvent *e) override
virtual voiddragLeaveEvent(QDragLeaveEvent *e) override
virtual voiddragMoveEvent(QDragMoveEvent *e) override
virtual voiddropEvent(QDropEvent *e) override
virtual boolevent(QEvent *ev) override
virtual voidhideEvent(QHideEvent *event) override
virtual voidshowEvent(QShowEvent *event) override
  • 35 个保护成员函数继承自 QWidget

  • 9 个保护成员函数继承自 QObject

  • 1 个保护成员函数继承自 QPaintDevice

额外继承成员

  • 一个保护槽继承自QWidget

详细描述

QWebEngineView类提供了一个小部件, 被用去查看和编辑web文档。

一个web视图是组成Qt WebEngine web 浏览模块的主要widget之一。它可以被用于多种应用去展示来自Internet的web内容。

一个web元素可以通过load()函数加载到web视图。一般总是使用Get方法去加载URLs.

像所有Qt小部件一样,必须调用show()函数才能显示Web视图。 下面的代码段说明了这一点:

QWebEngineView *view = new QWebEngineView(parent);
      view->load(QUrl("http://qt-project.org/"));
      view->show();

或者, setUrl() 可以被使用去加载web元素。如果你有可读的 HTML 内容,你可以使用setHtml() 代替。

当视图开始加载的时候,发出loadStarted() 信号,当web视图的一个元素被完整加载的时候,发出loadProgress()信号,例如一个embedded 图像或一个脚本。当视图被完整加载时,发出loadFinished()信号。其参数true或false指示加载是成功还是失败。

page()函数返回一个指向web页对象的指针。一个QWebEngineView 包含一个QWebEnginePage, 允许依次访问QWebEnginePage在页的内容里。HTML文档的标题可以用title()属性访问。另外,一个web元素可能是一个图标, 可以使用icon()访问,使用 iconUrl()访问图标的URL。如果标题或是图标改变,将发出titleChanged(), iconChanged() 和 iconUrlChanged()信号来回应。zoomFactor()属性通过缩放因子,能够缩放web页的内容。

该小部件适合于上下文菜单并包含在浏览器中有用的操作。对于自定义上下文菜单,或将动作嵌入菜单或工具栏中,可通过pageAction()获得单个动作。web视图维护返回动作的状态,但允许修改动作属性,例如text or icon. 动作语义也可以通过 triggerPageAction()直接触发。

对于web元素,如果你想要提供 支持允许用户去打开新的窗口,例如pop-up windows, 你可以子类化QWebEngineView 和实现 createWindow() 函数。

您也可以在 WebEngine Widgets Simple Browser Example, WebEngine Content Manipulation Example, 和 WebEngine Markdown Editor Example的文档中找到相关的信息。

特性文档编制

属性名类型
hasSelectionconst bool

此属性保存此页面是否包含所选内容。 默认情况下,此属性为false。

访问函数:

bool **hasSelection() ** const

另请参见 selectionChanged()。

属性名类型
iconconst QIcon

此属性保存当前可视页面关联的图标。

默认,这个属性包含一个空图标。

访问函数:

QIcon icon() const

通知信号:

void iconChanged(const QIcon &icon)

另请参见iconChanged(), iconUrl(), 和 iconUrlChanged()。

属性名类型
iconUrlconst QUrl

此属性保存当前可视页面关联图标的URL。

默认,这个属性包含一个空URL。

该特性在 Qt 5.7 引入。

访问函数:

QIcon iconUrl() const

通知信号:

void iconUrlChanged(const QUrl &url)

另请参见iconUrlChanged(), icon(), 和 iconChanged()。

属性名类型
selectedTextconst QString

此属性保存了当前选中的文本。

默认,此属性包含一个空字符串。

访问函数:

QString selectionText() const

另请参见findText() 和 selectionChanged()。

属性名类型
titleconst QString

此属性保存了定义为HTML元素页面的标题。</p> <p><strong>访问函数:</strong></p> <p>QString <strong>title</strong>() const</p> <p>另请参见<a href="qwebengineview.html#titleChanged">titleChanged</a>().</p> <table><thead><tr><th>属性名</th><th>类型</th></tr></thead><tbody> <tr><td>url</td><td><a href="../qtcore/qurl.html">QUrl</a></td></tr> </tbody></table> <p>此属性保存了当前可视web页面的URL。</p> <p>设置这个属性会清空此view和加载URL。</p> <p>默认,这个属性包含一个空的,无效的URL。</p> <p><strong>访问函数:</strong></p> <p>QUrl <strong>url</strong>() const</p> <p>void <strong>setUrl</strong>(const QUrl &url)</p> <p>另请参见<a href="qwebengineview.html#load">load</a>() 和 <a href="qwebengineview.html#urlChanged">urlChanged</a>().</p> <table><thead><tr><th>属性名</th><th>类型</th></tr></thead><tbody> <tr><td>zoomFactor</td><td>qreal</td></tr> </tbody></table> <p>此属性保存了该view的缩放因子。</p> <p>有效数值的范围从 0.25 到 5.0。默认因子是1.0。</p> <p><strong>访问函数:</strong></p> <p>qreal <a href="">zoomFactor</a>() const void <a href="">setZoomFactor</a>(qreal factor)</p> <h2><a class="header" href="#成员函数文档" id="成员函数文档">成员函数文档</a></h2> <h3><a class="header" href="#qwebengineviewqwebengineviewa-hrefwqwidgethtmlqwidgeta-parent--q_nullptr" id="qwebengineviewqwebengineviewa-hrefwqwidgethtmlqwidgeta-parent--q_nullptr">QWebEngineView::<strong>QWebEngineView</strong>(<a href="../../W/QWidget.html">QWidget</a> *<em>parent</em> = Q_NULLPTR)</a></h3> <p>与父类parent构造一个空的网页视图。</p> <p>另请参见<a href="qwebengineview.html#load">load</a>()。</p> <h3><a class="header" href="#virtual-qwebengineviewqwebengineview" id="virtual-qwebengineviewqwebengineview">[virtual] QWebEngineView::~QWebEngineView()</a></h3> <p>销毁网页视图。</p> <h3><a class="header" href="#slot-void-qwebengineviewback" id="slot-void-qwebengineviewback">[slot] void QWebEngineView::back()</a></h3> <p>方便的槽函数,加载构建到导航链接的文档列表里的前一个文档。如果没有前一个文档,就不执行任何操作。</p> <p>它等价于</p> <pre><code> view->page()->triggerAction(QWebEnginePage::Back); </code></pre> <p>另请参见<a href="qwebengineview.html#forward">forward</a>() 和 <a href="qwebengineview.html#pageAction">pageAction</a>()。</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewcontextmenueventa-hrefcqcontextmenueventhtmlqcontextmenueventa-event" id="override-virtual-protected-void-qwebengineviewcontextmenueventa-hrefcqcontextmenueventhtmlqcontextmenueventa-event">[override virtual protected] void QWebEngineView::contextMenuEvent(<a href="../../C/QContextMenuEvent.html">QContextMenuEvent</a> *<em>event</em>)</a></h3> <p>重实现 <a href="../qtwidgets/qwidget.html#contextMenuEvent">QWidget::contextMenuEvent</a>()。</p> <h3><a class="header" href="#virtual-protected-a-hrefqwebengineviewhtmlqwebengineviewqwebengineviewa-qwebengineviewcreatewindowa-hrefqwebenginepagehtmlwebwindowtype-enumqwebenginepagewebwindowtypea-type" id="virtual-protected-a-hrefqwebengineviewhtmlqwebengineviewqwebengineviewa-qwebengineviewcreatewindowa-hrefqwebenginepagehtmlwebwindowtype-enumqwebenginepagewebwindowtypea-type">[virtual protected] <a href="qwebengineview.html#QWebEngineView">QWebEngineView</a> *QWebEngineView::createWindow(<a href="qwebenginepage.html#WebWindowType-enum">QWebEnginePage::WebWindowType</a> <em>type</em>)</a></h3> <p>每当页面想要创建给定类型的新窗口时,都会从关联的QWebEnginePage的createWindow()方法中调用此函数。 例如,当发出JavaScript请求以在新窗口中打开文档时。 <strong>注意:</strong> 如果重新实现了关联页面的createWindow()方法,则不会调用此方法,除非在重新实现中明确地这样做。</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewdragentereventa-hrefdqdragentereventhtmlqdragentereventa-e" id="override-virtual-protected-void-qwebengineviewdragentereventa-hrefdqdragentereventhtmlqdragentereventa-e">[override virtual protected] void QWebEngineView::dragEnterEvent(<a href="../../D/QDragEnterEvent.html">QDragEnterEvent</a> *<em>e</em>)</a></h3> <p>重实现<a href="../qtwidgets/qwidget.html#dragEnterEvent">QWidget::dragEnterEvent</a>()。</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewdragleaveeventa-hrefdqdragleaveeventhtmlqdragleaveeventa-e" id="override-virtual-protected-void-qwebengineviewdragleaveeventa-hrefdqdragleaveeventhtmlqdragleaveeventa-e">[override virtual protected] void QWebEngineView::dragLeaveEvent(<a href="../../D/QDragLeaveEvent.html">QDragLeaveEvent</a> *<em>e</em>)</a></h3> <p>重实现<a href="../qtwidgets/qwidget.html#dragLeaveEvent">QWidget::dragLeaveEvent</a>().</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewdragmoveeventa-hrefdqdragmoveeventhtmlqdragmoveeventa-e" id="override-virtual-protected-void-qwebengineviewdragmoveeventa-hrefdqdragmoveeventhtmlqdragmoveeventa-e">[override virtual protected] void QWebEngineView::dragMoveEvent(<a href="../../D/QDragMoveEvent.html">QDragMoveEvent</a> *<em>e</em>)</a></h3> <p>重实现<a href="../qtwidgets/qwidget.html#dragMoveEvent">QWidget::dragMoveEvent</a>()。</p> <p>### [override virtual protected] void QWebEngineView::dropEvent(<a href="../../D/QDropEvent.html">QDropEvent</a> *<em>e</em>)</p> <p>重实现<a href="../qtwidgets/qwidget.html#dropEvent">QWidget::dropEvent</a>()。</p> <p>### [override virtual protected] bool QWebEngineView::event(<a href="../../E/QEvent.html">QEvent</a> *<em>ev</em>)</p> <p>重实现<a href="../qtwidgets/qwidget.html#event">QWidget::event</a>().</p> <h3><a class="header" href="#void-qwebengineviewfindtextconst-a-hrefsqstringhtmlqstringa-substring-a-hrefqwebenginepagehtmlfindflag-enumqwebenginepagefindflagsa-options---const-qwebenginecallbackbool-resultcallback--" id="void-qwebengineviewfindtextconst-a-hrefsqstringhtmlqstringa-substring-a-hrefqwebenginepagehtmlfindflag-enumqwebenginepagefindflagsa-options---const-qwebenginecallbackbool-resultcallback--">void QWebEngineView::findText(const <a href="../../S/QString.html">QString</a> &<em>subString</em>, <a href="qwebenginepage.html#FindFlag-enum">QWebEnginePage::FindFlags</a> <em>options</em> = ..., const QWebEngineCallback<bool> &<em>resultCallback</em> = ...)</a></h3> <p>在页面里找到特殊的字符串,子字符串,通过使用<em>options</em>。</p> <p>去清空选中部分,只需要传递一个空的字符串。</p> <p><em>resultCallback</em>必须带boolean参数, 它将返回true或false, 表明是否找到子字符串。</p> <p><strong>注意:</strong> 我们保证回调函数总是可以被调用,但可能需要在页面构造完成之后。当<a href="../../W/QWebEnginePage.html">QWebEnginePage</a> 被删除时,该回调触发带着一个无效的值且作为 <a href="../../W/QWebEnginePage.html">QWebEnginePage</a> or <a href="qwebengineview.html">QWebEngineView</a>实例里使用是不安全的。</p> <h3><a class="header" href="#slot-void-qwebengineviewforward" id="slot-void-qwebengineviewforward">[slot] void QWebEngineView::forward()</a></h3> <p>方便的槽函数,加载构建到导航链接的文档列表里的前一个文档。如果没有前一个文档,就不执行任何操作。</p> <p>它等价于</p> <pre><code> view->page()->triggerAction(QWebEnginePage::Forward); </code></pre> <p>另请参见 <a href="qwebengineview.html#back">back</a>() 和 <a href="qwebengineview.html#pageAction">pageAction</a>()。</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewhideeventa-hrefhqhideeventhtmlqhideeventa-event" id="override-virtual-protected-void-qwebengineviewhideeventa-hrefhqhideeventhtmlqhideeventa-event">[override virtual protected] void QWebEngineView::hideEvent(<a href="../../H/QHideEvent.html">QHideEvent</a> *<em>event</em>)</a></h3> <p>重实现<a href="../qtwidgets/qwidget.html#hideEvent">QWidget::hideEvent</a>().</p> <h3><a class="header" href="#a-hrefwqwebenginehistoryhtmlqwebenginehistorya-qwebengineviewhistory-const" id="a-hrefwqwebenginehistoryhtmlqwebenginehistorya-qwebengineviewhistory-const"><a href="../../W/QWebEngineHistory.html">QWebEngineHistory</a> *QWebEngineView::history() const</a></h3> <p>返回指向web导航页面视图历史的指针。</p> <p>它等价于:</p> <pre><code> view->page()->history(); </code></pre> <h3><a class="header" href="#signal-void-qwebengineviewiconchangedconst-a-hrefiqiconhtmlqicona-icon" id="signal-void-qwebengineviewiconchangedconst-a-hrefiqiconhtmlqicona-icon">[signal] void QWebEngineView::iconChanged(const <a href="../../I/QIcon.html">QIcon</a> &<em>icon</em>)</a></h3> <p>当与视图关联的图标(“favicon”)更改时,将发出此信号。 新图标由图标指定。 此功能在Qt 5.7中引入。 注意:属性图标的通知程序信号。 另请参见 <a href="qwebengineview.html#icon-prop">icon</a>(), <a href="qwebengineview.html#iconUrl-prop">iconUrl</a>(), 和 <a href="qwebengineview.html#iconUrlChanged">iconUrlChanged</a>()。</p> <h3><a class="header" href="#signal-void-qwebengineviewiconurlchangedconst-a-hrefuqurlhtmlqurla-url" id="signal-void-qwebengineviewiconurlchangedconst-a-hrefuqurlhtmlqurla-url">[signal] void QWebEngineView::iconUrlChanged(const <a href="../../U/QUrl.html">QUrl</a> &<em>url</em>)</a></h3> <p>当与视图关联的图标(“图标”)的URL更改时,将发出此信号。 新URL由url指定。 注意:属性iconUrl的通知程序信号。 另请参见<a href="qwebengineview.html#icon-prop">icon</a>(), <a href="qwebengineview.html#iconUrl-prop">iconUrl</a>(), 和 <a href="qwebengineview.html#iconUrlChanged">iconUrlChanged</a>()。</p> <h3><a class="header" href="#void-qwebengineviewloadconst-a-hrefuqurlhtmlqurla-url" id="void-qwebengineviewloadconst-a-hrefuqurlhtmlqurla-url">void QWebEngineView::load(const <a href="../../U/QUrl.html">QUrl</a> &<em>url</em>)</a></h3> <p>加载指定的url和显示它。</p> <p><strong>注意:</strong> 该视图保持相同的内容直到足够多的数据去展示新的URL。</p> <p>另请参见 load(), <a href="qwebengineview.html#url-prop">setUrl</a>(), <a href="qwebengineview.html#url-prop">url</a>(), <a href="qwebengineview.html#urlChanged">urlChanged</a>(), 和 <a href="../qtcore/qurl.html#fromUserInput">QUrl::fromUserInput</a>().</p> <h3><a class="header" href="#void-qwebengineviewloadconst-a-hrefwqwebenginehttprequesthtmlqwebenginehttprequesta-request" id="void-qwebengineviewloadconst-a-hrefwqwebenginehttprequesthtmlqwebenginehttprequesta-request">void QWebEngineView::load(const <a href="../../W/QWebEngineHttpRequest.html">QWebEngineHttpRequest</a> &<em>request</em>)</a></h3> <p>发出指定的请求并加载响应。 Qt 5.9中引入了此功能。 另请参见<a href="qwebengineview.html#load">load</a>(), <a href="qwebengineview.html#url-prop">setUrl</a>(), <a href="qwebengineview.html#url-prop">url</a>(), <a href="qwebengineview.html#urlChanged">urlChanged</a>(), and <a href="../qtcore/qurl.html#fromUserInput">QUrl::fromUserInput</a>().</p> <h3><a class="header" href="#signal-void-qwebengineviewloadfinishedbool-ok" id="signal-void-qwebengineviewloadfinishedbool-ok">[signal] void QWebEngineView::loadFinished(bool <em>ok</em>)</a></h3> <p>当加载该页面已经完成的时候,发出该信号。<em>ok</em> 表明加载是成功还是失败。</p> <h3><a class="header" href="#signal-void-qwebengineviewloadprogressint-progress" id="signal-void-qwebengineviewloadprogressint-progress">[signal] void QWebEngineView::loadProgress(int <em>progress</em>)</a></h3> <p>每当Web视图中的某个元素完成加载(例如嵌入式图像或脚本)时,都会发出此信号。 因此,它跟踪加载Web视图的总体进度。</p> <p>当前值由progress提供,范围为0到100,这是<a href="../qtwidgets/qprogressbar.html">QProgressBar</a>的默认范围。</p> <p>另请参见 <a href="qwebengineview.html#loadStarted">loadStarted</a>() 和 <a href="qwebengineview.html#loadFinished">loadFinished</a>().</p> <h3><a class="header" href="#signal-void-qwebengineviewloadstarted" id="signal-void-qwebengineviewloadstarted">[signal] void QWebEngineView::loadStarted()</a></h3> <p>当新的页面开始被加载的时候,发出该信号。</p> <h3><a class="header" href="#webenginepage-qwebengineviewpage-const" id="webenginepage-qwebengineviewpage-const">WebEnginePage *QWebEngineView::page() const</a></h3> <p>返回指向下划线web网页的指针。</p> <h3><a class="header" href="#a-hrefaqactionhtmlqactionaqwebengineviewpageactionqwebenginepagewebaction-action-const" id="a-hrefaqactionhtmlqactionaqwebengineviewpageactionqwebenginepagewebaction-action-const"><a href="../../A/QAction.html">QAction</a>*QWebEngineView::pageAction(QWebEnginePage::WebAction <em>action</em>) const</a></h3> <p>返回一个指向<a href="../qtwidgets/qaction.html">QAction</a>的指针,封装了特定网页的动作。</p> <h3><a class="header" href="#slot-void-qwebengineviewreload" id="slot-void-qwebengineviewreload">[slot] void QWebEngineView::reload()</a></h3> <p>重新加载当前的文档。</p> <h3><a class="header" href="#signal-void-qwebengineviewrenderprocessterminateda-hrefqwebenginepagehtmlrenderprocessterminationstatus-enumqwebenginepagerenderprocessterminationstatusa-terminationstatus-int-exitcode" id="signal-void-qwebengineviewrenderprocessterminateda-hrefqwebenginepagehtmlrenderprocessterminationstatus-enumqwebenginepagerenderprocessterminationstatusa-terminationstatus-int-exitcode">[signal] void QWebEngineView::renderProcessTerminated(<a href="qwebenginepage.html#RenderProcessTerminationStatus-enum">QWebEnginePage::RenderProcessTerminationStatus</a> <em>terminationStatus</em>, int <em>exitCode</em>)</a></h3> <p>当渲染进程返回非零且中断的时候,发出该信号。</p> <p>当进程中断时,<em>terminationStatus</em>指进程的中断状态,<em>exitCode</em>指进程的状态码。</p> <p>该函数在 Qt 5.6 引入。</p> <h3><a class="header" href="#signal-void-qwebengineviewselectionchanged" id="signal-void-qwebengineviewselectionchanged">[signal] void QWebEngineView::selectionChanged()</a></h3> <p>当选择的部分改变的时候,发出该信号。</p> <p><strong>注意:</strong> 当使用鼠标左键单击并拖动来选择文本时,将为每个选定的新字符发出信号,而不是在释放鼠标左键时发出信号。</p> <p>另请参见 <a href="qwebengineview.html#selectedText-prop">selectedText</a>().</p> <h3><a class="header" href="#void-qwebengineviewsetcontentconst-a-hrefqtcoreqbytearrayhtmlqbytearraya-data-const-a-hrefqtcoreqstringhtmlqstringa-mimetype--qstring-const-a-hrefqtcorequrlhtmlqurla-baseurl--qurl" id="void-qwebengineviewsetcontentconst-a-hrefqtcoreqbytearrayhtmlqbytearraya-data-const-a-hrefqtcoreqstringhtmlqstringa-mimetype--qstring-const-a-hrefqtcorequrlhtmlqurla-baseurl--qurl">void QWebEngineView::setContent(const <a href="../qtcore/qbytearray.html">QByteArray</a> &<em>data</em>, const <a href="../qtcore/qstring.html">QString</a> &<em>mimeType</em> = QString(), const <a href="../qtcore/qurl.html">QUrl</a> &<em>baseUrl</em> = QUrl())</a></h3> <p>设置网页视图内容到数据里。如果<em>mimeType</em>是空参数,将假定该内容是text/plain,charset=US-ASCII。外部对象在内容里引用的路径是相对于<em>baseUrl</em>。</p> <p>该数据会被立刻加载。外部对象会被异步加载。</p> <p>另请参见 <a href="qwebengineview.html#load">load</a>(), <a href="qwebengineview.html#setHtml">setHtml</a>(), 和 <a href="qwebenginepage.html#toHtml">QWebEnginePage::toHtml</a>().</p> <h3><a class="header" href="#void-qwebengineviewsethtmlconst-a-hrefsqstringhtmlqstringa-html-const-a-hrefuqurlhtmlqurla-baseurl--qurl" id="void-qwebengineviewsethtmlconst-a-hrefsqstringhtmlqstringa-html-const-a-hrefuqurlhtmlqurla-baseurl--qurl">void QWebEngineView::setHtml(const <a href="../../S/QString.html">QString</a> &<em>html</em>, const <a href="../../U/QUrl.html">QUrl</a> &<em>baseUrl</em> = QUrl())</a></h3> <p>将Web视图的内容设置为指定的html内容。</p> <p>外部对象(例如HTML文档中引用的样式表或图像)相对于baseUrl定位。 HTML文档将立即加载,而外部对象则异步加载。</p> <p>使用此方法时,除非另有说明,否则Qt WebEngine假定外部资源(例如JavaScript程序或样式表)均以UTF-8编码。 例如,可以通过HTML脚本标签的charset属性指定外部脚本的编码。 或者,可以由Web服务器指定编码。 这是一个等效于setContent(html,“ text / html; charset = UTF-8”,baseUrl)的便利函数。</p> <h3><a class="header" href="#void-qwebengineviewsetpagea-hrefwqwebenginepagehtmlqwebenginepagea-page" id="void-qwebengineviewsetpagea-hrefwqwebenginepagehtmlqwebenginepagea-page">void QWebEngineView::setPage(<a href="../../W/QWebEnginePage.html">QWebEnginePage</a> *<em>page</em>)</a></h3> <p>确保设置page页面到页面视图中。</p> <p>该父类<a href="../qtcore/qobject.html">QObject</a>提供页面维护网页视图对象。如果当前页面是该网页视图的子类,它将会被删除。</p> <p>**警告:**此功能仅适用于HTML。 对于其他MIME类型(例如XHTML或SVG),应改用setContent()。</p> <p><strong>注意:</strong> 无法显示大于2 MB的内容,因为setHtml()会将提供的HTML转换为百分比编码并将数据:放在其前面以创建要导航到的URL。 从而,提供的代码将成为超出Chromium设置的2 MB限制的URL。 如果内容太大,则使用success = false触发loadFinished()信号。</p> <p>另请参见 <a href="qwebengineview.html#load">load</a>(), <a href="qwebengineview.html#setContent">setContent</a>(), <a href="qwebenginepage.html#toHtml">QWebEnginePage::toHtml</a>(), 和 <a href="qwebenginepage.html#setContent">QWebEnginePage::setContent</a>().</p> <h3><a class="header" href="#a-hrefwqwebenginesettingshtmlqwebenginesettingsa-qwebengineviewsettings-const" id="a-hrefwqwebenginesettingshtmlqwebenginesettingsa-qwebengineviewsettings-const"><a href="../../W/QWebEngineSettings.html">QWebEngineSettings</a> *QWebEngineView::settings() const</a></h3> <p>返回一个指向该视图或页面特殊设置对象的指针。</p> <p>它等价于:</p> <pre><code> view->page()->settings(); </code></pre> <p>另请参见 <a href="qwebenginesettings-obsolete.html#globalSettings">QWebEngineSettings::globalSettings</a>().</p> <h3><a class="header" href="#override-virtual-protected-void-qwebengineviewshoweventa-hrefsqshoweventhtmlqshoweventa-event" id="override-virtual-protected-void-qwebengineviewshoweventa-hrefsqshoweventhtmlqshoweventa-event">[override virtual protected] void QWebEngineView::showEvent(<a href="../../S/QShowEvent.html">QShowEvent</a> *<em>event</em>)</a></h3> <p>重实现 <a href="../qtwidgets/qwidget.html#showEvent">QWidget::showEvent</a>().</p> <h3><a class="header" href="#override-virtual-a-hrefsqsizehtmlqsizea-qwebengineviewsizehint-const" id="override-virtual-a-hrefsqsizehtmlqsizea-qwebengineviewsizehint-const">[override virtual] <a href="../../S/QSize.html">QSize</a> QWebEngineView::sizeHint() const</a></h3> <p>重实现 <a href="../qtwidgets/qwidget.html#sizeHint-prop">QWidget::sizeHint</a>().</p> <h3><a class="header" href="#slot-void-qwebengineviewstop" id="slot-void-qwebengineviewstop">[slot] void QWebEngineView::stop()</a></h3> <p>方便的槽函数,停止加载该文档。</p> <p>它等价于:</p> <pre><code> view->page()->triggerAction(QWebEnginePage::Stop); </code></pre> <p>另请参见 <a href="qwebengineview.html#reload">reload</a>(), <a href="qwebengineview.html#pageAction">pageAction</a>(), 和 <a href="qwebengineview.html#loadFinished">loadFinished</a>().</p> <h3><a class="header" href="#signal-void-qwebengineviewtitlechangedconst-a-hrefsqstringhtmlqstringa-title" id="signal-void-qwebengineviewtitlechangedconst-a-hrefsqstringhtmlqstringa-title">[signal] void QWebEngineView::titleChanged(const <a href="../../S/QString.html">QString</a> &<em>title</em>)</a></h3> <p>当该视图的标题改变时,发出该信号。</p> <p>另请参见 <a href="qwebengineview.html#title-prop">title</a>().</p> <h3><a class="header" href="#void-qwebengineviewtriggerpageactiona-hrefqwebenginepagehtmlwebaction-enumqwebenginepagewebactiona-action-bool-checked--false" id="void-qwebengineviewtriggerpageactiona-hrefqwebenginepagehtmlwebaction-enumqwebenginepagewebactiona-action-bool-checked--false">void QWebEngineView::triggerPageAction(<a href="qwebenginepage.html#WebAction-enum">QWebEnginePage::WebAction</a> <em>action</em>, bool <em>checked</em> = false)</a></h3> <p>触发特定的动作。如果它是可以选中的动作,这个特殊的选中状态被设定。</p> <p>接下来的例子触发了复制动作,因此会拷贝任何选中的文本到剪贴板上。</p> <pre><code> view->triggerPageAction(QWebEnginePage::Copy); </code></pre> <p>另请参见 <a href="qwebengineview.html#pageAction">pageAction</a>().</p> <h3><a class="header" href="#signal-void-qwebengineviewurlchangedconst-a-hrefuqurlhtmlqurla-url" id="signal-void-qwebengineviewurlchangedconst-a-hrefuqurlhtmlqurla-url">[signal] void QWebEngineView::urlChanged(const <a href="../../U/QUrl.html">QUrl</a> &<em>url</em>)</a></h3> <p>当该视图的<em>url</em>改变时,发出该信号。</p> <p>另请参见 <a href="qwebengineview.html#url-prop">url</a>() 和 <a href="qwebengineview.html#load">load</a>().</p> </main> <nav class="nav-wrapper" aria-label="Page navigation"> <!-- Mobile navigation buttons --> <a rel="prev" href="../../../Src/W/QWebEngineHistoryItem/QWebEngineHistoryItem.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> <i class="fa fa-angle-left"></i> </a> <a rel="next" href="../../../Src/W/QWriteLocker/QWriteLocker.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <i class="fa fa-angle-right"></i> </a> <div style="clear: both"></div> </nav> </div> </div> <nav class="nav-wide-wrapper" aria-label="Page navigation"> <a rel="prev" href="../../../Src/W/QWebEngineHistoryItem/QWebEngineHistoryItem.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> <i class="fa fa-angle-left"></i> </a> <a rel="next" href="../../../Src/W/QWriteLocker/QWriteLocker.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <i class="fa fa-angle-right"></i> </a> </nav> </div> <script type="text/javascript"> window.playground_copyable = true; </script> <script src="../../../elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="../../../mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="../../../searcher.js" type="text/javascript" charset="utf-8"></script> <script src="../../../clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="../../../highlight.js" type="text/javascript" charset="utf-8"></script> <script src="../../../book.js" type="text/javascript" charset="utf-8"></script> <!-- Custom JS scripts --> </body> </html>