Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME

QWebFrame Class Reference
^{^{[QtWebKit module]}}

该QWebFrame类表示一个web页面的框架。More...

继承QObject。

Types

enum RenderLayer { ContentsLayer, ScrollBarLayer, PanIconLayer, AllLayers }

Methods

addToJavaScriptWindowObject (self, QString name, QObject object)
QUrl baseUrl (self)
list-of-QWebFrame childFrames (self)
QSize contentsSize (self)
QWebElement documentElement (self)
QVariant evaluateJavaScript (self, QString scriptSource)
bool event (self, QEvent)
QWebElementCollection findAllElements (self, QString selectorQuery)
QWebElement findFirstElement (self, QString selectorQuery)
QString frameName (self)
QRect geometry (self)
bool hasFocus (self)
QWebHitTestResult hitTestContent (self, QPoint pos)
QIcon icon (self)
load (self, QUrl url)
load (self, QNetworkRequest request, QNetworkAccessManager.Operation operation = QNetworkAccessManager.GetOperation, QByteArray body = QByteArray())
dict-of-QString-list-of-QString metaData (self)
QWebPage page (self)
QWebFrame parentFrame (self)
QPoint pos (self)
print (self, QPrinter printer)
print_ (self, QPrinter printer)
render (self, QPainter painter, QRegion clip)
render (self, QPainter painter)
render (self, QPainter, RenderLayer layer, QRegion clip = QRegion())
QString renderTreeDump (self)
QUrl requestedUrl (self)
scroll (self, int, int)
QRect scrollBarGeometry (self, Qt.Orientation orientation)
int scrollBarMaximum (self, Qt.Orientation orientation)
int scrollBarMinimum (self, Qt.Orientation orientation)
Qt.ScrollBarPolicy scrollBarPolicy (self, Qt.Orientation orientation)
int scrollBarValue (self, Qt.Orientation orientation)
QPoint scrollPosition (self)
scrollToAnchor (self, QString anchor)
QWebSecurityOrigin securityOrigin (self)
setContent (self, QByteArray data, QString mimeType = QString(), QUrl baseUrl = QUrl())
setFocus (self)
setHtml (self, QString html, QUrl baseUrl = QUrl())
setScrollBarPolicy (self, Qt.Orientation orientation, Qt.ScrollBarPolicy policy)
setScrollBarValue (self, Qt.Orientation orientation, int value)
setScrollPosition (self, QPoint pos)
setTextSizeMultiplier (self, float factor)
setUrl (self, QUrl url)
setZoomFactor (self, float factor)
float textSizeMultiplier (self)
QString title (self)
QString toHtml (self)
QString toPlainText (self)
QUrl url (self)
float zoomFactor (self)

Qt Signals

void contentsSizeChanged (const QSize&)
void iconChanged ()
void initialLayoutCompleted ()
void javaScriptWindowObjectCleared ()
void loadFinished (bool)
void loadStarted ()
void pageChanged ()
void titleChanged (const QString&)
void urlChanged (const QUrl&)

Detailed Description

该QWebFrame类表示一个web页面的框架。

QWebFrame表示内部网页中的帧。每QWebPage对象中包含的至少一个帧，在主框架，得到用QWebPage.mainFrame（）。额外的帧将用于HTML创建<frame> or <iframe>元素。

一个框架可以使用被加载load（）或setUrl（）。另外，如果你有HTML内容一应俱全，您可以使用setHtml（）来代替。

该page（）函数返回一个指向该网页的对象。看Elements of QWebView对于如何肋骨都涉及到一个网页和Web视图的解释。

该QWebFrame类还提供了方法来检索现时由框架加载的URL（请参阅url（））以及最初请求要加载的URL（见requestedUrl（））。这些方法使得有可能在URL之前和之后的DNS解析或重定向检索在加载过程中发生。该requestedUrl（）也匹配到添加到帧历史的URL（QWebHistory），如果加载成功。

一个HTML帧的标题可以通过访问title（）属性。此外，一个帧也可以利用指定一个图标，它可被访问的icon（）属性。如果标题或图标的变化，相应的titleChanged（）和iconChanged（）信号将被发射。该zoomFactor（）属性可以被用来改变在帧中显示的内容的总体尺寸。

由网页创建和控制QWebFrame对象。您可以连接到该网页的frameCreated()信号创建一个新的框架时得到通知。

有多种方法以编程方式检查一个帧的内容。该hitTestContent（）函数可以被用来找到由坐标元素。用于访问底层DOM树，有documentElement（）findAllElements（）和findFirstElement（）。

一个QWebFrame可以打印到QPrinter使用print_（）函数。这个功能被标记为一个时隙，并且可以方便地连接到QPrintPreviewDialog的paintRequested()信号。

Type Documentation

QWebFrame.RenderLayer

这个枚举说明适用于使用渲染层render()。该层可以是或的结果一起从下面的列表：

Constant	Value	Description
`QWebFrame.ContentsLayer`	`0x10`	框架的网页内容
`QWebFrame.ScrollBarLayer`	`0x20`	框架的滚动条
`QWebFrame.PanIconLayer`	`0x40`	平移框架时使用的图标
`QWebFrame.AllLayers`	`0xff`	包括上述所有层

Method Documentation

QWebFrame.addToJavaScriptWindowObject (self, QString name, QObject object)

使object可下name从框架的JavaScript的范围内。该object将插入作为框架的window对象的子对象。

Qt的属性将被暴露成JavaScript的性能和插槽的JavaScript方法。 C + +和JavaScript之间的交互的文档中解释QtWebKit bridge。

如果你想确保你的QObjects仍可以访问加载一个新的URL之后，您应该将它们添加在连接到一个槽javaScriptWindowObjectCleared（）信号。

如果未启用此页面的Javascript ，则此方法不执行任何操作。

该object永远不会被显式删除QtWebKit。

QUrl QWebFrame.baseUrl (self)

list-of-QWebFrame QWebFrame.childFrames (self)

返回是这个框架的直接子所有帧的列表。

See also parentFrame（）。

QSize QWebFrame.contentsSize (self)

QWebElement QWebFrame.documentElement (self)

返回该框架的文档元素。

文档元素可以访问该帧的整个结构化内容。

此功能被引入Qt的4.6 。

QVariant QWebFrame.evaluateJavaScript (self, QString scriptSource)

这种方法也是一个Qt槽与C + +的签名QVariant evaluateJavaScript(const QString&)。

评估的JavaScript定义为scriptSource使用这个框架作为背景，并返回最后执行的语句的结果。

See also addToJavaScriptWindowObject（）和javaScriptWindowObjectCleared（）。

bool QWebFrame.event (self, QEvent)

从重新实现QObject.event（）。

QWebElementCollection QWebFrame.findAllElements (self, QString selectorQuery)

返回元素匹配给定的CSS选择一个新的列表selectorQuery。如果没有匹配的元素，则返回一个空列表。

Standard CSS2 selector语法用于查询。

此功能被引入Qt的4.6 。

See also QWebElement.findAll（）。

QWebElement QWebFrame.findFirstElement (self, QString selectorQuery)

返回匹配给定的CSS选择器框架的文档中的第一个元素selectorQuery。如果没有匹配的元素，则返回一个空元素。

Standard CSS2 selector语法用于查询。

此功能被引入Qt的4.6 。

See also QWebElement.findFirst（）。

QString QWebFrame.frameName (self)

这个帧的父帧所定义的名称。

QRect QWebFrame.geometry (self)

返回帧相对的几何形状给它的父框架。

bool QWebFrame.hasFocus (self)

QWebHitTestResult QWebFrame.hitTestContent (self, QPoint pos)

执行在给定位置上的帧内容的命中测试pos并返回命中测试结果。

QIcon QWebFrame.icon (self)

QWebFrame.load (self, QUrl url)

负载url这个框架。

Note:该视图保持不变，直到足够的数据已经到达，以显示新url。

See also setUrl（）setHtml（）和setContent（）。

QWebFrame.load (self, QNetworkRequest request, QNetworkAccessManager.Operation operation = QNetworkAccessManager.GetOperation, QByteArray body = QByteArray())

加载一个网络请求，req，到这个帧时，使用指定的方法operation。

body是可选的，并且仅用于POST操作。

Note:该视图保持不变，直到足够的数据已经到达，以显示新的内容。

See also setUrl（）。

dict-of-QString-list-of-QString QWebFrame.metaData (self)

返回此框架的元数据作为QMultiMap

所述元数据包含的的名称和内容属性的<meta>标籤在HTML文档中。

例如：

 <html>
     <head>
         <meta name="description" content="This document is a tutorial about Qt development">
         <meta name="keywords" content="Qt, WebKit, Programming">
     </head>
     ...
 </html>

鑑于上面的HTML代码中的元数据（）函数将返回两个条目的地图：

Key	Value
"description"	"This document is a tutorial about Qt development"
"keywords"	"Qt, WebKit, Programming"

这个函数返回一个多地图，支持多种meta标籤具有相同属性的名称。

此功能被引入Qt的4.5 。

QWebPage QWebFrame.page (self)

该网页包含这个框架。

See also pageChanged（）。

QWebFrame QWebFrame.parentFrame (self)

返回该框架的父框架，或者0，如果该帧是网页主要框架。

这相当于qobject_cast \u003cQWebFrame* \u003e （帧\u003eparent（））。

See also childFrames（）。

QPoint QWebFrame.pos (self)

返回帧相对的位置，它的父框架。

QWebFrame.print (self, QPrinter printer)

这种方法也是一个Qt槽与C + +的签名void print(QPrinter *) const。

打印该帧为给定的printer。

See also render（）。

QWebFrame.print_ (self, QPrinter printer)

这种方法也是一个Qt槽与C + +的签名void print(QPrinter *) const。

打印该帧为给定的printer。

See also render（）。

QWebFrame.render (self, QPainter painter, QRegion clip)

帧渲染成painter。

QWebFrame.render (self, QPainter painter)

帧渲染成painter削波clip。

QWebFrame.render (self, QPainter, RenderLayer layer, QRegion clip = QRegion())

渲染layer使用帧的painter削波clip。

此功能被引入Qt的4.6 。

See also print_（）。

QString QWebFrame.renderTreeDump (self)

返回渲染树的转储。这主要是用于调试HTML有用。

QUrl QWebFrame.requestedUrl (self)

QWebFrame.scroll (self, int, int)

滚动框dx像素向右和dy向下像素。两dx和dy可能是负的。

此功能被引入Qt的4.5 。

See also QWebFrame.scrollPosition。

QRect QWebFrame.scrollBarGeometry (self, Qt.Orientation orientation)

返回与方向滚动条的几何形状orientation。

如果滚动条不存在的空矩形被返回。

此功能被引入Qt的4.6 。

int QWebFrame.scrollBarMaximum (self, Qt.Orientation orientation)

返回最大值与方向的滚动条orientation，或者0，如果没有滚动条找到的orientation。

See also scrollBarMinimum（）。

int QWebFrame.scrollBarMinimum (self, Qt.Orientation orientation)

返回最小值与方向的滚动条orientation。

最低值始终为0。

See also scrollBarMaximum（）。

Qt.ScrollBarPolicy QWebFrame.scrollBarPolicy (self, Qt.Orientation orientation)

返回由定义的滚动条的滚动条政策orientation。

See also setScrollBarPolicy（）。

int QWebFrame.scrollBarValue (self, Qt.Orientation orientation)

返回当前值与方向的滚动条orientation，或者0，如果没有滚动条找到的orientation。

See also setScrollBarValue（）scrollBarMinimum（）和scrollBarMaximum（）。

QPoint QWebFrame.scrollPosition (self)

QWebFrame.scrollToAnchor (self, QString anchor)

帧滚动到给定anchor名称。

此功能被引入Qt的4.7 。

QWebSecurityOrigin QWebFrame.securityOrigin (self)

返回框架的安全性起源。

此功能被引入Qt的4.5 。

QWebFrame.setContent (self, QByteArray data, QString mimeType = QString(), QUrl baseUrl = QUrl())

设置该帧的内容来指定的内容data。如果mimeType参数为空它是目前假设内容是HTML，但在未来的版本中，我们可能会引入自动检测。

在内容引用的外部对象的位置相对baseUrl。

该data立即加载;外部对象异步加载。

Note:这种方法不会影响会话或世界历史的框架。

See also toHtml（）和setHtml（）。

QWebFrame.setFocus (self)

使键盘输入焦点到这个框架。

此功能被引入Qt的4.6 。

See also hasFocus（）。

QWebFrame.setHtml (self, QString html, QUrl baseUrl = QUrl())

设置此帧的内容来html。baseUrl是可选的，用来解析文档中的相对URL ，如引用的图片或样式表。

该html立即加载;外部对象异步加载。

如果在一个脚本html由于被封锁的模态JavaScript警告对话框的运行时间比默认的脚本超时（目前为10秒），例如，此方法将超时和任何后续后尽快返回html将异步加载。

当使用这种方法的WebKit假定外部资源，例如JavaScript程序或样式表，除非另有规定被编码为UTF -8 。例如，外部脚本的编码可以通过HTML脚本标记的charset属性来指定。另外，也可以对由Web服务器被指定的编码。

这相当于一个方便的功能，使用setContent （ HTML ， “为text / html ” ，baseUrl）。

Note:这种方法不会影响会话或世界历史的框架。

Warning:此功能仅用于HTML ，为其他MIME类型（即XHTML ， SVG ）setContent（）应该使用。

See also toHtml（）setContent（）和load（）。

QWebFrame.setScrollBarPolicy (self, Qt.Orientation orientation, Qt.ScrollBarPolicy policy)

设置为定义的滚动条的滚动条政策orientation至policy。

See also scrollBarPolicy（）。

QWebFrame.setScrollBarValue (self, Qt.Orientation orientation, int value)

设置当前value与方向滚动条orientation。

滚动条强制value要在法律的范围内：最小值\u003c =值\u003c =最大值。

更改该值也会更新拇指的位置。

See also scrollBarValue（）scrollBarMinimum（）和scrollBarMaximum（）。

QWebFrame.setScrollPosition (self, QPoint pos)

QWebFrame.setTextSizeMultiplier (self, float factor)

设置用于扩展在Web框架的文本乘数的值factor规定。

See also textSizeMultiplier（）。

QWebFrame.setUrl (self, QUrl url)

QWebFrame.setZoomFactor (self, float factor)

float QWebFrame.textSizeMultiplier (self)

返回用于扩展在Web框架中的文字乘数的值。

See also setTextSizeMultiplier（）。

QString QWebFrame.title (self)

QString QWebFrame.toHtml (self)

返回框架的内容为HTML ，包含在HTML和BODY标记。

See also setHtml（）和toPlainText（）。

QString QWebFrame.toPlainText (self)

返回该框架的内容转换为纯文本，完全剥夺了所有的HTML格式的。

See also toHtml（）。

QUrl QWebFrame.url (self)

float QWebFrame.zoomFactor (self)

Qt Signal Documentation

void contentsSizeChanged (const QSize&)

这是该信号的默认超载。

这个信号被发射时，帧的内容大小变化size。

此功能被引入Qt的4.6 。

See also contentsSize（）。

void iconChanged ()

这是该信号的默认超载。

这个信号时的图标（ “的favicon ” ）与该帧相关联的已加载射出。

See also icon（）。

void initialLayoutCompleted ()

这是该信号的默认超载。

当帧被在第一时间布局这个信号被发射。这是第一次，你会看到画面上显示的内容。

Note:一个框架可以进行布局多次。

void javaScriptWindowObjectCleared ()

这是该信号的默认超载。

这个信号被发射时的JavaScript环境的全局的window对象被清除，例如，开始一个新的前负荷。

如果您打算添加QObjects到QWebFrame using addToJavaScriptWindowObject（），你应该将它们添加在连接到该信号的槽。这将确保你的对象加载新的URL时，仍然可以访问。

void loadFinished (bool)

这是该信号的默认超载。

当该帧的负载被完成这个信号被发射。ok将指示负载是否成功，或发生任何错误。

此功能被引入Qt的4.6 。

See also loadStarted（）。

void loadStarted ()

这是该信号的默认超载。

当开始该帧的一个新的负载，这个信号被发射。

此功能被引入Qt的4.6 。

See also loadFinished（）。

void pageChanged ()

这是该信号的默认超载。

当此帧已被移动到一个不同的这个信号被发射QWebPage。

此功能被引入Qt的4.7 。

See also page（）。

void titleChanged (const QString&)

这是该信号的默认超载。

这个信号被发射时的帧变化的称号。该title字符串指定新的标题。

See also title（）。

void urlChanged (const QUrl&)

这是该信号的默认超载。

这个信号被发射与接收到帧的标题时，帧的URL 。新的URL被指定url。

See also url（）。

PyQt 4.10.3 for X11

Qt 4.8.5

QWebFrame Class Reference[QtWebKit module]

Types

Methods

Qt Signals

Detailed Description

Type Documentation

QWebFrame.RenderLayer

Method Documentation

QWebFrame.addToJavaScriptWindowObject (self, QString name, QObject object)

QUrl QWebFrame.baseUrl (self)

list-of-QWebFrame QWebFrame.childFrames (self)

QSize QWebFrame.contentsSize (self)

QWebElement QWebFrame.documentElement (self)

QVariant QWebFrame.evaluateJavaScript (self, QString scriptSource)

bool QWebFrame.event (self, QEvent)

QWebElementCollection QWebFrame.findAllElements (self, QString selectorQuery)

QWebElement QWebFrame.findFirstElement (self, QString selectorQuery)

QString QWebFrame.frameName (self)

QRect QWebFrame.geometry (self)

bool QWebFrame.hasFocus (self)

QWebHitTestResult QWebFrame.hitTestContent (self, QPoint pos)

QIcon QWebFrame.icon (self)

QWebFrame.load (self, QUrl url)

QWebFrame.load (self, QNetworkRequest request, QNetworkAccessManager.Operation operation = QNetworkAccessManager.GetOperation, QByteArray body = QByteArray())

dict-of-QString-list-of-QString QWebFrame.metaData (self)

QWebPage QWebFrame.page (self)

QWebFrame QWebFrame.parentFrame (self)

QPoint QWebFrame.pos (self)

QWebFrame.print (self, QPrinter printer)

QWebFrame.print_ (self, QPrinter printer)

QWebFrame.render (self, QPainter painter, QRegion clip)

QWebFrame.render (self, QPainter painter)

QWebFrame.render (self, QPainter, RenderLayer layer, QRegion clip = QRegion())

QString QWebFrame.renderTreeDump (self)

QUrl QWebFrame.requestedUrl (self)

QWebFrame.scroll (self, int, int)

QRect QWebFrame.scrollBarGeometry (self, Qt.Orientation orientation)

int QWebFrame.scrollBarMaximum (self, Qt.Orientation orientation)

int QWebFrame.scrollBarMinimum (self, Qt.Orientation orientation)

Qt.ScrollBarPolicy QWebFrame.scrollBarPolicy (self, Qt.Orientation orientation)

int QWebFrame.scrollBarValue (self, Qt.Orientation orientation)

QPoint QWebFrame.scrollPosition (self)

QWebFrame.scrollToAnchor (self, QString anchor)

QWebSecurityOrigin QWebFrame.securityOrigin (self)

QWebFrame.setContent (self, QByteArray data, QString mimeType = QString(), QUrl baseUrl = QUrl())

QWebFrame.setFocus (self)

QWebFrame.setHtml (self, QString html, QUrl baseUrl = QUrl())

QWebFrame.setScrollBarPolicy (self, Qt.Orientation orientation, Qt.ScrollBarPolicy policy)

QWebFrame.setScrollBarValue (self, Qt.Orientation orientation, int value)

QWebFrame.setScrollPosition (self, QPoint pos)

QWebFrame.setTextSizeMultiplier (self, float factor)

QWebFrame.setUrl (self, QUrl url)

QWebFrame.setZoomFactor (self, float factor)

float QWebFrame.textSizeMultiplier (self)

QString QWebFrame.title (self)

QString QWebFrame.toHtml (self)

QString QWebFrame.toPlainText (self)

QUrl QWebFrame.url (self)

float QWebFrame.zoomFactor (self)

Qt Signal Documentation

void contentsSizeChanged (const QSize&)

void iconChanged ()

void initialLayoutCompleted ()

void javaScriptWindowObjectCleared ()

void loadFinished (bool)

void loadStarted ()

void pageChanged ()

void titleChanged (const QString&)

void urlChanged (const QUrl&)

QWebFrame Class Reference
^{^{[QtWebKit module]}}