QWebPage Class Reference

[QtWebKit module]

该QWebPage类提供了一个对象来查看和编辑网页文件。More…

继承QObject

Types

  • class **[ChooseMultipleFilesExtensionOption]($docs-index.htm)**
  • class **[ChooseMultipleFilesExtensionReturn]($docs-index.htm)**
  • enum ErrorDomain { QtNetwork, Http, WebKit }
  • class **[ErrorPageExtensionOption]($docs-index.htm)**
  • class **[ErrorPageExtensionReturn]($docs-index.htm)**
  • enum Extension { ChooseMultipleFilesExtension, ErrorPageExtension }
  • class **[ExtensionOption]($docs-index.htm)**
  • class **[ExtensionReturn]($docs-index.htm)**
  • enum Feature { Notifications, Geolocation }
  • enum FindFlag { FindBackward, FindCaseSensitively, FindWrapsAroundDocument, HighlightAllOccurrences }
  • class **[FindFlags]($docs-index.htm)**
  • enum LinkDelegationPolicy { DontDelegateLinks, DelegateExternalLinks, DelegateAllLinks }
  • enum NavigationType { NavigationTypeLinkClicked, NavigationTypeFormSubmitted, NavigationTypeBackOrForward, NavigationTypeReload, NavigationTypeFormResubmitted, NavigationTypeOther }
  • enum PermissionPolicy { PermissionUnknown, PermissionGrantedByUser, PermissionDeniedByUser }
  • class **[ViewportAttributes]($docs-index.htm)**
  • enum WebAction { NoWebAction, OpenLink, OpenLinkInNewWindow, OpenFrameInNewWindow, ..., CopyImageUrlToClipboard }
  • enum WebWindowType { WebBrowserWindow, WebModalDialog }

Methods

  • __init__ (self, QObject parent = None)
  • bool acceptNavigationRequest (self, QWebFrame frame, QNetworkRequest request, NavigationType type)
  • QAction action (self, WebAction action)
  • int bytesReceived (self)
  • QString chooseFile (self, QWebFrame originatingFrame, QString oldFile)
  • QObject createPlugin (self, QString classid, QUrl url, QStringList paramNames, QStringList paramValues)
  • QMenu createStandardContextMenu (self)
  • QWebPage createWindow (self, WebWindowType type)
  • QWebFrame currentFrame (self)
  • bool event (self, QEvent)
  • bool extension (self, Extension extension, ExtensionOption option = None, ExtensionReturn output = None)
  • bool findText (self, QString subString, FindFlags options = 0)
  • bool focusNextPrevChild (self, bool next)
  • bool forwardUnsupportedContent (self)
  • QWebFrame frameAt (self, QPoint pos)
  • bool hasSelection (self)
  • QWebHistory history (self)
  • QVariant inputMethodQuery (self, Qt.InputMethodQuery property)
  • bool isContentEditable (self)
  • bool isModified (self)
  • javaScriptAlert (self, QWebFrame originatingFrame, QString msg)
  • bool javaScriptConfirm (self, QWebFrame originatingFrame, QString msg)
  • javaScriptConsoleMessage (self, QString message, int lineNumber, QString sourceID)
  • (bool, QString result) javaScriptPrompt (self, QWebFrame originatingFrame, QString msg, QString defaultValue)
  • bool javaScriptPrompt (self, QWebFrame originatingFrame, QString msg, QString defaultValue, QString result)
  • LinkDelegationPolicy linkDelegationPolicy (self)
  • QWebFrame mainFrame (self)
  • QNetworkAccessManager networkAccessManager (self)
  • QPalette palette (self)
  • QWebPluginFactory pluginFactory (self)
  • QSize preferredContentsSize (self)
  • QString selectedHtml (self)
  • QString selectedText (self)
  • setActualVisibleContentRect (self, QRect rect)
  • setContentEditable (self, bool editable)
  • setFeaturePermission (self, QWebFrame frame, Feature feature, PermissionPolicy policy)
  • setForwardUnsupportedContent (self, bool forward)
  • setLinkDelegationPolicy (self, LinkDelegationPolicy policy)
  • setNetworkAccessManager (self, QNetworkAccessManager manager)
  • setPalette (self, QPalette palette)
  • setPluginFactory (self, QWebPluginFactory factory)
  • setPreferredContentsSize (self, QSize size)
  • QWebSettings settings (self)
  • setView (self, QWidget view)
  • setViewportSize (self, QSize size)
  • bool shouldInterruptJavaScript (self)
  • QStringList supportedContentTypes (self)
  • bool supportsContentType (self, QString mimeType)
  • bool supportsExtension (self, Extension extension)
  • bool swallowContextMenuEvent (self, QContextMenuEvent event)
  • int totalBytes (self)
  • triggerAction (self, WebAction action, bool checked = False)
  • QUndoStack undoStack (self)
  • updatePositionDependentActions (self, QPoint pos)
  • QString userAgentForUrl (self, QUrl url)
  • QWidget view (self)
  • ViewportAttributes viewportAttributesForSize (self, QSize availableSize)
  • QSize viewportSize (self)

Qt Signals

  • void applicationCacheQuotaExceeded (QWebSecurityOrigin *,quint64)
  • void contentsChanged ()
  • void databaseQuotaExceeded (QWebFrame *,QString)
  • void downloadRequested (const QNetworkRequest&)
  • void featurePermissionRequestCanceled (QWebFrame *,QWebPage::Feature)
  • void featurePermissionRequested (QWebFrame *,QWebPage::Feature)
  • void frameCreated (QWebFrame *)
  • void geometryChangeRequested (const QRect&)
  • void linkClicked (const QUrl&)
  • void linkHovered (const QString&,const QString&,const QString&)
  • void loadFinished (bool)
  • void loadProgress (int)
  • void loadStarted ()
  • void menuBarVisibilityChangeRequested (bool)
  • void microFocusChanged ()
  • void printRequested (QWebFrame *)
  • void repaintRequested (const QRect&)
  • void restoreFrameStateRequested (QWebFrame *)
  • void saveFrameStateRequested (QWebFrame *,QWebHistoryItem *)
  • void scrollRequested (int,int,const QRect&)
  • void selectionChanged ()
  • void statusBarMessage (const QString&)
  • void statusBarVisibilityChangeRequested (bool)
  • void toolBarVisibilityChangeRequested (bool)
  • void unsupportedContent (QNetworkReply *)
  • void viewportChangeRequested ()
  • void windowCloseRequested ()

Detailed Description

该QWebPage类提供了一个对象来查看和编辑网页文件。

QWebPage持有主框架负责网页内容,设置导航的链接和行动的历史。该类可用于连同QWebFrame,以提供类似的功能QWebView在一个小部件少的环境。

QWebPage的API非常相似,QWebView,因为你仍然提供了常用的功能,如action( )(称为pageAction( )在QWebView) ,triggerAction( )findText()和settings( ) 。更多QWebView类似的功能可以在QWebPage的主框架中找到,通过将得到的mainFrame()函数。例如,本load( )setUrl()和setHtml( )为QWebPage功能都可以通过访问QWebFrame

loadStarted当页面开始load.The ()信号被发射loadProgress()信号,另一方面,是每当该网页的元素完成加载,如嵌入图像,脚本等发出最后,该loadFinished( )信号时,页面内容完全加载,独立执行脚本或页面渲染的发射。它的参数,无论是真或假,指示加载操作是否成功。

Using QWebPage in a Widget-less Environment

在开始之前画QWebPage对象,你需要通过调用设置视口的大小setViewportSize( ) 。然后,调用主框架的渲染功能(QWebFrame.render())。这方面的一个例子是显示在下面的代码片段。

假设我们有一个Thumbnail类,如下所示:

  1. class Thumbnailer : public [QObject]($docs-qobject.html)
  2. {
  3. Q_OBJECT
  4. public:
  5. Thumbnailer(const [QUrl](qurl.html) &url);
  6. signals:
  7. void finished();
  8. private slots:
  9. void render();
  10. private:
  11. QWebPage page;
  12. };

Thumbnail的构造函数接受一个url。我们连接我们的QWebPage对象的loadFinished()信号给我们的私人插槽,render()

  1. Thumbnailer.Thumbnailer(const [QUrl](qurl.html) &url)
  2. {
  3. page.mainFrame()->load(url);
  4. connect(&page, SIGNAL(loadFinished(bool)),
  5. this, SLOT(render()));
  6. }

render()函数说明我们如何使用QWebPage对象画一个缩略图。

  1. void Thumbnailer.render()
  2. {
  3. page.setViewportSize(page.mainFrame()->contentsSize());
  4. [QImage]($docs-qimage.html) image(page.viewportSize(), [QImage]($docs-qimage.html).Format_ARGB32);
  5. [QPainter]($docs-qpainter.html) painter(&image);
  6. page.mainFrame()->render(&painter);
  7. painter.end();
  8. [QImage]($docs-qimage.html) thumbnail = image.scaled(400, 400);
  9. thumbnail.save("thumbnail.png");
  10. emit finished();
  11. }

我们首先通过设置viewportSize然后我们实例化一个QImage反对,image与相同尺寸的本viewportSize。此图像然后作为一个参数传送painter。接下来,我们呈现在主框架和其子帧中的内容复制到painter。最后,我们保存缩放图像。


Type Documentation

  1. QWebPage.ErrorDomain

这个枚举描述的域ErrorPageExtensionOption对象(即在发生错误的图层) 。

Constant Value Description
QWebPage.QtNetwork 0 发生在QtNetwork层中的错误;错误代码的类型是QNetworkReply.NetworkError
QWebPage.Http 1 发生在HTTP层中的错误;错误码是一个HTTP状态代码(见QNetworkRequest.HttpStatusCodeAttribute) 。
QWebPage.WebKit 2 该错误是一个内部WebKit的错误。

这个枚举被引入或修改的Qt 4.6 。

  1. QWebPage.Extension

该枚举描述了该页面可以支持的扩展的类型。使用这些扩展之前,您应该确认该扩展支持通过调用supportsExtension( ) 。

Constant Value Description
QWebPage.ChooseMultipleFilesExtension 0 无论是网页支持多文件选择。这个扩展时调用网页内容要求的一个或多个文件名,例如,作为一个“文件上传”按钮,用户点击在多个文件中允许选择一个HTML表单的结果。
QWebPage.ErrorPageExtension 1 无论何时加载失败的网页可以提供一个错误页面。 (在Qt的4.6中引入)

See also ChooseMultipleFilesExtensionOptionChooseMultipleFilesExtensionReturnErrorPageExtensionOptionErrorPageExtensionReturn

  1. QWebPage.Feature
  1. QWebPage.FindFlag

这个枚举说明可供的选项findText()函数。该选项可以是或的结果一起从下面的列表:

Constant Value Description
QWebPage.FindBackward 1 搜索,而不是向前向后。
QWebPage.FindCaseSensitively 2 默认情况下,findText( )的作品不区分大小写。指定此选项改变行为,以区分大小写的查找操作。
QWebPage.FindWrapsAroundDocument 4 品牌findText( )从文件的开头重新启动,如果年底达到和文本未找到。
QWebPage.HighlightAllOccurrences 8 亮点特定字符串的所有现有出现。 (这个值被引入4.6 。 )

该FindFlags类型是一个typedef为QFlags\u003cFindFlag\u003e 。它存储FindFlag值的或组合。

  1. QWebPage.LinkDelegationPolicy

这个枚举变量定义代表团策略网页可以有激活链接和发光时,linkClicked()信号。

Constant Value Description
QWebPage.DontDelegateLinks 0 没有链接委派。相反,QWebPage尝试处理他们。
QWebPage.DelegateExternalLinks 1 当激活链接指向未存储在本地文件系统或等效的文件 - 如Qt的资源系统 - 然后linkClicked()被发射。
QWebPage.DelegateAllLinks 2 每当一个链接被激活的linkClicked()信号被发射。

See also QWebPage.linkDelegationPolicy

  1. QWebPage.NavigationType

这个枚举变量描述了通过链接文件浏览时,浏览可用的类型。

Constant Value Description
QWebPage.NavigationTypeLinkClicked 0 用户点击了一个集中的环节一个环节或按下回报。
QWebPage.NavigationTypeFormSubmitted 1 用户激活一个提交按钮的HTML表单。
QWebPage.NavigationTypeBackOrForward 2 导航到后退或前进史上的前面显示的文件要求。
QWebPage.NavigationTypeReload 3 用户激活重装行动。
QWebPage.NavigationTypeFormResubmitted 4 HTML表单被提交第二次。
QWebPage.NavigationTypeOther 5 使用方法的导航到另一个文档上面没有列出。

See also acceptNavigationRequest( ) 。

  1. QWebPage.PermissionPolicy
  1. QWebPage.WebAction

该枚举描述,可以在网页上执行的动作的类型。

操作只在产生作用的时候都适用。行动的可用性可以通过检查来确定isEnabled()在返回的行动action( ) 。

使文字编辑,光标移动,和文本选择操作的一种方法是通过设置contentEditable为True。

Constant Value Description
QWebPage.NoWebAction -1 无动作被触发。
QWebPage.OpenLink 0 打开当前链接。
QWebPage.OpenLinkInNewWindow 1 在新窗口中打开当前链接。
QWebPage.OpenFrameInNewWindow 2 复制当前帧在一个新窗口。
QWebPage.DownloadLinkToDisk 3 下载当前链接到磁盘上。
QWebPage.CopyLinkToClipboard 4 复制当前链接到剪贴板。
QWebPage.OpenImageInNewWindow 5 在新窗口中打开高亮显示的图像。
QWebPage.DownloadImageToDisk 6 突出显示的图像下载到磁盘。
QWebPage.CopyImageToClipboard 7 突出显示的图像复制到剪贴板。
QWebPage.CopyImageUrlToClipboard 68 突出显示的图像的URL复制到剪贴板。
QWebPage.Back 8 导航回导航链接的历史。
QWebPage.Forward 9 向前导航的导航链接的历史。
QWebPage.Stop 10 停止加载当前页面。
QWebPage.StopScheduledPageRefresh 67 停止所有挂起的页面刷新/重定向请求。
QWebPage.Reload 11 重新载入当前页面。
QWebPage.ReloadAndBypassCache 53 重新加载当前页,但不使用任何本地缓存。 (由Qt中4.6 )
QWebPage.Cut 12 剪下当前所选复制到剪贴板中的内容。
QWebPage.Copy 13 复制当前所选复制到剪贴板中的内容。
QWebPage.Paste 14 粘贴内容来自剪贴板。
QWebPage.Undo 15 撤销上一次编辑操作。
QWebPage.Redo 16 重做上一次编辑操作。
QWebPage.MoveToNextChar 17 将光标移动到下一个字符。
QWebPage.MoveToPreviousChar 18 将光标移动到前一个字符。
QWebPage.MoveToNextWord 19 将光标移动到下一个单词。
QWebPage.MoveToPreviousWord 20 将光标移动到前一个单词。
QWebPage.MoveToNextLine 21 将光标移动到下一行。
QWebPage.MoveToPreviousLine 22 将光标移动到上一行。
QWebPage.MoveToStartOfLine 23 将光标移动到该行的开始。
QWebPage.MoveToEndOfLine 24 将光标移动到行的结尾。
QWebPage.MoveToStartOfBlock 25 将光标移动到该块的开始。
QWebPage.MoveToEndOfBlock 26 将光标移动到该块的末端。
QWebPage.MoveToStartOfDocument 27 将光标移动到文档的开头。
QWebPage.MoveToEndOfDocument 28 将光标移动到该文件的末尾。
QWebPage.SelectNextChar 29 选择下一个字符。
QWebPage.SelectPreviousChar 30 选择前一个字符。
QWebPage.SelectNextWord 31 选择下一个单词。
QWebPage.SelectPreviousWord 32 选择前一个字。
QWebPage.SelectNextLine 33 选择到下一行。
QWebPage.SelectPreviousLine 34 选择到上一行。
QWebPage.SelectStartOfLine 35 选择到行的开始。
QWebPage.SelectEndOfLine 36 选择到行的结尾。
QWebPage.SelectStartOfBlock 37 选择该块的开始。
QWebPage.SelectEndOfBlock 38 选择在块的末尾。
QWebPage.SelectStartOfDocument 39 选择到文件的开头。
QWebPage.SelectEndOfDocument 40 选择该文档的结尾。
QWebPage.DeleteStartOfWord 41 删除到单词的开头。
QWebPage.DeleteEndOfWord 42 删除该单词的末尾。
QWebPage.SetTextDirectionDefault 43 设置文本的方向为默认方向。
QWebPage.SetTextDirectionLeftToRight 44 设置文本的方向从左向右。
QWebPage.SetTextDirectionRightToLeft 45 设置文本方向从右到左。
QWebPage.ToggleBold 46 切换大胆和正常体重的格式。
QWebPage.ToggleItalic 47 切换斜体和正常风格之间的格式。
QWebPage.ToggleUnderline 48 切换下划线。
QWebPage.InspectElement 49 与当前显示的Web检查器高亮显示的HTML元素。
QWebPage.InsertParagraphSeparator 50 插入一个新的段落。
QWebPage.InsertLineSeparator 51 插入一个新行。
QWebPage.SelectAll 52 选择所有内容。
QWebPage.PasteAndMatchStyle 54 从剪贴板粘贴内容与目前的风格。
QWebPage.RemoveFormat 55 删除格式和样式。
QWebPage.ToggleStrikethrough 56 切换删除线和普通样式的格式设置。
QWebPage.ToggleSubscript 57 切换下标和基线之间的格式。
QWebPage.ToggleSuperscript 58 切换supercript和基线之间的格式。
QWebPage.InsertUnorderedList 59 切换有序列表和一个正常的块之间的选择。
QWebPage.InsertOrderedList 60 切换有序列表和一个正常的块之间的选择。
QWebPage.Indent 61 增加当前选择的格式块的一个增量的压痕。
QWebPage.Outdent 62 减少当前选定的格式块的一个增量的压痕。
QWebPage.AlignCenter 63 适用于中心对齐内容。
QWebPage.AlignJustified 64 适用于充分理由内容。
QWebPage.AlignLeft 65 适用于左对齐内容。
QWebPage.AlignRight 66 适用于右对齐内容。
  1. QWebPage.WebWindowType

该枚举描述了可以通过创建窗口的类型createWindow()函数。

Constant Value Description
QWebPage.WebBrowserWindow 0 该窗口是一个普通的Web浏览器窗口。
QWebPage.WebModalDialog 1 该窗口作为模态对话框。

Method Documentation

  1. QWebPage.__init__ (self, QObject parent = None)

parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。

构造一个空QWebPage与父parent

  1. bool QWebPage.acceptNavigationRequest (self, QWebFrame frame, QNetworkRequest request, NavigationType type)

这个函数被调用时WebKit请求导航frame由指定的资源request通过指定的导航类型的装置type

If frame是一个空指针,然后导航到一个新的窗口请求。如果该请求被接受createWindow( )将被调用。

默认实现解释页面的linkDelegationPolicy并据此发出linkClicked或返回True ,让QWebPage处理导航本身。

See also createWindow( ) 。

  1. QAction QWebPage.action (self, WebAction action)

返回QAction为指定的WebAction action

该动作由资QWebPage但是你可以通过改变其属性自定义的外观。

QWebPage还采取执行行动的护理,使在触发在页面上执行相应的动作。

See also triggerAction( ) 。

  1. int QWebPage.bytesReceived (self)

返回从网络中接收到的呈现当前页面的字节数。

See also totalBytes()和loadProgress( ) 。

  1. QString QWebPage.chooseFile (self, QWebFrame originatingFrame, QString oldFile)

当网页内容请求一个文件名,例如同时对一个HTML表单“文件上传”按钮,用户点击的结果,此函数被调用。

一个建议的文件名可以在提供suggestedFile。发出请求的帧被设置为parentFrame

See also ChooseMultipleFilesExtension

  1. QObject QWebPage.createPlugin (self, QString classid, QUrl url, QStringList paramNames, QStringList paramValues)

这个函数被调用时WebKit遇到与类型“应用程序/ x - QT-插件”一个HTML object元素。这就是所谓的值无关QWebSettings.PluginsEnabled。该classidurlparamNamesparamValues对应于HTML object元素属性和子元素来配置内嵌的对象。

  1. QMenu QWebPage.createStandardContextMenu (self)

[

这个函数创建当用户点击网页上用鼠标右键其显示在标准上下文菜单。这是从默认contextMenuEvent ( )处理函数中调用。在弹出菜单的所有权被传递给调用者。

此功能被引入Qt的4.5 。

](qmenu.html)

  1. QWebPage QWebPage.createWindow (self, WebWindowType type)

这个函数被调用时WebKit要创造的赋予了新的窗口type,因为当一个JavaScript程序请求打开新窗口的文档的例子。

如果可以创建新窗口,新窗口的QWebPage返回;否则返回空指针。

如果与网页相关的视图是QWebView对象,则默认实现请求转发到QWebView的CreateWindow的( )函数,否则返回空指针。

If type is WebModalDialog,应用程序必须调用setWindowModality (Qt.ApplicationModal)上的新窗口。

Note:在该情况下,当窗口的创建是由JavaScript的触发,除了重新实现此方法的应用程序还必须设置的JavaScriptCanOpenWindows属性QWebSettings为True,以便它被调用。

See also acceptNavigationRequest()和QWebView.createWindow( ) 。

  1. QWebFrame QWebPage.currentFrame (self)

[

返回框架目前活跃。

]($docs-qwebframe.html)

See also mainFrame()和frameCreated( ) 。

  1. bool QWebPage.event (self, QEvent)

从重新实现QObject.event( ) 。

  1. bool QWebPage.extension (self, Extension extension, ExtensionOption option = None, ExtensionReturn output = None)

这个虚函数可以在重新实现QWebPage子类以提供扩展的支持。该option参数被作为输入提供给扩展,输出结果可以被存储在output

这个函数的行为由以下因素决定extension。该optionoutput值通常铸造成相应的类型(例如,ChooseMultipleFilesExtensionOptionChooseMultipleFilesExtensionReturnChooseMultipleFilesExtension) 。

您可以致电supportsExtension( )来检查一个扩展是支持的页面。

返回True如果扩展被成功调用,否则返回False 。

See also supportsExtension()和Extension

  1. bool QWebPage.findText (self, QString subString, FindFlags options = 0)

查找指定的字符串,subString在该页面中,使用给定的options

如果HighlightAllOccurrences标志传递,函数将突出存在于页面中的所有事件。所有后续调用将延长的亮点,而不是取代它,以出现新的字符串。

如果HighlightAllOccurrences标志不通过,该函数将选择的发生,所有后续调用将取代目前出现的下一个。

要清除选择,只传递一个空字符串。

返回True如果subString结果发现,否则返回False 。

  1. bool QWebPage.focusNextPrevChild (self, bool next)

QWidget.focusNextPrevChild( ),它侧重的下一个可获得焦点的网页元素,如果next为True,否则前面的元素集中。

返回True如果能找到一个新的聚焦元素,还是假的,如果它不能。

  1. bool QWebPage.forwardUnsupportedContent (self)
  1. QWebFrame QWebPage.frameAt (self, QPoint pos)

[

返回框架在给定点pos或0 ,如果没有帧在该位置。

此功能被引入Qt的4.6 。

]($docs-qwebframe.html)

See also mainFrame()和currentFrame( ) 。

  1. bool QWebPage.hasSelection (self)
  1. QWebHistory QWebPage.history (self)

[

返回一个指针,指向的导航网页视图的历史。

  1. QVariant QWebPage.inputMethodQuery (self, Qt.InputMethodQuery property)

这种方法所使用的输入方法来查询一组页面的属性,以便能够支持复杂的输入操作方法为周围的文本和reconversions支持。

property指定哪些属性进行查询。

]($docs-qwebhistory.html)

See also QWidget.inputMethodEvent( )QInputMethodEventQInputContext

  1. bool QWebPage.isContentEditable (self)
  1. bool QWebPage.isModified (self)
  1. QWebPage.javaScriptAlert (self, QWebFrame originatingFrame, QString msg)

这个函数被调用当一个JavaScript程序中运行frame调用与消息警报( )函数msg

默认实现显示信息,msg,与QMessageBox.information 。

  1. bool QWebPage.javaScriptConfirm (self, QWebFrame originatingFrame, QString msg)

这个函数被调用当一个JavaScript程序中运行frame该消息调用确认( )函数,msg。如果用户确认的消息,则返回True ,否则返回False 。

默认实现执行使用QMessageBox.information与查询QMessageBox.YesQMessageBox.No按钮。

  1. QWebPage.javaScriptConsoleMessage (self, QString message, int lineNumber, QString sourceID)

每当一个JavaScript程序试图打印这个函数被调用message到web浏览器的控制台。

例如在发生计算错误的源URL可被提供sourceID以及lineNumber

默认实现打印什么。

  1. (bool, QString result) QWebPage.javaScriptPrompt (self, QWebFrame originatingFrame, QString msg, QString defaultValue)

这个函数被调用当一个JavaScript程序中运行frame尝试将提示用户输入。该方案可以提供一个可选的消息,msg,以及用于将输入的默认值defaultValue

如果提示已取消用户的实现应该返回False ,否则结果应写入result而真正应该返回。如果提示没有被用户取消,实行应返回True ,结果字符串不能为空。

默认实现使用QInputDialog.getText( ) 。

  1. bool QWebPage.javaScriptPrompt (self, QWebFrame originatingFrame, QString msg, QString defaultValue, QString result)
  1. LinkDelegationPolicy QWebPage.linkDelegationPolicy (self)

  1. QWebFrame QWebPage.mainFrame (self)

[

返回该页面的主框架。

主框架可访问的子帧的层次结构,并且还需要,如果你想明确地呈现一个网页到一个给定的画家。

]($docs-qwebframe.html)

See also currentFrame( ) 。

  1. QNetworkAccessManager QWebPage.networkAccessManager (self)

返回QNetworkAccessManager这是负责提供这个网络请求QWebPage

See also setNetworkAccessManager( ) 。

  1. QPalette QWebPage.palette (self)

  1. QWebPluginFactory QWebPage.pluginFactory (self)

返回QWebPluginFactory该负责创建插件嵌入到这个QWebPage。如果没有安装插件工厂则返回空指针。

See also setPluginFactory( ) 。

  1. QSize QWebPage.preferredContentsSize (self)

[

  1. QString QWebPage.selectedHtml (self)
  1. QString QWebPage.selectedText (self)
  1. QWebPage.setActualVisibleContentRect (self, QRect rect)
  1. QWebPage.setContentEditable (self, bool editable)
  1. QWebPage.setFeaturePermission (self, QWebFrame frame, Feature feature, PermissionPolicy policy)
  1. QWebPage.setForwardUnsupportedContent (self, bool forward)
  1. QWebPage.setLinkDelegationPolicy (self, LinkDelegationPolicy policy)
  1. QWebPage.setNetworkAccessManager (self, QNetworkAccessManager manager)

]($docs-qsize.html)

设置QNetworkAccessManager manager负责提供该网络的请求QWebPage

Note:它目前不支持后更改网络访问管理器QWebPage已使用过它。这样做的结果是不确定的。

See also networkAccessManager( ) 。

  1. QWebPage.setPalette (self, QPalette palette)
  1. QWebPage.setPluginFactory (self, QWebPluginFactory factory)

设置QWebPluginFactory factory负责创建插件嵌入到这个QWebPage

注:该插件工厂仅用于本QWebSettings.PluginsEnabled属性被启用。

See also pluginFactory( ) 。

  1. QWebPage.setPreferredContentsSize (self, QSize size)
  1. QWebSettings QWebPage.settings (self)

[

返回一个指向该页面的设置对象。

]($docs-qwebsettings.html)

See also QWebSettings.globalSettings( ) 。

  1. QWebPage.setView (self, QWidget view)

设置view与该网页相关联。

See also view( ) 。

  1. QWebPage.setViewportSize (self, QSize size)
  1. bool QWebPage.shouldInterruptJavaScript (self)

这种方法也是一个Qt槽与C + +的签名bool shouldInterruptJavaScript()

当一个JavaScript程序运行的很长一段时间调用此函数。

如果用户想停止执行JavaScript应返回True ,否则返回False 。

默认实现执行使用QMessageBox.information与查询QMessageBox.YesQMessageBox.No按钮。

Warning:因为二进制兼容性的限制,这个功能是不是虚拟的。如果你想提供自己的实现在QWebPage子类,重新实现shouldInterruptJavaScript ()槽在你的子类来代替。QtWebKit将动态检测插槽,并调用它。

此功能被引入Qt的4.6 。

  1. QStringList QWebPage.supportedContentTypes (self)

返回所支持的所有内容类型的列表QWebPage

  1. bool QWebPage.supportsContentType (self, QString mimeType)

返回True如果QWebPage可以处理给定的mimeType否则,返回False 。

  1. bool QWebPage.supportsExtension (self, Extension extension)

这个虚函数返回True ,如果该网页支持extension否则返回False。

See also extension( ) 。

  1. bool QWebPage.swallowContextMenuEvent (self, QContextMenuEvent event)

过滤器的上下文菜单事件,event通过处理程序的滚动条和自定义事件处理程序的网页。返回True如果该事件已经被处理,否则为False 。

一个网页可以通过自定义事件处理程序吞下一个上下文菜单事件,允许上下文菜单在HTML / JavaScript实现。这是由Google Maps,例如。

  1. int QWebPage.totalBytes (self)

返回从网络中接收到的呈现当前页面的总字节数,包括额外的内容,例如嵌入的图像。

See also bytesReceived( ) 。

  1. QWebPage.triggerAction (self, WebAction action, bool checked = False)

这个功能可以被调用来触发指定action。它也被称为由QtWebKit如果用户通过上下文菜单项触发操作,例如。

If action是一个辨认的行动,那么checked是否动作翻转或不指定。

See also action( ) 。

  1. QUndoStack QWebPage.undoStack (self)

[

返回一个指针,用于可编辑内容的撤消堆栈。

]($docs-qundostack.html)

See also modified

  1. QWebPage.updatePositionDependentActions (self, QPoint pos)

更新取决于位置的页面上的动作pos。例如,如果pos是在图像元素CopyImageToClipboard动作处于开启状态。

  1. QString QWebPage.userAgentForUrl (self, QUrl url)

需要对HTTP请求的用户代理时,此函数被调用。您可以重新实现这个函数来动态地返回不同的用户代理的不同的URL的基础上,url参数。

默认实现返回以下值:

“ Mozilla/5.0 ( %台% %安全% %子平台% ) AppleWebKit / % WebKitVersion % ( KHTML ,像壁虎) % AppVersion Safari浏览器/ % WebKitVersion % ”

在移动平台,如Symbian的S60和Maemo , “移动Safari浏览器”是用来代替“野生动物园” 。

在这个字符串中使用以下值被替换在运行时:

  • %Platform% expands to the windowing system followed by “; “ if it is not Windows (e.g. “X11; “).
  • %Security% expands to “N; “ if SSL is disabled.
  • %Subplatform% expands to the operating system version (e.g. “Windows NT 6.1” or “Intel Mac OS X 10.5”).
  • %WebKitVersion% is the version of WebKit the application was compiled against.
  • %AppVersion% expands to QCoreApplication.applicationName()/QCoreApplication.applicationVersion() if they’re set; otherwise defaulting to Qt and the current Qt version.
  1. QWidget QWebPage.view (self)

[

返回与该网页相关的视图控件。

]($docs-qwidget.html)

See also setView( ) 。

  1. ViewportAttributes QWebPage.viewportAttributesForSize (self, QSize availableSize)

[

计算给出了最优的视口配置availableSize,当用户界面组件被忽视。

配置也依赖于它是自动获得的设备的屏幕尺寸。出于测试目的的大小可以通过设置两个环境变量QTWEBKIT_DEVICE_WIDTH和QTWEBKIT_DEVICE_HEIGHT ,这需要设置两个被复盖。

]($docs-index.htm)

ViewportAttributes包括像素密度比,这也将暴露在网络作者虽然 - WebKit的像素比媒体功能。这是1密度无关的像素(DPI)和物理像素之间的比率。

甲密度无关的像素相当于一个160 DPI的屏幕上的一个物理像素,所以在我们的平台假定作为基准密度。

拨码单位转换为屏幕像素是很简单的:

像素= DIP封装* (密度/ 160 ) 。

因此, 240 DPI屏幕上,1个DIP为将等于1.5物理像素。

无效的实例将在一个空的大小传递给方法的情况下返回。

Note:密度是从哪里页面被显示在屏幕的DPI自动获得的,但由于许多X11服务器报告错误的DPI ,可以利用来复盖它QX11Info.setAppDpiY( ) 。

  1. QSize QWebPage.viewportSize (self)

[


Qt Signal Documentation

  1. void applicationCacheQuotaExceeded (QWebSecurityOrigin *,quint64)

这是该信号的默认超载。

这个信号被发射时网站会要求将数据存储到应用程序缓存数据库,databaseName和分配给该网站超出配额。

  1. void contentsChanged ()

这是该信号的默认超载。

这个信号被发射时在表单元素中的文本变化以及其他可编辑的内容。

此功能被引入Qt的4.5 。

]($docs-qsize.html)

See also contentEditablemodifiedQWebFrame.toHtml()和QWebFrame.toPlainText( ) 。

  1. void databaseQuotaExceeded (QWebFrame *,QString)

这是该信号的默认超载。

这个信号被发射时显示在网站上frame在问到的数据存储到数据库中databaseName以及分配给该网站超出配额。

此功能被引入Qt的4.5 。

See also QWebDatabase

  1. void downloadRequested (const QNetworkRequest&)

这是该信号的默认超载。

当用户决定下载一个链接,这个信号被发射。链路以及额外的元信息的URL是包含在request

See also unsupportedContent( ) 。

  1. void featurePermissionRequestCanceled (QWebFrame *,QWebPage::Feature)

这是该信号的默认超载。

  1. void featurePermissionRequested (QWebFrame *,QWebPage::Feature)

这是该信号的默认超载。

  1. void frameCreated (QWebFrame *)

这是该信号的默认超载。

每当页创建一个新的这个信号被发射frame

See also currentFrame( ) 。

  1. void geometryChangeRequested (const QRect&)

这是该信号的默认超载。

这个信号被发射时的文件要在页面的位置和大小,来改变对geom。这可以通过JavaScript发生的例子。

  1. void linkClicked (const QUrl&)

这是该信号的默认超载。

每当用户点击一个链接,该页面的这个信号被发射linkDelegationPolicy属性设置为处理委讬为指定的链接url

默认情况下没有链接委派,并通过处理QWebPage代替。

Note:这个信号可能将不发射的点击其中的链接使用JavaScript来触发导航。

See also linkHovered( ) 。

  1. void linkHovered (const QString&,const QString&,const QString&)

这是该信号的默认超载。

当鼠标悬停在链接这个信号被发射。

link包含链接的url。title是链接元素的标题,如果它在标记中指定。textContent链接元素中提供的文本,例如, HTML锚点标记内的文本。

当鼠标离开链接元素的信号被发射空参数。

See also linkClicked( ) 。

  1. void loadFinished (bool)

这是该信号的默认超载。

当网页完成加载内容这个信号被发射。这个信号是脚本执行或页面渲染无关。ok将指示负载是否成功,或发生任何错误。

See also loadStarted()和ErrorPageExtension

  1. void loadProgress (int)

这是该信号的默认超载。

这个信号被发射的全球进展状态发生变化时。电流值是由所提供progress和秤从0到100 ,这是默认范围QProgressBar。它积累的所有子帧的变化。

See also bytesReceived( ) 。

  1. void loadStarted ()

这是该信号的默认超载。

当一个页面开始加载内容这个信号被发射。

See also loadFinished( ) 。

  1. void menuBarVisibilityChangeRequested (bool)

这是该信号的默认超载。

每当菜单栏的Web浏览器窗口的可见性承载这个信号被发射QWebPage应改为visible

  1. void microFocusChanged ()

这是该信号的默认超载。

这个信号被发射时的光标,例如在一个可编辑的表单元素的位置变化。它是用来通知输入方法有关新的屏幕上的位置,其中用户能够输入文字。此信号通常是连接到QWidget.updateMicroFocus()槽。

  1. void printRequested (QWebFrame *)

这是该信号的默认超载。

每当页面请求的Web浏览器来打印这个信号被发射frame例如,通过JavaScript的window.print()打电话。

See also QWebFrame.print()和QPrintPreviewDialog

  1. void repaintRequested (const QRect&)

这是该信号的默认超载。

这个信号被发射时这QWebPage应该被更新。渲染时,它的一个非常有用QWebPage没有QWebView or QGraphicsWebViewdirtyRect包含需要被更新的区域。粉刷QWebPage得到mainFrame( )并调用渲染(QPainter* ,常量QRegion&)方法与dirtyRect作为第二个参数。

See also mainFrame()和view( ) 。

  1. void restoreFrameStateRequested (QWebFrame *)

这是该信号的默认超载。

这个信号被发射时的负荷frame完成后,应用程序现在可以相应地更新其状态。

此功能被引入Qt的4.5 。

  1. void saveFrameStateRequested (QWebFrame *,QWebHistoryItem *)

这是该信号的默认超载。

在导航页面的历史前不久这个信号被发射frame导航回在记录时被改变,例如。

提供QWebHistoryItemitem持有该帧的改变之前的历史记录条目。

一个潜在的用例这个信号是存储自定义数据的QWebHistoryItem相关联的帧,利用QWebHistoryItem.setUserData( ) 。

此功能被引入Qt的4.5 。

  1. void scrollRequested (int,int,const QRect&)

这是该信号的默认超载。

每当含量由下式给出这个信号被发射rectToScroll需要滚动dxdy向下,没有视图设置。

See also view().

  1. void selectionChanged ()

这是该信号的默认超载。

这个信号被发射时的选择发生变化,以交互方式或编程方式(如通过调用triggerAction()与选择操作)。

See also selectedText( ) 。

  1. void statusBarMessage (const QString&)

这是该信号的默认超载。

这个信号被发射时,状态栏text由页改变。

  1. void statusBarVisibilityChangeRequested (bool)

这是该信号的默认超载。

每当状态栏的Web浏览器窗口的可见性承载这个信号被发射QWebPage应改为visible

  1. void toolBarVisibilityChangeRequested (bool)

这是该信号的默认超载。

每当工具栏上的Web浏览器窗口的可见性承载这个信号被发射QWebPage应改为visible

  1. void unsupportedContent (QNetworkReply *)

这是该信号的默认超载。

这个信号被发射时WebKit无法处理用户导航到或Web服务器的响应包括与’附件’指令一个“内容处置”标题中的链接。如果“内容处置”存在于reply, web服务器,指示客户端应提示用户不管内容类型来保存内容。请参见RFC 2616 19.5.1节有关内容处置的细节。

在信号发射时间的元数据QNetworkReply reply是可用的。

Note:在接收时隙是负责删除QNetworkReply reply

Note:此信号仅当发射forwardUnsupportedContent属性设置为True。

See also downloadRequested( ) 。

  1. void viewportChangeRequested ()

这是该信号的默认超载。

页面作者可以通过使用viewport meta标籤提供的提供的值。关于这方面的更多信息可以在这里找到 Safari Reference Library: Using the Viewport Meta Tag

此功能被引入Qt的4.8 。

See also QWebPage.ViewportAttributessetPreferredContentsSize()和QGraphicsWebView.setScale( ) 。

  1. void windowCloseRequested ()

这是该信号的默认超载。

每当页面请求的Web浏览器窗口,通过JavaScript的关闭,例如这个信号被发射window.close()打电话。