class QWebEngineSettings#

QWebEngineSettings 类提供了一个存储用于 QWebEnginePage 的设置的的 “对象”。了解更多信息...

概述#

方法#

注意

本文档可能包含从C++自动转换为Python的代码片段。我们始终欢迎对代码片段进行翻译的贡献。如果您发现翻译存在问题，您也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建票据的方式来告诉我们。

详细描述#

QWebEngineSettings 允许配置浏览器属性，例如字体大小和种类，以及通用属性，如JavaScript支持。单个属性通过使用 setAttribute() 函数进行设置。枚举类型 WebAttribute 进一步描述了每个属性。

每个 QWebEnginePage 对象都有自己对应的 QWebEngineSettings 对象，配置该页面的设置。如果针对Web引擎页面的某个设置未被配置，则将在属于该页面的配置文件中查找。

相关内容

settings() settings()

class FontFamily#

该枚举描述了CSS 2中定义的通用字体家族。更多信息请参阅 CSS标准 。

常量

描述

QWebEngineSettings.StandardFont

QWebEngineSettings.FreeFont

QWebEngineSettings.SerifFont

QWebEngineSettings.SansSerifFont

QWebEngineSettings.CursiveFont

QWebEngineSettings.FantasyFont

QWebEngineSettings.PictographFont

(在Qt 5.7中添加，Qt 6.4中已弃用)
class WebAttribute#

此枚举类型指定网页的设置

常量

描述

QWebEngineSettings.AutoLoadImages

自动为网页下载图片。当此设置被禁用时，图片将从此缓存中加载。默认启用。

QWebEngineSettings.JavascriptEnabled

在 MainWorld 中启用JavaScript程序的执行。默认启用。

QWebEngineSettings.JavascriptCanOpenWindows

允许JavaScript程序在没有用户交互的情况下打开弹出窗口。默认启用。

QWebEngineSettings.JavascriptCanAccessClipboard

允许JavaScript程序从剪切板读取和写入。如果用户明确提出要求，则始终允许写入剪切板。有关更多信息，请参见 JavascriptCanPaste，也允许从JavaScript中粘贴剪切板内容。默认禁用。

QWebEngineSettings.LinksIncludedInFocusChain

将超链接包括在键盘焦点链中。默认启用。

QWebEngineSettings.LocalStorageEnabled

启用支持HTML 5本地存储功能。默认启用。

QWebEngineSettings.LocalContentCanAccessRemoteUrls

允许本地源文档访问通常被阻止的远程资源。默认禁用。注意以下DnsPrefetchEnabled操作独立于此设置，如果启用，可能会引起从本地内容发出远程访问。

QWebEngineSettings.XSSAuditingEnabled

已弃用，无效果。

QWebEngineSettings.SpatialNavigationEnabled

启用空间导航功能，这意味着可以通过使用上、下、左、右箭头键在网页上导航到可聚焦元素，比如超链接和表单控件。例如，如果用户按下右键，则会获取他们可能尝试向右访问的元素以及他们可能想要访问的元素。默认禁用。

QWebEngineSettings.LocalContentCanAccessFileUrls

允许本地加载的文档访问其他本地URL。禁用此选项将使QtWebEngine的行为与Chrome和Firefox默认行为更相似。默认启用。

QWebEngineSettings.HyperlinkAuditingEnabled

启用对超链接的ping属性的支持。默认禁用。

QWebEngineSettings.ScrollAnimatorEnabled

启用动画滚动。默认禁用。

QWebEngineSettings.ErrorPageEnabled

启用显示Chromium的内置错误页面。默认启用。

QWebEngineSettings.PluginsEnabled

启用对Pepper插件的支持，如Flash播放器。默认禁用。另见Pepper插件API。 (自Qt 5.6添加)

QWebEngineSettings.FullScreenSupportEnabled

启用应用程序的全屏支持。默认禁用。 (自Qt 5.6添加)

QWebEngineSettings.ScreenCaptureEnabled

启用应用程序中的屏幕捕获。默认禁用。 (自Qt 5.7添加)

QWebEngineSettings.WebGLEnabled

启用对HTML 5 WebGL的支持。如果有可用，默认启用。 (自Qt 5.7添加)

QWebEngineSettings.Accelerated2dCanvasEnabled

指定HTML5 2D画布是否为OpenGL帧缓冲区。这会使许多绘画操作更快，但会减慢像素访问。如果有可用的，默认启用。 (自Qt 5.7添加)

QWebEngineSettings.AutoLoadIconsForPage

自动下载网页图标。默认启用。 (自Qt 5.7添加)

QWebEngineSettings.TouchIconsEnabled

启用对触摸图标和预组合触摸图标的支持。默认禁用。 (自Qt 5.7添加)

QWebEngineSettings.FocusOnNavigationEnabled

每当发生导航操作（加载、停止、重新加载、继续加载并绕过缓存、向前、向后、设置内容等）时，都会将焦点给予与页面关联的视图。默认禁用。 (自Qt 5.8添加)

QWebEngineSettings.PrintElementBackgrounds

在打印网页时开启打印CSS背景。默认启用。 (自Qt 5.8添加)

QWebEngineSettings.AllowRunningInsecureContent

默认情况下，HTTPS页面无法从HTTP URL运行JavaScript、CSS、插件或web-sockets。这提供了覆盖以获取旧的不安全行为。默认禁用。 (自Qt 5.8添加)

QWebEngineSettings.AllowGeolocationOnInsecureOrigins

自Qt 5.7以来，只有类似于HTTPS的安全源能够请求位置功能。这提供了覆盖以允许非安全源再次访问位置。默认禁用。 (自Qt 5.9添加)

QWebEngineSettings.AllowWindowActivationFromJavaScript

允许使用window.focus() JavaScript方法来激活窗口。默认禁用。 (自Qt 5.10添加)

QWebEngineSettings.ShowScrollBars

显示滚动条。默认启用。 (自Qt 5.10添加)

QWebEngineSettings.PlaybackRequiresUserGesture

禁止在没有用户与页面交互之前播放媒体内容。默认情况下，WebEngine使用Chromium设置，如自动播放策略更改所述。这与Android上的Chrome行为相似，而禁用时默认行为与桌面上的Chrome相似。要覆盖默认行为，请禁用此设置。（自Qt 5.11添加）

QWebEngineSettings.JavascriptCanPaste

启用JavaScript execCommand("paste")。这还需要启用JavascriptCanAccessClipboard。默认情况下禁用。（自Qt 5.11添加）

QWebEngineSettings.WebRTCPublicInterfacesOnly

将WebRTC限制为仅使用公网IP地址。当禁用时，WebRTC也可能使用本地网络IP地址，但远程主机也能看到您的本地网络IP地址。默认情况下禁用。（自Qt 5.11添加）

QWebEngineSettings.DnsPrefetchEnabled

指定WebEngine是否尝试预取DNS条目以加快浏览速度。默认情况下禁用。（自Qt 5.12添加）

QWebEngineSettings.PdfViewerEnabled

指定PDF文档将在内部PDF查看器中打开而不是下载。默认启用。（自Qt 5.13添加）

QWebEngineSettings.NavigateOnDropEnabled

指定可以由在视图中拖放URL来触发导航。默认启用。（自Qt 6.4添加）

QWebEngineSettings.ReadingFromCanvasEnabled

指定是否启用从所有画布元素中读取。此设置将对所有HTML5画布元素产生影响，而不管来源如何，并且可以禁用以防止画布指纹。（自Qt 6.6添加）

QWebEngineSettings.ForceDarkMode

指定所有网页内容都将使用暗色主题。有关更多信息，请参见自动暗色主题。默认情况下禁用。（自Qt 6.7添加）
class FontSize#

此枚举描述了通过QWebEngineSettings可配置的字体大小。

常量

描述

QWebEngineSettings.MinimumFontSize

硬最小字体大小。

QWebEngineSettings.MinimumLogicalFontSize

在缩放时应用的最小逻辑字体大小。

QWebEngineSettings.DefaultFontSize

常规文本的默认字体大小。

QWebEngineSettings.DefaultFixedFontSize

等宽文本的默认字体大小。
class UnknownUrlSchemePolicy#

此枚举描述了如何处理对未知方案的URL的导航请求。

常量

描述

QWebEngineSettings.DisallowUnknownUrlSchemes

拒绝所有对未知方案的URL的导航请求。

QWebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction

允许从用户交互（如鼠标点击）发出的对未知方案的URL的导航请求，而其他导航请求（例如来自JavaScript）则被抑制。

QWebEngineSettings.AllowAllUnknownUrlSchemes

允许所有对未知方案的URL的导航请求。

相关内容

unknownUrlSchemePolicy setUnknownUrlSchemePolicy resetUnknownUrlSchemePolicy

defaultTextEncoding()#
返回类型：

str

返回默认文本编码。

fontFamily(which)#
参数：

which – FontFamily

返回类型：

str

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

fontSize(type)#
参数：

type – FontSize

返回类型：

int

以像素为单位返回 type 的默认字体大小。

相关内容

setFontSize()

resetAttribute(attr)#
参数：

attr – WebAttribute

将 attribute 的设置重置为页面所属配置文件中指定的值。

resetFontFamily(which)#
参数：

which – FontFamily

将 which 指定的实际字体族重置为页面所属配置文件中指定的字体族。

resetFontSize(type)#
参数：

type – FontSize

将 type 的字体大小重置为页面所属配置文件中指定的字体大小。

resetUnknownUrlSchemePolicy()#

移除处理未知方案的 URL 导航请求的策略。

setAttribute(attr, on)#
参数：

根据on的值启用或禁用指定的attribute特性。

setDefaultTextEncoding(encoding)#
参数：

encoding – 字符串

指定默认文本编码系统。

编码encoding的值必须是一个描述编码的字符串，例如“utf-8”或“iso-8859-1”。如果留空，则使用默认值。有关更详细的编码名称列表，请参阅QTextCodec。

相关内容

defaultTextEncoding()

setFontFamily(which, family)#
参数：
setFontSize(type, size)#
参数：

以像素为单位设置type的类型字体大小为size。

相关内容

fontSize()

setUnknownUrlSchemePolicy(policy)#
参数：

policy – UnknownUrlSchemePolicy

将处理未知方案的URL导航请求的策略设置为policy。默认为AllowUnknownUrlSchemesFromUserInteraction。

testAttribute(attr)#
参数：

attr – WebAttribute

返回类型：

布尔型

如果attribute被启用，则返回true；否则返回false。

unknownUrlSchemePolicy()#
返回类型：

UnknownUrlSchemePolicy

返回处理未知方案URL导航请求的当前策略。默认是AllowUnknownUrlSchemesFromUserInteraction。