QWebFrame Class Reference · PyQt4 中文文檔

# QWebFrame Class Reference ## [[QtWebKit](index.htm) module] 該QWebFrame類表示一個web頁面的框架。[More...](#details) 繼承[QObject](qobject.html)。 ### 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.html)對象中包含的至少一個幀，在主框架，得到用[QWebPage.mainFrame](qwebpage.html#mainFrame)（）。額外的幀將用于HTML創建`<frame>` or `<iframe>`元素。一個框架可以使用被加載[load](qwebframe.html#load)（）或[setUrl](qwebframe.html#url-prop)（）。另外，如果你有HTML內容一應俱全，您可以使用[setHtml](qwebframe.html#setHtml)（）來代替。該[page](qwebframe.html#page)（）函數返回一個指向該網頁的對象。看[Elements of QWebView](qwebview.html)對于如何肋骨都涉及到一個網頁和Web視圖的解釋。該QWebFrame類還提供了方法來檢索現時由框架加載的URL（請參閱[url](qwebframe.html#url-prop)（））以及最初請求要加載的URL（見[requestedUrl](qwebframe.html#requestedUrl-prop)（））。這些方法使得有可能在URL之前和之后的DNS解析或重定向檢索在加載過程中發生。該[requestedUrl](qwebframe.html#requestedUrl-prop)（）也匹配到添加到幀歷史的URL（[QWebHistory](qwebhistory.html)），如果加載成功。一個HTML幀的標題可以通過訪問[title](qwebframe.html#title-prop)（）屬性。此外，一個幀也可以利用指定一個圖標，它可被訪問的[icon](qwebframe.html#icon-prop)（）屬性。如果標題或圖標的變化，相應的[titleChanged](qwebframe.html#titleChanged)（）和[iconChanged](qwebframe.html#iconChanged)（）信號將被發射。該[zoomFactor](qwebframe.html#zoomFactor-prop)（）屬性可以被用來改變在幀中顯示的內容的總體尺寸。由網頁創建和控制QWebFrame對象。您可以連接到該網頁的[frameCreated()](qwebpage.html#frameCreated)信號創建一個新的框架時得到通知。有多種方法以編程方式檢查一個幀的內容。該[hitTestContent](qwebframe.html#hitTestContent)（）函數可以被用來找到由坐標元素。用于訪問底層DOM樹，有[documentElement](qwebframe.html#documentElement)（）[findAllElements](qwebframe.html#findAllElements)（）和[findFirstElement](qwebframe.html#findFirstElement)（）。一個QWebFrame可以打印到[QPrinter](qprinter.html)使用[print_](qwebframe.html#print)（）函數。這個功能被標記為一個時隙，并且可以方便地連接到[QPrintPreviewDialog](qprintpreviewdialog.html)的[paintRequested()](qprintpreviewdialog.html#paintRequested)信號。 * * * ## Type Documentation ``` QWebFrame.RenderLayer ``` 這個枚舉說明適用于使用渲染層[render()](qwebframe.html#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](index.htm)。如果你想確保你的[QObjects](index.htm#qobjects)仍可以訪問加載一個新的URL之后，您應該將它們添加在連接到一個槽[javaScriptWindowObjectCleared](qwebframe.html#javaScriptWindowObjectCleared)（）信號。如果未啟用此頁面的Javascript ，則此方法不執行任何操作。該_object_永遠不會被顯式刪除[QtWebKit](index.htm)。 ``` QUrl QWebFrame.baseUrl (self) ``` [ ``` list-of-QWebFrame QWebFrame.childFrames (self) ``` 返回是這個框架的直接子所有幀的列表。 ](qurl.html) [**See also**](qurl.html) [parentFrame](qwebframe.html#parentFrame)（）。 ``` QSize QWebFrame.contentsSize (self) ``` [](qsize.html) ``` QWebElement QWebFrame.documentElement (self) ``` [ 返回該框架的文檔元素。文檔元素可以訪問該幀的整個結構化內容。此功能被引入Qt的4.6 。 ``` QVariant QWebFrame.evaluateJavaScript (self, QString?scriptSource) ``` 這種方法也是一個Qt槽與C + +的簽名`QVariant evaluateJavaScript(const QString&)`。評估的JavaScript定義為_scriptSource_使用這個框架作為背景，并返回最后執行的語句的結果。 ](qwebelement.html) [**See also**](qwebelement.html) [addToJavaScriptWindowObject](qwebframe.html#addToJavaScriptWindowObject)（）和[javaScriptWindowObjectCleared](qwebframe.html#javaScriptWindowObjectCleared)（）。 ``` bool QWebFrame.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QWebElementCollection QWebFrame.findAllElements (self, QString?selectorQuery) ``` [ 返回元素匹配給定的CSS選擇一個新的列表_selectorQuery_。如果沒有匹配的元素，則返回一個空列表。 ](qwebelementcollection.html) [](qwebelementcollection.html)[Standard CSS2 selector](http://www.w3.org/TR/REC-CSS2/selector.html#q1)語法用于查詢。此功能被引入Qt的4.6 。 **See also** [QWebElement.findAll](qwebelement.html#findAll)（）。 ``` QWebElement QWebFrame.findFirstElement (self, QString?selectorQuery) ``` [ 返回匹配給定的CSS選擇器框架的文檔中的第一個元素_selectorQuery_。如果沒有匹配的元素，則返回一個空元素。 ](qwebelement.html) [](qwebelement.html)[Standard CSS2 selector](http://www.w3.org/TR/REC-CSS2/selector.html#q1)語法用于查詢。此功能被引入Qt的4.6 。 **See also** [QWebElement.findFirst](qwebelement.html#findFirst)（）。 ``` QString QWebFrame.frameName (self) ``` 這個幀的父幀所定義的名稱。 ``` QRect QWebFrame.geometry (self) ``` [ 返回幀相對的幾何形狀給它的父框架。 ``` bool QWebFrame.hasFocus (self) ``` ](qrect.html) ``` QWebHitTestResult QWebFrame.hitTestContent (self, QPoint?pos) ``` [ 執行在給定位置上的幀內容的命中測試_pos_并返回命中測試結果。 ](qwebhittestresult.html) ``` QIcon QWebFrame.icon (self) ``` [ ``` QWebFrame.load (self, QUrl?url) ``` 負載_url_這個框架。 **Note:**該視圖保持不變，直到足夠的數據已經到達，以顯示新_url_。 ](qicon.html) [**See also**](qicon.html) [setUrl](qwebframe.html#url-prop)（）[setHtml](qwebframe.html#setHtml)（）和[setContent](qwebframe.html#setContent)（）。 ``` QWebFrame.load (self, QNetworkRequest?request, QNetworkAccessManager.Operation?operation?=?QNetworkAccessManager.GetOperation, QByteArray?body?=?QByteArray()) ``` 加載一個網絡請求，_req_，到這個幀時，使用指定的方法_operation_。 _body_是可選的，并且僅用于POST操作。 **Note:**該視圖保持不變，直到足夠的數據已經到達，以顯示新的內容。 **See also** [setUrl](qwebframe.html#url-prop)（）。 ``` dict-of-QString-list-of-QString QWebFrame.metaData (self) ``` 返回此框架的元數據作為[QMultiMap](index.htm) 所述元數據包含的的名稱和內容屬性的`<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) ``` [ 該網頁包含這個框架。 ](qwebpage.html) [**See also**](qwebpage.html) [pageChanged](qwebframe.html#pageChanged)（）。 ``` QWebFrame QWebFrame.parentFrame (self) ``` [ 返回該框架的父框架，或者0，如果該幀是網頁主要框架。 ](qwebframe.html) [這相當于qobject_cast \u003c](qwebframe.html)[QWebFrame](qwebframe.html)* \u003e （幀\u003e[parent](qobject.html#parent)（））。 **See also** [childFrames](qwebframe.html#childFrames)（）。 ``` QPoint QWebFrame.pos (self) ``` [ 返回幀相對的位置，它的父框架。 ``` QWebFrame.print (self, QPrinter?printer) ``` 這種方法也是一個Qt槽與C + +的簽名`void print(QPrinter *) const`。打印該幀為給定的_printer_。 ](qpoint.html) [**See also**](qpoint.html) [render](qwebframe.html#render)（）。 ``` QWebFrame.print_ (self, QPrinter?printer) ``` 這種方法也是一個Qt槽與C + +的簽名`void print(QPrinter *) const`。打印該幀為給定的_printer_。 **See also** [render](qwebframe.html#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_](qwebframe.html#print)（）。 ``` QString QWebFrame.renderTreeDump (self) ``` 返回渲染樹的轉儲。這主要是用于調試HTML有用。 ``` QUrl QWebFrame.requestedUrl (self) ``` [ ``` QWebFrame.scroll (self, int, int) ``` 滾動框_dx_像素向右和_dy_向下像素。兩_dx_和_dy_可能是負的。此功能被引入Qt的4.5 。 ](qurl.html) [**See also**](qurl.html) [QWebFrame.scrollPosition](qwebframe.html#scrollPosition-prop)。 ``` QRect QWebFrame.scrollBarGeometry (self, Qt.Orientation?orientation) ``` [ 返回與方向滾動條的幾何形狀_orientation_。如果滾動條不存在的空矩形被返回。此功能被引入Qt的4.6 。 ``` int QWebFrame.scrollBarMaximum (self, Qt.Orientation?orientation) ``` 返回最大值與方向的滾動條_orientation_，或者0，如果沒有滾動條找到的_orientation_。 ](qrect.html) [**See also**](qrect.html) [scrollBarMinimum](qwebframe.html#scrollBarMinimum)（）。 ``` int QWebFrame.scrollBarMinimum (self, Qt.Orientation?orientation) ``` 返回最小值與方向的滾動條_orientation_。最低值始終為0。 **See also** [scrollBarMaximum](qwebframe.html#scrollBarMaximum)（）。 ``` Qt.ScrollBarPolicy QWebFrame.scrollBarPolicy (self, Qt.Orientation?orientation) ``` [ 返回由定義的滾動條的滾動條政策_orientation_。 ](qt.html#ScrollBarPolicy-enum) [**See also**](qt.html#ScrollBarPolicy-enum) [setScrollBarPolicy](qwebframe.html#setScrollBarPolicy)（）。 ``` int QWebFrame.scrollBarValue (self, Qt.Orientation?orientation) ``` 返回當前值與方向的滾動條_orientation_，或者0，如果沒有滾動條找到的_orientation_。 **See also** [setScrollBarValue](qwebframe.html#setScrollBarValue)（）[scrollBarMinimum](qwebframe.html#scrollBarMinimum)（）和[scrollBarMaximum](qwebframe.html#scrollBarMaximum)（）。 ``` QPoint QWebFrame.scrollPosition (self) ``` [ ``` QWebFrame.scrollToAnchor (self, QString?anchor) ``` 幀滾動到給定_anchor_名稱。此功能被引入Qt的4.7 。 ](qpoint.html) ``` QWebSecurityOrigin QWebFrame.securityOrigin (self) ``` [ 返回框架的安全性起源。此功能被引入Qt的4.5 。 ``` QWebFrame.setContent (self, QByteArray?data, QString?mimeType?=?QString(), QUrl?baseUrl?=?QUrl()) ``` 設置該幀的內容來指定的內容_data_。如果_mimeType_參數為空它是目前假設內容是HTML，但在未來的版本中，我們可能會引入自動檢測。在內容引用的外部對象的位置相對_baseUrl_。該_data_立即加載;外部對象異步加載。 **Note:**這種方法不會影響會話或世界歷史的框架。 ](qwebsecurityorigin.html) [**See also**](qwebsecurityorigin.html) [toHtml](qwebframe.html#toHtml)（）和[setHtml](qwebframe.html#setHtml)（）。 ``` QWebFrame.setFocus (self) ``` 使鍵盤輸入焦點到這個框架。此功能被引入Qt的4.6 。 **See also** [hasFocus](qwebframe.html#focus-prop)（）。 ``` 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](qwebframe.html#baseUrl-prop)）。 **Note:**這種方法不會影響會話或世界歷史的框架。 **Warning:**此功能僅用于HTML ，為其他MIME類型（即XHTML ， SVG ）[setContent](qwebframe.html#setContent)（）應該使用。 **See also** [toHtml](qwebframe.html#toHtml)（）[setContent](qwebframe.html#setContent)（）和[load](qwebframe.html#load)（）。 ``` QWebFrame.setScrollBarPolicy (self, Qt.Orientation?orientation, Qt.ScrollBarPolicy?policy) ``` 設置為定義的滾動條的滾動條政策_orientation_至_policy_。 **See also** [scrollBarPolicy](qwebframe.html#scrollBarPolicy)（）。 ``` QWebFrame.setScrollBarValue (self, Qt.Orientation?orientation, int?value) ``` 設置當前_value_與方向滾動條_orientation_。滾動條強制_value_要在法律的范圍內：最小值\u003c =值\u003c =最大值。更改該值也會更新拇指的位置。 **See also** [scrollBarValue](qwebframe.html#scrollBarValue)（）[scrollBarMinimum](qwebframe.html#scrollBarMinimum)（）和[scrollBarMaximum](qwebframe.html#scrollBarMaximum)（）。 ``` QWebFrame.setScrollPosition (self, QPoint?pos) ``` ``` QWebFrame.setTextSizeMultiplier (self, float?factor) ``` 設置用于擴展在Web框架的文本乘數的值_factor_規定。 **See also** [textSizeMultiplier](qwebframe.html#textSizeMultiplier)（）。 ``` QWebFrame.setUrl (self, QUrl?url) ``` ``` QWebFrame.setZoomFactor (self, float?factor) ``` ``` float QWebFrame.textSizeMultiplier (self) ``` 返回用于擴展在Web框架中的文字乘數的值。 **See also** [setTextSizeMultiplier](qwebframe.html#setTextSizeMultiplier)（）。 ``` QString QWebFrame.title (self) ``` ``` QString QWebFrame.toHtml (self) ``` 返回框架的內容為HTML ，包含在HTML和BODY標記。 **See also** [setHtml](qwebframe.html#setHtml)（）和[toPlainText](qwebframe.html#toPlainText)（）。 ``` QString QWebFrame.toPlainText (self) ``` 返回該框架的內容轉換為純文本，完全剝奪了所有的HTML格式的。 **See also** [toHtml](qwebframe.html#toHtml)（）。 ``` QUrl QWebFrame.url (self) ``` [ ``` float QWebFrame.zoomFactor (self) ``` * * * ## Qt Signal Documentation ``` void contentsSizeChanged (const QSize&) ``` 這是該信號的默認超載。這個信號被發射時，幀的內容大小變化_size_。此功能被引入Qt的4.6 。 ](qurl.html) [**See also**](qurl.html) [contentsSize](qwebframe.html#contentsSize-prop)（）。 ``` void iconChanged () ``` 這是該信號的默認超載。這個信號時的圖標（ “的favicon ” ）與該幀相關聯的已加載射出。 **See also** [icon](qwebframe.html#icon-prop)（）。 ``` void initialLayoutCompleted () ``` 這是該信號的默認超載。當幀被在第一時間布局這個信號被發射。這是第一次，你會看到畫面上顯示的內容。 **Note:**一個框架可以進行布局多次。 ``` void javaScriptWindowObjectCleared () ``` 這是該信號的默認超載。這個信號被發射時的JavaScript環境的全局的window對象被清除，例如，開始一個新的前負荷。如果您打算添加[QObjects](index.htm#qobjects)到[QWebFrame](qwebframe.html) using [addToJavaScriptWindowObject](qwebframe.html#addToJavaScriptWindowObject)（），你應該將它們添加在連接到該信號的槽。這將確保你的對象加載新的URL時，仍然可以訪問。 ``` void loadFinished (bool) ``` 這是該信號的默認超載。當該幀的負載被完成這個信號被發射。_ok_將指示負載是否成功，或發生任何錯誤。此功能被引入Qt的4.6 。 **See also** [loadStarted](qwebframe.html#loadStarted)（）。 ``` void loadStarted () ``` 這是該信號的默認超載。當開始該幀的一個新的負載，這個信號被發射。此功能被引入Qt的4.6 。 **See also** [loadFinished](qwebframe.html#loadFinished)（）。 ``` void pageChanged () ``` 這是該信號的默認超載。當此幀已被移動到一個不同的這個信號被發射[QWebPage](qwebpage.html)。此功能被引入Qt的4.7 。 **See also** [page](qwebframe.html#page)（）。 ``` void titleChanged (const QString&) ``` 這是該信號的默認超載。這個信號被發射時的幀變化的稱號。該_title_字符串指定新的標題。 **See also** [title](qwebframe.html#title-prop)（）。 ``` void urlChanged (const QUrl&) ``` 這是該信號的默認超載。這個信號被發射與接收到幀的標題時，幀的URL 。新的URL被指定_url_。 **See also** [url](qwebframe.html#url-prop)（）。