就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. PySide 2 for Qt 5.15.0
  3. 文档编制
  4. Qt 模块
  5. PySide2.QtWebEngineWidgets

内容表

上一话题

QWebEngineSettings

下一话题

PySide2.QtWebSockets

QWebEngineView

QWebEngineView class provides a widget that is used to view and edit web documents. 更多 …

Inheritance diagram of PySide2.QtWebEngineWidgets.QWebEngineView

概要

函数

虚函数

槽

信号

详细描述

A Web 视图 是 Qt WebEngine Web 浏览模块的主要 Widget 组件。可以把它用于各种应用程序以实时显示来自 Internet 的 Web 内容。

A 网站 可以被加载到 Web 视图采用 load() function. The GET method is always used to load URLs.

像所有 Qt Widget， show() function must be invoked in order to display the web view. The snippet below illustrates this: 

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

另外， setUrl() can be used to load a web site. If you have the HTML content readily available, you can use setHtml() 代替。

loadStarted() signal is emitted when the view begins loading and the loadProgress() signal is emitted whenever an element of the web view completes loading, such as an embedded image or a script. The loadFinished() signal is emitted when the view has been loaded completely. Its argument, either true or false ，指示加载是成功或失败。

page() function returns a pointer to a web page object. A QWebEngineView contains a QWebEnginePage ，进而允许访问 QWebEngineHistory in the page’s context.

可以访问 HTML 文档的标题采用 title() property. Additionally, a web site may specify an icon, which can be accessed using the icon() or its URL using the iconUrl() property. If the title or the icon changes, the corresponding titleChanged() , iconChanged() and iconUrlChanged() signals will be emitted. The zoomFactor() property enables zooming the contents of the web page by a scale factor.

Widget 提供订制手边元素，并包括有用浏览器动作的上下文菜单。对于自定义上下文菜单，或把动作嵌入菜单或工具栏，单个动作是可用的通过 pageAction() . The web view maintains the state of the returned actions, but allows modification of action properties such as text or icon 。动作语义也可以被直接触发，透过 triggerPageAction() .

If you want to provide support for web sites that allow the user to open new windows, such as pop-up windows, you can subclass QWebEngineView and reimplement the createWindow() 函数。

另请参阅

WebEngine Widgets 简单浏览器范例 WebEngine 内容操纵范例 WebEngine Markdown 编辑器范例

class QWebEngineView ( [ parent=Q_NULLPTR ] )
param parent

QWidget

构造空 Web 视图采用父级 parent .

另请参阅

load()

PySide2.QtWebEngineWidgets.QWebEngineView. back ( )

方便槽，用于把先前文档加载进由导航链接构建的文档列表。什么都不做，若没有先前文档。

相当于： 

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

另请参阅

forward() pageAction()

PySide2.QtWebEngineWidgets.QWebEngineView. createWindow ( type )
参数

type – WebWindowType

返回类型

QWebEngineView

此函数被调用从 createWindow() 方法的关联 QWebEnginePage 每次页面希望创建新窗口源于给定 type 。例如，当 JavaScript 请求在新窗口中打开文档被发出时。

注意

若 createWindow() 方法的关联页面被重实现，此方法不被调用，除非在重实现中明确这样做。

另请参阅

createWindow()

PySide2.QtWebEngineWidgets.QWebEngineView. findText ( arg__1 , arg__2 , arg__3 )
参数

  • arg__1 – unicode

  • arg__2 – FindFlags

  • arg__3 – PyObject

PySide2.QtWebEngineWidgets.QWebEngineView. findText ( subString [ , options=QWebEnginePage.FindFlags() ] )
参数

  • subString – unicode

  • options – FindFlags

PySide2.QtWebEngineWidgets.QWebEngineView. forward ( )

方便槽，用于把下一文档加载进由导航链接构建的文档列表。什么都不做，若没有下一文档。

相当于： 

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

另请参阅

back() pageAction()

PySide2.QtWebEngineWidgets.QWebEngineView. hasSelection ( )
返回类型

bool

PySide2.QtWebEngineWidgets.QWebEngineView. history ( )
返回类型

QWebEngineHistory

Returns a pointer to the view’s history of navigated web pages.

相当于： 

view->page()->history();
PySide2.QtWebEngineWidgets.QWebEngineView. icon ( )
返回类型

QIcon

PySide2.QtWebEngineWidgets.QWebEngineView. iconChanged ( arg__1 )
参数

arg__1 – QIcon

PySide2.QtWebEngineWidgets.QWebEngineView. iconUrl ( )
返回类型

QUrl

PySide2.QtWebEngineWidgets.QWebEngineView. iconUrlChanged ( arg__1 )
参数

arg__1 – QUrl

PySide2.QtWebEngineWidgets.QWebEngineView. load ( url )
参数

url – QUrl

PySide2.QtWebEngineWidgets.QWebEngineView. load ( request )
参数

request – QWebEngineHttpRequest

PySide2.QtWebEngineWidgets.QWebEngineView. loadFinished ( arg__1 )
参数

arg__1 – bool

PySide2.QtWebEngineWidgets.QWebEngineView. loadProgress ( progress )
参数

progress – int

PySide2.QtWebEngineWidgets.QWebEngineView. loadStarted ( )
PySide2.QtWebEngineWidgets.QWebEngineView. page ( )
返回类型

QWebEnginePage

返回指向底层 Web 页面的指针。

另请参阅

setPage()

PySide2.QtWebEngineWidgets.QWebEngineView. pageAction ( action )
参数

action – WebAction

返回类型

QAction

返回指针指向 QAction 封装指定的 Web 动作 action .

PySide2.QtWebEngineWidgets.QWebEngineView. reload ( )

重新加载当前文档。

另请参阅

stop() pageAction() loadStarted()

PySide2.QtWebEngineWidgets.QWebEngineView. renderProcessTerminated ( terminationStatus , exitCode )
参数

  • terminationStatus – RenderProcessTerminationStatus

  • exitCode – int

PySide2.QtWebEngineWidgets.QWebEngineView. selectedText ( )
返回类型

unicode

PySide2.QtWebEngineWidgets.QWebEngineView. selectionChanged ( )
PySide2.QtWebEngineWidgets.QWebEngineView. setContent ( data [ , mimeType="" [ , baseUrl=QUrl() ] ] )
参数

  • data – QByteArray

  • mimeType – unicode

  • baseUrl – QUrl

把 Web 视图内容设为 data 。若 mimeType 自变量为空，假定内容为 text/plain,charset=US-ASCII .

内容中引用的外部对象的定位相对于 baseUrl 。对于要加载外部对象， baseUrl 不可以为空。

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

另请参阅

load() setHtml() toHtml()

PySide2.QtWebEngineWidgets.QWebEngineView. setHtml ( html [ , baseUrl=QUrl() ] )
参数

  • html – unicode

  • baseUrl – QUrl

将 Web 视图内容设为指定 html 内容。

外部对象 (譬如：HTML 文档引用的样式表或图像) 的定位相对于 baseUrl 。对于要加载外部对象， baseUrl 不可以为空。例如，若 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 编码的，除非另有指定。例如，可以指定外部脚本的编码透过 charset 属性在 HTML 脚本标签。另外，可以通过 Web 服务器指定编码。

此方便函数相当于 setContent(html, "text/html;charset=UTF-8", baseUrl) .

警告

此函数只适用于 HTML。对于其它 MIME 类型 (譬如 XHTML 或 SVG)， setContent() should be used instead.

注意

Content larger than 2 MB cannot be displayed, because converts the provided HTML to percent-encoding and places data ：在它之前创建导航 URL。由此，提供的代码变为超过 Chromium 设置的 2 MB 限制的 URL。若内容太大， loadFinished() signal is triggered with success=false .

另请参阅

load() setContent() toHtml() setContent()

PySide2.QtWebEngineWidgets.QWebEngineView. setPage ( page )
参数

page – QWebEnginePage

Makes page 成为 Web 视图的新网页。

父级 QObject 为提供页面仍然是对象所有者。若当前页面是 Web 视图子页面，则删除它。

另请参阅

page()

PySide2.QtWebEngineWidgets.QWebEngineView. setUrl ( url )
参数

url – QUrl

另请参阅

url()

PySide2.QtWebEngineWidgets.QWebEngineView. setZoomFactor ( factor )
参数

factor – qreal

另请参阅

zoomFactor()

PySide2.QtWebEngineWidgets.QWebEngineView. settings ( )
返回类型

QWebEngineSettings

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

相当于： 

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

另请参阅

defaultSettings()

PySide2.QtWebEngineWidgets.QWebEngineView. stop ( )

停止加载文档的方便槽。

相当于： 

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

另请参阅

reload() pageAction() loadFinished()

PySide2.QtWebEngineWidgets.QWebEngineView. title ( )
返回类型

unicode

PySide2.QtWebEngineWidgets.QWebEngineView. titleChanged ( title )
参数

title – unicode

PySide2.QtWebEngineWidgets.QWebEngineView. triggerPageAction ( action [ , checked=false ] )
参数

  • action – WebAction

  • checked – bool

触发指定 action 。若是可复选动作，指定 checked 假定状态。

以下范例触发拷贝动作，因此把任何选中文本拷贝到剪贴板。 

view->triggerPageAction(QWebEnginePage::Copy);

另请参阅

pageAction()

PySide2.QtWebEngineWidgets.QWebEngineView. url ( )
返回类型

QUrl

另请参阅

setUrl()

PySide2.QtWebEngineWidgets.QWebEngineView. urlChanged ( arg__1 )
参数

arg__1 – QUrl

PySide2.QtWebEngineWidgets.QWebEngineView. zoomFactor ( )
返回类型

qreal

另请参阅

setZoomFactor()