Qt4.8文档翻译：QWebView类参考，QWebView Class Reference

属性

•. icon : const QIcon

•. title : const QString •. url : QUrl

公有函数

QIcon	icon () const
void	load ( const QUrl & url )
void	load ( const QNetworkRequest & request, QNetworkAccessManager::Operation operation = QNetworkAccessManager::GetOperation, const QByteArray & body = QByteArray() )
void	setUrl ( const QUrl & url )
QString	title () const
QUrl	url () const

信号

void	iconChanged ()
void	linkClicked ( const QUrl & url )
void	loadFinished ( bool ok )
void	loadProgress ( int progress )
void	loadStarted ()
void	titleChanged ( const QString & title )
void	urlChanged ( const QUrl & url )

详细说明

QWebView 类提供了一个用于查看及编辑网页文档的部件。

QWebView是 QtWebKit 网页浏览模块的主要部件组件 。它可在多种程序中用于显示互联网上的网页内容。

下图显示的是，在 Qt Designer 中的QWebView 预览，里面显示的是诺基亚网站。

可使用 load ()函数来将一个网站载入到QWebView 中 。就像所有的 Qt部件一样 ，要调用 show ()函数才能显示出QWebView。以下代码片断演示了这个过程 ：

QWebView *view = new QWebView (parent);

view->load( QUrl ("http://qt.nokia.com/"));

view->show();

或者 ，也可以使用 setUrl ()来载入一个网站。如果妳已经获取到了要显示的 HTML内容 ，那么，也可以使用 setHtml ()将它直接显示出来。

当视图开始载入网页时 ，会发射 loadStarted ()信号。另一方面 ，还有一个信号 loadProgress () ，每当此网页视图中的某个元素载入完成时便会发射一次，例如一张嵌入的图片、一个脚本等等。最后，当视图完成了载入过程之后，会发射 loadFinished ()信号 。它的参数—— true或false——表示了载入是成功了还是失败了 。

page ()函数返回此视图中的网页对象的一个指针 。参考 QWebView 中的元素 ，以了解网页对象与网页视图之间是什么关系 。要想修改妳的网页视图的设置信息的话 ，可使用 settings ()函数来访问到相应的 QWebSettings 对象。通过 QWebSettings ，妳可以修改默认的字体，启用或禁用某些特性，例如 JavaScript和插件。

HTML 文档的标题可使用 title ()属性来获取 。另外 ，网站可能会指定一个图标，这个图标可使用 icon ()属性来获取。如果标题或图标发生改变，则会发射对应的 titleChanged ()和 iconChanged ()信号 。 textSizeMultiplier ()属性可用来改变此网页视图中显示的文字的整体尺寸 。

如果妳需要实现一个自定义的上下文菜单 ，那么，可以重写 contextMenuEvent() 函数，并且使用从 pageAction ()中获取到的那些动作来填充 QMenu 。更多的功能 ，例如重新载入视图、将选中的文字得到的剪贴板，也都是由从 pageAction ()中获取的 QAction 对象来封装的。这些动作可以在代码中使用 triggerPageAction ()来触发 。或者 ，也可以将这些动作直接添加到工具条或菜单中。 QWebView会维护所返回的动作的状态 ，但是，这些动作的某些属性是允许修改的，例如 text 或 icon 。

一个QWebView可以使用 print ()函数来打印到一个 QPrinter 中去 。这个函数是一个信号槽 ，因而，可以方便地连接到 QPrintPreviewDialog 的 paintRequested() 信号上去。

如果妳需要支持那些允许用户打开新窗口 （例如弹出窗口） 的网站的话 ，就需要子类化 QWebView并且重写 createWindow ()函数 。

QWebView的元素

QWebView由其它对象组成 ，例如 QWebFrame 和 QWebPage 。以下流程图展示了这些元素之间的关系 。

注意 ： 如果妳不需要 QWidget 相关的那些属性的话 ，可以在不使用 QWebView 的情况下使用 QWebPage 和 QWebFrame 。然而 ， QtWebKit 依赖 QtGui ，所以，妳应当使用一个 QApplication 而不是使用 QCoreApplication 。

参考 预览器示例 、 网页浏览器 、 表单提取器示例 、 谷歌聊天示例 和 高级浏览器示例 。

属性文档

icon : const QIcon

这个属性中储存的是与当前查看的网页相关联的图标。

默认情况下，这个属性中储存的是一个空图标。

访问函数 ：

QIcon

icon () const

参考 iconChanged ()和 QWebSettings::iconForUrl () 。

title : const QString

这个属性中储存着当前查看的网页的标题。

默认情况下，这个属性中包含着一个空白的字符串。

访问函数：

QString

title () const

参考 titleChanged () 。

url : QUrl

这个属性中储存着当前查看的网页的URL。

设置这个属性的话，会清空视图对象，并且载入该URL。

默认情况下，这个属性中包含一个空的、无效的URL。

访问函数：

QUrl	url () const
void	setUrl ( const QUrl & url )

参考 load ()和 urlChanged () 。

成员函数文档

void QWebView:: iconChanged () [signal]

当本页面的图标被载入或者改变时，会发射此信号。

为了能够正常载入图标，妳需要使用 QWebSettings::setIconDatabasePath ()来设置一个图标数据库路径 。

参考 icon ()和 QWebSettings::setIconDatabasePath () 。

void QWebView:: linkClicked ( const QUrl & url ) [signal]

当用户点击了某个链接，并且当前页面中的linkDelegationPolicy 属性被设置为将此 url 的链接处理过程委托给程序员时，会发射此信号。

参考 QWebPage::linkDelegationPolicy () 。

void QWebView:: load ( const QUrl & url )

载入指定的url并且显示它。

注意 ：该视图会保持原来的外观，直到收到了足够的用于显示该 url 的数据时才会改变。

参考 setUrl () 、 url () 、 urlChanged ()和 QUrl::fromUserInput () 。

void QWebView:: load ( const QNetworkRequest & request , QNetworkAccessManager::Operation operation = QNetworkAccessManager::GetOperation, const QByteArray & body = QByteArray() )

使用operation中指定的方法来载入一个网络请求request 。

body是可选的，只用于POST操作。

注意 ：该视图会保持原来的外观，直到收到了足够的用于显示该 url 的数据时才会改变。

参考 url ()和 urlChanged () 。

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

当页面载入完成时，会发射此信号。 ok用于表示载入过程是成功完成还是出现了错误。

参考 loadStarted () 。

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

每当网页中的某个元素载入完成，并且整体的载入进度发生改变时，就会发射这个信号。

这个信号会跟踪所有子代框架页中的进度。

当前值由 progress 表示 ，其范围是从0到100，也就是 QProgressBar 的默认范围。

参考 loadStarted ()和 loadFinished () 。

void QWebView:: loadStarted () [signal]

当页面开始进行载入动作时，会发射此信号。

参考 loadProgress ()和 loadFinished () 。

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

当主框架页的标题title发生改变时，会发射此信号。

参考 title () 。

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

当视图的url发生改变时，会发射这个信号。

参考 url ()和 load () 。

未知美人

刘倩

满足您丰胸的渴望

嘉兴市庆六一少儿舞蹈大赛

未知美人