QWebSettings Class Reference

[QtWebKit module]

该QWebSettings类提供了一个对象来存储所使用的设置QWebPage和QWebFrame。More…

Types

• enum FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, FantasyFont }
• enum FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize }
• enum WebAttribute { AutoLoadImages, JavascriptEnabled, JavaEnabled, PluginsEnabled, ..., HyperlinkAuditingEnabled }
• enum WebGraphic { MissingImageGraphic, MissingPluginGraphic, DefaultFrameIconGraphic, TextAreaSizeGripCornerGraphic, ..., SearchCancelButtonPressedGraphic }

Methods

• QString defaultTextEncoding (self)
• QString fontFamily (self, FontFamily which)
• int fontSize (self, FontSize type)
• QString localStoragePath (self)
• resetAttribute (self, WebAttribute attr)
• resetFontFamily (self, FontFamily which)
• resetFontSize (self, FontSize type)
• setAttribute (self, WebAttribute attr, bool on)
• setDefaultTextEncoding (self, QString encoding)
• setFontFamily (self, FontFamily which, QString family)
• setFontSize (self, FontSize type, int size)
• setLocalStoragePath (self, QString path)
• setUserStyleSheetUrl (self, QUrl location)
• bool testAttribute (self, WebAttribute attr)
• QUrl userStyleSheetUrl (self)

Static Methods

• clearIconDatabase ()
• clearMemoryCaches ()
• enablePersistentStorage (QString path = QString())
• QWebSettings globalSettings ()
• QString iconDatabasePath ()
• QIcon iconForUrl (QUrl url)
• int maximumPagesInCache ()
• int offlineStorageDefaultQuota ()
• QString offlineStoragePath ()
• QString offlineWebApplicationCachePath ()
• int offlineWebApplicationCacheQuota ()
• setIconDatabasePath (QString location)
• setMaximumPagesInCache (int pages)
• setObjectCacheCapacities (int cacheMinDeadCapacity, int cacheMaxDead, int totalCapacity)
• setOfflineStorageDefaultQuota (int maximumSize)
• setOfflineStoragePath (QString path)
• setOfflineWebApplicationCachePath (QString path)
• setOfflineWebApplicationCacheQuota (int maximumSize)
• setWebGraphic (WebGraphic type, QPixmap graphic)
• QPixmap webGraphic (WebGraphic type)

Detailed Description

该QWebSettings类提供了一个对象来存储所使用的设置QWebPage和QWebFrame。

Each QWebPage对象都有自己的QWebSettings对象，它配置该页面的设置。如果未配置设置，那么就抬头在全局设置对象，可以使用访问globalSettings（ ） 。

QWebSettings允许浏览器属性，如字体大小和家庭，自定义样式表的位置，如JavaScript和插件的通用属性配置。各个属性使用设置setAttribute（）函数。该WebAttribute枚举进一步描述了每个属性。

QWebSettings还配置全局属性，如网页的内存缓存，图标数据库，本地数据库存储和离线应用程序存储。

Enabling Plugins

支持浏览器插件可以通过设置启用PluginsEnabled属性。对于许多应用来说，这个属性是启用所有的网页通过在设置它global settings object。QtWebKit将处理Qt的插件时，总是忽略此设置。允许决定一个Qt插件在其重新实现由客户端QWebPage.createPlugin（ ） 。

Web Application Support

WebKit的规定在指定功能的支持HTML 5能够提高Web应用程序的性能和功能。其中包括客户端（离线）的存储和使用Web应用程序缓存。

客户端（离线）存储是经过改良的使用Cookie来存储持久数据的Web应用程序。应用程序可以配置并启用通过调用使用离线存储数据库的setOfflineStoragePath（）以适当的文件路径，并且可以通过调用限制配额为每个应用程序setOfflineStorageDefaultQuota（ ） 。

Type Documentation

QWebSettings.FontFamily

这个枚举描述由CSS 2中定义的通用字体家族。欲了解更多信息，请参阅CSS standard。

QWebSettings.FontSize

这个枚举变量描述字体大小，通过配置QWebSettings。

QWebSettings.WebAttribute

这个枚举变量描述了通过配置各种属性QWebSettings。

QWebSettings.WebGraphic

此枚举描述网页中使用的标准图形元素。

Method Documentation

QWebSettings.clearIconDatabase ()

清除图标库。

QWebSettings.clearMemoryCaches ()

将释放尽可能多的内存可以通过清理所有的内存高速缓存，如页面，对象和字体缓存。

此功能被引入Qt的4.6 。

QString QWebSettings.defaultTextEncoding (self)

返回默认文本编码。

此功能被引入Qt的4.6 。

See also setDefaultTextEncoding（ ） 。

QWebSettings.enablePersistentStorage (QString path = QString())

启用WebKit的数据持久化，并设置为路径path。如果path是空的，由指定的用户特定数据的位置DataLocation将被代替使用。

此方法将同时设置并启用iconDatabasePath（ ）localStoragePath（ ）offlineStoragePath（）和offlineWebApplicationCachePath（ ） 。

此功能被引入Qt的4.6 。

See also localStoragePath（ ） 。

QString QWebSettings.fontFamily (self, FontFamily which)

返回实际的字体系列指定通用字体家族，which。

See also setFontFamily（ ） 。

int QWebSettings.fontSize (self, FontSize type)

返回默认的字体大小type。

See also setFontSize（ ） 。

QWebSettings QWebSettings.globalSettings ()

[

返回全局设置对象。

]($docs-qwebsettings.html)

改变默认的对象的任何设置将自动应用于所有QWebPage倘或特定的设置尚未复盖。

QString QWebSettings.iconDatabasePath ()

如果返回的图标数据库被禁用的图标库或空字符串的路径。

See also setIconDatabasePath（）和clearIconDatabase（ ） 。

QIcon QWebSettings.iconForUrl (QUrl url)

[

返回该网站的图标url。

]($docs-qicon.html)

如果网站不指定图标OR如果图标是不是在数据库中，空QIcon返回。

Note:返回图标的大小是任意的。

See also setIconDatabasePath（ ） 。

QString QWebSettings.localStoragePath (self)

返回HTML5的本地存储路径。

此功能被引入Qt的4.6 。

See also setLocalStoragePath（ ） 。

int QWebSettings.maximumPagesInCache ()

返回的网页被保存在内存中缓存的最大数量。

See also setMaximumPagesInCache（ ） 。

int QWebSettings.offlineStorageDefaultQuota ()

返回默认配额为新的离线存储数据库中的值。

此功能被引入Qt的4.5 。

See also setOfflineStorageDefaultQuota（ ） 。

QString QWebSettings.offlineStoragePath ()

返回的功能，如果禁用了HTML5的客户端数据库存储或空字符串的路径。

此功能被引入Qt的4.5 。

See also setOfflineStoragePath（ ） 。

QString QWebSettings.offlineWebApplicationCachePath ()

返回的功能，如果禁用了HTML5离线Web应用程序的缓存存储或空字符串的路径。

此功能被引入Qt的4.6 。

See also setOfflineWebApplicationCachePath（ ） 。

int QWebSettings.offlineWebApplicationCacheQuota ()

返回配额的离线网络应用程序缓存的值。

此功能被引入Qt的4.6 。

See also setOfflineWebApplicationCacheQuota（ ） 。

QWebSettings.resetAttribute (self, WebAttribute attr)

复位的设置attribute在全球指定的值QWebSettings实例。

此功能对全球无影响QWebSettings实例。

See also globalSettings（ ） 。

QWebSettings.resetFontFamily (self, FontFamily which)

通过复位指定的实际字体系列which到所述一个全局设置QWebSettings实例。

此功能对全球无影响QWebSettings实例。

QWebSettings.resetFontSize (self, FontSize type)

复位时的字体大小type在指定的大小的全局设置对象。

此功能对全球无影响QWebSettings实例。

QWebSettings.setAttribute (self, WebAttribute attr, bool on)

启用或禁用指定attribute功能取决于价值on。

QWebSettings.setDefaultTextEncoding (self, QString encoding)

指定默认的文字编码系统。

该encoding，必须描述的编码，如“ UTF-8”的字符串， “ISO-8859 -1”等，如果为空的默认值将被使用。对于更广泛的编码名称的列表，请参阅QTextCodec

此功能被引入Qt的4.6 。

See also defaultTextEncoding（ ） 。

QWebSettings.setFontFamily (self, FontFamily which, QString family)

将实际的字体家族family指定通用系列，which。

See also fontFamily（ ） 。

QWebSettings.setFontSize (self, FontSize type, int size)

设置字体大小type至size。

See also fontSize（ ） 。

QWebSettings.setIconDatabasePath (QString location)

设置的图标数据库的路径path。图标数据库，用于存储与网站相关联的“收藏夹图标” 。

path必须指向现有的目录。

设置一个空的路径禁用图标库。

See also iconDatabasePath（）和clearIconDatabase（ ） 。

QWebSettings.setLocalStoragePath (self, QString path)

设置为HTML5的本地存储路径path。

有关HTML5的本地存储更多的信息，请参阅Web Storage standard。

支持本地存储可以通过设置启用LocalStorageEnabled属性。

此功能被引入Qt的4.6 。

See also localStoragePath（ ） 。

QWebSettings.setMaximumPagesInCache (int pages)

设置的最大页数，以保持在内存中页面缓存到pages。

页面缓存使得导航时提出，或返回到前进/后退历史记录页面，通过暂停和恢复到一个更好的用户体验pages。

有关该功能的更多信息，请参考：

http://webkit.org/blog/427/webkit-page-cache-i-the-basics/

See also maximumPagesInCache（ ） 。

QWebSettings.setObjectCacheCapacities (int cacheMinDeadCapacity, int cacheMaxDead, int totalCapacity)

指定容量的死对象，如样式表或脚本的内存缓存。

该cacheMinDeadCapacity指定minimum字节死对象应该消耗在缓存处于压力下的人数。

cacheMaxDead是maximum字节数是死对象要消耗当缓存not下压力。

totalCapacity指定maximum该高速缓存应该消耗的字节数overall。

高速缓存是默认启用的。调用setObjectCacheCapacities （ 0 ， 0 ， 0 ）将禁用缓存。用一个非零调用它再次启用它。

QWebSettings.setOfflineStorageDefaultQuota (int maximumSize)

设置默认配额的价值，新的离线存储数据库maximumSize。

此功能被引入Qt的4.5 。

See also offlineStorageDefaultQuota（ ） 。

QWebSettings.setOfflineStoragePath (QString path)

Sets path作为保存位置HTML5的客户端数据库存储数据。

path必须指向现有的目录。

设置一个空的路径禁用该功能。

支持客户端的数据库可以通过设置启用OfflineStorageDatabaseEnabled属性。

此功能被引入Qt的4.5 。

See also offlineStoragePath（ ） 。

QWebSettings.setOfflineWebApplicationCachePath (QString path)

设置为HTML5离线Web应用程序的缓存存储的路径path。

一个应用程序的缓存就像在某些意义上的HTTP缓存。对于使用通过JavaScript的应用程序缓存文件，装载机发动机将首先要求的内容的应用程序缓存，接触网络之前。

http://dev.w3.org/html5/spec/Overview.html ＃ appcache ：该功能在细节处描述

path必须指向现有的目录。

设置一个空的路径禁用该功能。

支持离线Web应用程序的缓存存储可以通过设置启用OfflineWebApplicationCacheEnabled属性。

此功能被引入Qt的4.6 。

See also offlineWebApplicationCachePath（ ） 。

QWebSettings.setOfflineWebApplicationCacheQuota (int maximumSize)

设置配额的离线网络应用程序缓存的值maximumSize。

此功能被引入Qt的4.6 。

See also offlineWebApplicationCacheQuota（ ） 。

QWebSettings.setUserStyleSheetUrl (self, QUrl location)

指定用户样式表的位置来加载与每个网页。

该location必须是在本地文件系统的路径，或使用UTF-8和Base64编码的数据，如数据的URL ：

“数据：文本/ CSS ;字符集= UTF -8;的base64 ， cCB7IGJhY2tncm91bmQtY29sb3I6IHJlZCB9Ow ==”

Note:如果base64的数据是无效的，该样式将不会被应用。

See also userStyleSheetUrl（ ） 。

QWebSettings.setWebGraphic (WebGraphic type, QPixmap graphic)

Sets graphic要绘制时QtWebKit需要借鉴的给定的图像type。

例如，当图像不能被加载，像素映像指定由MissingImageGraphic绘制代替。

See also webGraphic（ ） 。

bool QWebSettings.testAttribute (self, WebAttribute attr)

返回True如果attribute被启用，否则返回False 。

QUrl QWebSettings.userStyleSheetUrl (self)

[

返回用户样式表的位置。

]($docs-qurl.html)

See also setUserStyleSheetUrl（ ） 。

QPixmap QWebSettings.webGraphic (WebGraphic type)

[

返回用来绘制指定的图形置换预先设定的像素图type。

]($docs-qpixmap.html)

See also setWebGraphic（ ） 。