QWebEngineView类提供了一个widget, 被使用去查看和编辑web元素。
属性 | 方法 |
---|---|
头文件 | #include |
qmake参数 | QT += webenginewidgets |
继承 | QWidget |
属性名 | 类型 |
---|---|
hasSelection | const bool |
title | const QString |
icon | const QIcon |
zoomFactor | qreal |
selectedText | const QString |
类型 | 函数名 |
---|---|
QWebEngineView(QWidget *parent = Q_NULLPTR)] | |
virtual | ~QWebEngineView() |
void | findText(const QString &subString, QWebEnginePage::FindFlags options = …, const QWebEngineCallback &resultCallback = …)] |
bool | hasSelection() const |
QWebEngineHostory * | history() const |
QIcon | icon() const |
QUrl | iconUrl() const |
void | load(const QUrl &url) |
void | load(const QWebEngineHttpRequest &request) |
QWebEnginePage * | page() const |
QAction * | pageAction(QWebEnginePage::WebAction action) const |
QString | selectedText() const |
void | setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl()) |
void | setHtml(const QString &html, const QUrl &baseUrl = QUrl()) |
void | setPage(QWebEnginePage *page) |
void | setUrl(const QUrl &url) |
void | setZoomFactor(qreal factor) |
QWebEngineSettings * | settings() const |
QString | title() const |
void | triggerPageAction(QWebEnginePage::WebAction action, bool checked = false) |
QUrl | url() const |
qreal | zoomFactor() const |
virtual QSize sizeHint() const override
类型 | 函数名 |
---|---|
void | back() |
void | forward() |
void | reload() |
void | stop() |
类型 | 函数名 |
---|---|
void | iconChanged(const QIcon &icon) |
void | iconUrlChanged(const QUrl &url) |
void | iconUrlChanged(const QUrl &url) |
void | loadProgress(int progress) |
void | loadStarted() |
void | renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode) |
void | selectionChanged() |
void | titleChanged(const QString &title) |
void | urlChanged(const QUrl &url) |
virtual QWebEngineView *
createWindow(QWebEnginePage::WebWindowType type)
类型 | 函数名 |
---|---|
vitrual void | contextMenuEvent(QContextMenuEvent *event) override |
virtual void | dragEnterEvent(QDragEnterEvent *e) override |
virtual void | dragLeaveEvent(QDragLeaveEvent *e) override |
virtual void | dragMoveEvent(QDragMoveEvent *e) override |
virtual void | dropEvent(QDropEvent *e) override |
virtual bool | event(QEvent *ev) override |
virtual void | hideEvent(QHideEvent *event) override |
virtual void | showEvent(QShowEvent *event) override |
35 个保护成员函数继承自 QWidget
9 个保护成员函数继承自 QObject
1 个保护成员函数继承自 QPaintDevice
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的文档中找到相关的信息。
属性名 | 类型 |
---|---|
hasSelection | const bool |
此属性保存此页面是否包含所选内容。
默认情况下,此属性为false。
访问函数:
bool **hasSelection() ** const
另请参见 selectionChanged()。
属性名 | 类型 |
---|---|
icon | const QIcon |
此属性保存当前可视页面关联的图标。
默认,这个属性包含一个空图标。
访问函数:
QIcon icon() const
通知信号:
void iconChanged(const QIcon &icon)
另请参见iconChanged(), iconUrl(), 和 iconUrlChanged()。
属性名 | 类型 |
---|---|
iconUrl | const QUrl |
此属性保存当前可视页面关联图标的URL。
默认,这个属性包含一个空URL。
该特性在 Qt 5.7 引入。
访问函数:
QIcon iconUrl() const
通知信号:
void iconUrlChanged(const QUrl &url)
另请参见iconUrlChanged(), icon(), 和 iconChanged()。
属性名 | 类型 |
---|---|
selectedText | const QString |
此属性保存了当前选中的文本。
默认,此属性包含一个空字符串。
访问函数:
QString selectionText() const
另请参见findText() 和 selectionChanged()。
属性名 | 类型 |
---|---|
title | const QString |
此属性保存了定义为HTML
访问函数:
QString title() const
另请参见titleChanged().
属性名 | 类型 |
---|---|
url | QUrl |
此属性保存了当前可视web页面的URL。
设置这个属性会清空此view和加载URL。
默认,这个属性包含一个空的,无效的URL。
访问函数:
QUrl url() const
void setUrl(const QUrl &url)
另请参见load() 和 urlChanged().
属性名 | 类型 |
---|---|
zoomFactor | qreal |
此属性保存了该view的缩放因子。
有效数值的范围从 0.25 到 5.0。默认因子是1.0。
访问函数:
qreal zoomFactor() const
void setZoomFactor(qreal factor)
与父类parent构造一个空的网页视图。
另请参见load()。
销毁网页视图。
方便的槽函数,加载构建到导航链接的文档列表里的前一个文档。如果没有前一个文档,就不执行任何操作。
它等价于
view->page()->triggerAction(QWebEnginePage::Back);
另请参见forward() 和 pageAction()。
重实现 QWidget::contextMenuEvent()。
每当页面想要创建给定类型的新窗口时,都会从关联的QWebEnginePage的createWindow()方法中调用此函数。 例如,当发出JavaScript请求以在新窗口中打开文档时。
注意: 如果重新实现了关联页面的createWindow()方法,则不会调用此方法,除非在重新实现中明确地这样做。
重实现QWidget::dragEnterEvent()。
重实现QWidget::dragLeaveEvent().
重实现QWidget::dragMoveEvent()。
### [override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)
重实现QWidget::dropEvent()。
### [override virtual protected] bool QWebEngineView::event(QEvent *ev)
重实现QWidget::event().
在页面里找到特殊的字符串,子字符串,通过使用options。
去清空选中部分,只需要传递一个空的字符串。
resultCallback必须带boolean参数, 它将返回true或false, 表明是否找到子字符串。
注意: 我们保证回调函数总是可以被调用,但可能需要在页面构造完成之后。当QWebEnginePage 被删除时,该回调触发带着一个无效的值且作为 QWebEnginePage or QWebEngineView实例里使用是不安全的。
方便的槽函数,加载构建到导航链接的文档列表里的前一个文档。如果没有前一个文档,就不执行任何操作。
它等价于
view->page()->triggerAction(QWebEnginePage::Forward);
另请参见 back() 和 pageAction()。
重实现QWidget::hideEvent().
返回指向web导航页面视图历史的指针。
它等价于:
view->page()->history();
当与视图关联的图标(“favicon”)更改时,将发出此信号。 新图标由图标指定。
此功能在Qt 5.7中引入。
注意:属性图标的通知程序信号。
另请参见 icon(), iconUrl(), 和 iconUrlChanged()。
当与视图关联的图标(“图标”)的URL更改时,将发出此信号。 新URL由url指定。
注意:属性iconUrl的通知程序信号。
另请参见icon(), iconUrl(), 和 iconUrlChanged()。
加载指定的url和显示它。
注意: 该视图保持相同的内容直到足够多的数据去展示新的URL。
另请参见 load(), setUrl(), url(), urlChanged(), 和 QUrl::fromUserInput().
发出指定的请求并加载响应。
Qt 5.9中引入了此功能。
另请参见load(), setUrl(), url(), urlChanged(), and QUrl::fromUserInput().
当加载该页面已经完成的时候,发出该信号。ok 表明加载是成功还是失败。
每当Web视图中的某个元素完成加载(例如嵌入式图像或脚本)时,都会发出此信号。 因此,它跟踪加载Web视图的总体进度。
当前值由progress提供,范围为0到100,这是QProgressBar的默认范围。
另请参见 loadStarted() 和 loadFinished().
当新的页面开始被加载的时候,发出该信号。
返回指向下划线web网页的指针。
返回一个指向QAction的指针,封装了特定网页的动作。
重新加载当前的文档。
当渲染进程返回非零且中断的时候,发出该信号。
当进程中断时,terminationStatus指进程的中断状态,exitCode指进程的状态码。
该函数在 Qt 5.6 引入。
当选择的部分改变的时候,发出该信号。
注意: 当使用鼠标左键单击并拖动来选择文本时,将为每个选定的新字符发出信号,而不是在释放鼠标左键时发出信号。
另请参见 selectedText().
设置网页视图内容到数据里。如果mimeType是空参数,将假定该内容是text/plain,charset=US-ASCII。外部对象在内容里引用的路径是相对于baseUrl。
该数据会被立刻加载。外部对象会被异步加载。
另请参见 load(), setHtml(), 和 QWebEnginePage::toHtml().
将Web视图的内容设置为指定的html内容。
外部对象(例如HTML文档中引用的样式表或图像)相对于baseUrl定位。
HTML文档将立即加载,而外部对象则异步加载。
使用此方法时,除非另有说明,否则Qt WebEngine假定外部资源(例如JavaScript程序或样式表)均以UTF-8编码。 例如,可以通过HTML脚本标签的charset属性指定外部脚本的编码。 或者,可以由Web服务器指定编码。
这是一个等效于setContent(html,“ text / html; charset = UTF-8”,baseUrl)的便利函数。
确保设置page页面到页面视图中。
该父类QObject提供页面维护网页视图对象。如果当前页面是该网页视图的子类,它将会被删除。
**警告:**此功能仅适用于HTML。 对于其他MIME类型(例如XHTML或SVG),应改用setContent()。
注意: 无法显示大于2 MB的内容,因为setHtml()会将提供的HTML转换为百分比编码并将数据:放在其前面以创建要导航到的URL。 从而,提供的代码将成为超出Chromium设置的2 MB限制的URL。 如果内容太大,则使用success = false触发loadFinished()信号。
另请参见 load(), setContent(), QWebEnginePage::toHtml(), 和 QWebEnginePage::setContent().
返回一个指向该视图或页面特殊设置对象的指针。
它等价于:
view->page()->settings();
另请参见 QWebEngineSettings::globalSettings().
重实现 QWidget::showEvent().
重实现 QWidget::sizeHint().
方便的槽函数,停止加载该文档。
它等价于:
view->page()->triggerAction(QWebEnginePage::Stop);
另请参见 reload(), pageAction(), 和 loadFinished().
当该视图的标题改变时,发出该信号。
另请参见 title().
触发特定的动作。如果它是可以选中的动作,这个特殊的选中状态被设定。
接下来的例子触发了复制动作,因此会拷贝任何选中的文本到剪贴板上。
view->triggerPageAction(QWebEnginePage::Copy);
另请参见 pageAction().
当该视图的url改变时,发出该信号。