WebEngineSettings QML 类型

允许配置浏览器属性和属性。更多...

导入语句	import QtWebEngine
自	QtWebEngine 1.1

包括继承成员在内的所有成员列表

属性

accelerated2dCanvasEnabled : bool (自 QtWebEngine 1.3)
allowGeolocationOnInsecureOrigins : bool (自 QtWebEngine 1.5)
allowRunningInsecureContent : bool (自 QtWebEngine 1.4)
allowWindowActivationFromJavaScript : bool (自 QtWebEngine 1.6)
autoLoadIconsForPage : bool (自 QtWebEngine 1.3)
autoLoadImages : bool
defaultTextEncoding : string (自 QtWebEngine 1.2)
dnsPrefetchEnabled : bool (自 QtWebEngine 1.8)
errorPageEnabled : bool
focusOnNavigationEnabled : bool (自 QtWebEngine 1.4)
forceDarkMode : bool (自 QtWebEngine 6.7)
fullscreenSupportEnabled : bool (自 QtWebEngine 1.2)
hyperlinkAuditingEnabled : bool
javascriptCanAccessClipboard : bool
javascriptCanOpenWindows : bool
javascriptCanPaste : bool (自 QtWebEngine 1.7)
javascriptEnabled : bool
linksIncludedInFocusChain : bool
localContentCanAccessFileUrls : bool
localContentCanAccessRemoteUrls : bool
localStorageEnabled : bool
navigateOnDropEnabled : bool (自 QtWebEngine 6.4)
pdfViewerEnabled : bool (自 QtWebEngine 1.9)
playbackRequiresUserGesture : bool (自 QtWebEngine 1.7)
pluginsEnabled : bool
printElementBackgrounds : bool (自 QtWebEngine 1.4)
readingFromCanvasEnabled : bool (自 QtWebEngine 6.6)
screenCaptureEnabled : bool (自 QtWebEngine 1.3)
showScrollBars : bool (自 QtWebEngine 1.6)
spatialNavigationEnabled : bool
touchIconsEnabled : bool (自 QtWebEngine 1.3)
unknownUrlSchemePolicy : 枚举 (自 QtWebEngine 1.7)
webGLEnabled : bool (自 QtWebEngine 1.3)
webRTCPublicInterfacesOnly : bool (自 QtWebEngine 1.7)

详细介绍

WebEngineSettings 类型可用于配置浏览器属性和通用属性，例如 JavaScript 支持、焦点行为和对远程内容的访问。此类型无法创建，但可以使用 WebEngine.settings 属性访问所有 Web 引擎视图的默认设置。

每个 Web 引擎视图都可以有单独的设置，可以使用 WebEngineView.settings 属性访问。

属性说明

accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]

指定 HTML 5 2D canvas 是否应该是 OpenGL 帧缓冲区。这使得许多绘画操作更快，但会减慢像素访问。

默认情况下启用，如果可用。

此属性自 QtWebEngine 1.3 以来已引入。

allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]

自 Qt 5.7 以来，只有安全源（如 HTTPS）能够请求地理位置功能。这提供了一种覆盖机制，允许非安全源再次访问地理位置。

默认情况下禁用。

此属性自 QtWebEngine 1.5 以来已引入。

allowRunningInsecureContent : bool [since QtWebEngine 1.4]

默认情况下，HTTPS 页面不能从 HTTP URL 运行 JavaScript、CSS、插件或 web-sockets。这曾经是可能的，并且此选项提供了一种覆盖机制以获取旧的行为。

默认情况下禁用。

此属性自 QtWebEngine 1.4 以来已引入。

allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]

允许 JavaScript 中的 window.focus() 方法。默认情况下不允许。

此属性自 QtWebEngine 1.6 以来已引入。

autoLoadIconsForPage : bool [since QtWebEngine 1.3]

自动下载网页图标。

默认情况下启用。

此属性自 QtWebEngine 1.3 以来已引入。

autoLoadImages : bool

自动加载网页中的图像。

默认情况下启用。

默认文本编码 : 字符串 [自 QtWebEngine 1.2 开始]

设置默认编码。值必须是描述编码的字符串，如 "utf-8" 或 "iso-8859-1"。

如果为空，将使用默认值。

该属性自 QtWebEngine 1.2 开始引入。

dnsPrefetchEnabled : 布尔值 [自 QtWebEngine 1.8 开始]

在激活之前，启用对 HTML 链接 DNS 记录的 speculation 预取。

默认情况下禁用。

该属性自 QtWebEngine 1.8 开始引入。

errorPageEnabled : 布尔值

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

默认情况下启用。

focusOnNavigationEnabled : 布尔值 [自 QtWebEngine 1.4 开始]

每当发生导航操作时（加载、停止、重新加载、重新加载并绕过缓存、前进、后退、设置内容等），都将给予视图焦点。

默认情况下禁用。

此属性自 QtWebEngine 1.4 以来已引入。

forceDarkMode : 布尔值 [自 QtWebEngine 6.7 开始]

自动使用深色主题渲染所有网络内容。

默认情况下禁用。

该属性自 QtWebEngine 6.7 开始引入。

fullscreenSupportEnabled : 布尔值 [自 QtWebEngine 1.2 开始]

告诉 Web 引擎此应用程序是否支持全屏。

默认情况下禁用。

该属性自 QtWebEngine 1.2 开始引入。

hyperlinkAuditingEnabled : 布尔值

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

默认情况下禁用。

javascriptCanAccessClipboard : 布尔值

允许 JavaScript 程序从剪切板读取或写入。如果用户明确请求，则始终允许写入剪切板。

要启用也从 JavaScript 粘贴剪切板内容，请使用 javascriptCanPaste。

默认情况下禁用。

javascriptCanOpenWindows : 布尔值

允许 JavaScript 程序在无需用户交互的情况下打开弹出窗口。

默认情况下启用。

javascriptCanPaste : 布尔值 [自 QtWebEngine 1.7 开始]

启用 JavaScript execCommand("paste")。这也需要启用 javascriptCanAccessClipboard。

默认情况下禁用。

该属性自 QtWebEngine 1.7 开始引入。

javascriptEnabled : 布尔值

启用 JavaScript 程序的运行。

默认情况下启用。

linksIncludedInFocusChain : 布尔值

将超链接包含在键盘焦点链中。

默认情况下启用。

localContentCanAccessFileUrls : 布尔值

允许本地加载的文档访问其他本地 URL。

默认情况下启用。

localContentCanAccessRemoteUrls : 布尔值

允许本地加载的文档访问远程 URL。

默认情况下禁用。

localStorageEnabled : 布尔值

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

默认情况下启用。

navigateOnDropEnabled : 布尔值 [自 QtWebEngine 6.4 开始]

指定可以由在视图中拖放 URL 触发导航。

默认情况下启用。

该属性自 QtWebEngine 6.4 开始引入。

pdfViewerEnabled : bool [since QtWebEngine 1.9]

指定PDF文档将在内部PDF查看器中打开，而不是下载。

默认情况下启用。

此属性是在QtWebEngine 1.9中引入的。

playbackRequiresUserGesture : bool [since QtWebEngine 1.7]

阻止在用户与页面交互之前播放媒体内容。

默认情况下，Qt WebEngine 使用Chromium设置，如自动播放策略更改中所述。要覆盖默认行为，必须将此属性设置为 false。

注意：启用时的行为类似于Android上的Chrome，禁用时类似于桌面上的Chrome。

该属性自 QtWebEngine 1.7 开始引入。

pluginsEnabled : bool

启用对Pepper插件的支撑，例如Flash播放器。

默认情况下禁用。

另请参阅：Pepper插件API。

printElementBackgrounds : bool [since QtWebEngine 1.4]

在打印网页时打开打印CSS背景。

默认情况下启用。

此属性自 QtWebEngine 1.4 以来已引入。

readingFromCanvasEnabled : bool [since QtWebEngine 6.6]

指定启用从所有画布元素中读取。

此设置将对所有HTML5画布元素产生影响，无论其来源，并且可以禁用以防止画布指纹。

默认情况下启用。

此属性是在QtWebEngine 6.6中引入的。

screenCaptureEnabled : bool [since QtWebEngine 1.3]

告知Web引擎此应用是否支持屏幕捕获。

默认情况下禁用。

此属性自 QtWebEngine 1.3 以来已引入。

showScrollBars : bool [since QtWebEngine 1.6]

显示滚动条。默认启用。

此属性自 QtWebEngine 1.6 以来已引入。

spatialNavigationEnabled : bool

启用空间导航功能，即通过使用左右上下箭头键在网页上导航到可聚焦元素（例如超链接和表单控件）的能力。

例如，如果用户按下右键，则根据启发式算法确定用户可能要尝试到达的元素以及他们可能想要到达的元素。

默认情况下禁用。

touchIconsEnabled : bool [since QtWebEngine 1.3]

启用对触摸图标和预组触摸图标的支撑。

默认情况下禁用。

此属性自 QtWebEngine 1.3 以来已引入。

unknownUrlSchemePolicy : 枚举 [since QtWebEngine 1.7]

指定如何处理对未知方案的URL的导航请求。

常量	描述
`WebEngineSettings.DisallowUnknownUrlSchemes`	禁止所有对未知方案的URL的导航请求。
`WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction`	允许来自用户交互（如鼠标点击）的未知方案的URL导航请求，而其他导航请求（例如来自JavaScript）被抑制。
`WebEngineSettings.AllowAllUnknownUrlSchemes`	允许所有对未知方案的URL的导航请求。

默认值为 WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction。

该属性自 QtWebEngine 1.7 开始引入。

webGLEnabled : bool [since QtWebEngine 1.3]

启用对HTML 5 WebGL的支撑。

默认情况下启用，如果可用。

此属性自 QtWebEngine 1.3 以来已引入。

webRTCPublicInterfacesOnly : bool [自QtWebEngine 1.7开始]

限制WebRTC只使用公网IP地址。当禁用时，WebRTC可能会也使用本地网络IP地址，但远程主机也可以看到您的本地网络IP地址。

默认情况下禁用。

该属性自 QtWebEngine 1.7 开始引入。