QWebEngineSettings 类
QWebEngineSettings 类提供了一个对象，用于存储由 QWebEnginePage 使用的设置。 更多信息...
| 头文件 | #include <QWebEngineSettings> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake | QT += webenginecore |
公共类型
| 枚举 | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont } |
| 枚举 | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
(自 Qt 5.11 开始) 枚举 | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| 枚举 | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, ForceDarkMode } |
公共函数
| QString | defaultTextEncoding() const |
| QString | fontFamily(QWebEngineSettings::FontFamily which) const |
| int | fontSize(QWebEngineSettings::FontSize type) const |
| void | resetAttribute(QWebEngineSettings::WebAttribute attribute) |
| void | resetFontFamily(QWebEngineSettings::FontFamily which) |
| void | resetFontSize(QWebEngineSettings::FontSize type) |
(自 Qt 5.11 开始) void | resetUnknownUrlSchemePolicy() |
| void | setAttribute(QWebEngineSettings::WebAttribute attribute, bool on) |
| void | setDefaultTextEncoding(const QString &encoding) |
| void | setFontSize(QWebEngineSettings::FontSize type, int size) |
(自 Qt 5.11 开始) void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy) |
| bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const |
(自 Qt 5.11 开始) QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const |
详细描述
QWebEngineSettings 允许配置浏览器属性，例如字体大小和家族，以及通用属性，例如 JavaScript 支持。使用 setAttribute() 函数设置各个属性。《WebAttribute》枚举进一步描述了每个属性。
每个QWebEnginePage对象都有一个自己的QWebEngineSettings对象，用于配置该页面的设置。如果未为Web引擎页面配置设置，则会查找页面所属配置文件中的设置。
另请参阅QWebEnginePage::settings() 和 QWebEngineView::settings()。
成员类型文档
枚举 QWebEngineSettings::FontFamily
此枚举描述了CSS 2定义的通用字体族。有关更多信息，请参阅CSS标准。
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::StandardFont | 0 | |
QWebEngineSettings::FixedFont | 1 | |
QWebEngineSettings::SerifFont | 2 | |
QWebEngineSettings::SansSerifFont | 3 | |
QWebEngineSettings::CursiveFont | 4 | |
QWebEngineSettings::FantasyFont | 5 | |
QWebEngineSettings::PictographFont | 6 | (自Qt 5.7添加，在Qt 6.4中已弃用) |
枚举 QWebEngineSettings::FontSize
此枚举描述了可以通过QWebEngineSettings配置的字体大小
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::MinimumFontSize | 0 | 硬最小字体大小。 |
QWebEngineSettings::MinimumLogicalFontSize | 1 | 当缩放时应用的最小逻辑字体大小。 |
QWebEngineSettings::DefaultFontSize | 2 | 常规文本的默认字体大小。 |
QWebEngineSettings::DefaultFixedFontSize | 3 | 固定间距文本的默认字体大小。 |
[自Qt 5.11起]枚举 QWebEngineSettings::UnknownUrlSchemePolicy
此枚举描述如何处理对具有未知方案的URL的导航请求。
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes | 1 | 不允许所有对具有未知方案的URL的导航请求。 |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction | 2 | 允许从用户交互（例如鼠标单击）发出的对具有未知方案的URL的导航请求，而其他导航请求（例如从JavaScript）被抑制。 |
QWebEngineSettings::AllowAllUnknownUrlSchemes | 3 | 允许所有对具有未知方案的URL的导航请求。 |
此枚举是在Qt 5.11中引入的。
另请参阅unknownUrlSchemePolicy、setUnknownUrlSchemePolicy 和 resetUnknownUrlSchemePolicy。
枚举 QWebEngineSettings::WebAttribute
此枚举类型指定网页设置
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::AutoLoadImages | 0 | 自动下载网页图像。当此设置禁用时，图像将从缓存加载。默认启用。 |
QWebEngineSettings::JavascriptEnabled | 1 | 启用在主世界中运行JavaScript程序。默认启用。 |
QWebEngineSettings::JavascriptCanOpenWindows | 2 | 允许JavaScript程序在无需用户交互的情况下打开弹出窗口。默认启用。 |
QWebEngineSettings::JavascriptCanAccessClipboard | 3 | 允许JavaScript程序从剪贴板读取和写入。如果用户具体请求，则始终允许写入剪贴板。有关也允许JavaScript从剪贴板粘贴内容的说明，请参阅JavascriptCanPaste。默认禁用。 |
QWebEngineSettings::LinksIncludedInFocusChain | 4 | 将超链接包括在键盘焦点链中。默认启用。 |
QWebEngineSettings::LocalStorageEnabled | 5 | 启用对HTML 5本地存储功能的支持。默认启用。 |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | 允许本地源文档访问通常会被阻止的远程资源。默认情况下已禁用。注意：以下 DnsPrefetchEnabled 设置与此设置独立运行，如果启用，可能导致从本地内容进行远程访问。 |
QWebEngineSettings::XSSAuditingEnabled | 7 | 已弃用且无效果。 |
QWebEngineSettings::SpatialNavigationEnabled | 8 | 启用空间导航功能，这意味着可以通过使用左右、上、下箭头键在网页上导航到可聚焦元素（如超链接和表单控件）。例如，如果用户按下右键，则通过启发式算法判断用户是否试图向右到达某个元素以及他们可能想要哪个元素。默认情况下已禁用。 |
QWebEngineSettings::LocalContentCanAccessFileUrls | 9 | 允许本地加载的文档访问其他本地URL。禁用此选项会使QtWebEngine的行为更类似于Chrome和Firefox的默认行为。默认情况下已启用。 |
QWebEngineSettings::HyperlinkAuditingEnabled | 10 | 启用对超链接ping属性的支持。默认情况下已禁用。 |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | 启用动画滚动。默认情况下已禁用。 |
QWebEngineSettings::ErrorPageEnabled | 12 | 启用显示Chromium的内置错误页面。默认情况下已启用。 |
QWebEngineSettings::PluginsEnabled | 13 | 启用支持Pepper插件，如Flash播放器。默认情况下已禁用。另请参阅Pepper插件API。（自Qt 5.6起添加） |
QWebEngineSettings::FullScreenSupportEnabled | 14 | 在应用程序中启用全屏支持。默认情况下已禁用。（自Qt 5.6起添加） |
QWebEngineSettings::ScreenCaptureEnabled | 15 | 在应用程序中启用屏幕捕获。默认情况下已禁用。（自Qt 5.7起添加） |
QWebEngineSettings::WebGLEnabled | 16 | 启用对HTML5 WebGL的支持。如果可用，则默认情况下已启用。（自Qt 5.7起添加） |
QWebEngineSettings::Accelerated2dCanvasEnabled | 17 | 指定HTML5 2D画布是否应为OpenGL帧缓冲区。这可以使许多绘图操作更快，但会减慢像素访问速度。如果可用，则默认情况下已启用。（自Qt 5.7起添加） |
QWebEngineSettings::AutoLoadIconsForPage | 18 | 自动下载网页的图标。默认情况下已启用。（自Qt 5.7起添加） |
QWebEngineSettings::TouchIconsEnabled | 19 | 启用对触摸图标和预组合触摸图标的支持。默认情况下已禁用。（自Qt 5.7起添加） |
QWebEngineSettings::FocusOnNavigationEnabled | 20 | 每当发生导航操作（加载、停止、重新加载、绕过缓存后重新加载、前进、后退、设置内容等）时，都会将焦点给予与页面关联的视图。默认情况下已禁用。（自Qt 5.8起添加） |
QWebEngineSettings::PrintElementBackgrounds | 21 | 在打印网页时启用打印CSS背景。默认情况下已启用。（自Qt 5.8起添加） |
QWebEngineSettings::AllowRunningInsecureContent | 22 | 默认情况下，HTTPS页面不能从HTTP URL运行JavaScript、CSS、插件或web-sockets。此选项提供了一种覆盖，以获得旧版的不安全行为。默认情况下已禁用。（自Qt 5.8起添加） |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins | 23 | 自Qt 5.7以来，只有HTTPS等安全源才能请求地理位置功能。此选项提供了一种覆盖，允许非安全源再次访问地理位置。默认情况下已禁用。（自Qt 5.9起添加） |
QWebEngineSettings::AllowWindowActivationFromJavaScript | 24 | 允许使用window.focus() JavaScript方法激活窗口。默认情况下已禁用。（自Qt 5.10起添加） |
QWebEngineSettings::ShowScrollBars | 25 | 显示滚动条。默认情况下已启用。（自Qt 5.10起添加） |
QWebEngineSettings::PlaybackRequiresUserGesture | 26 | 抑制媒体内容的播放，直到用户与页面交互。默认情况下，WebEngine使用Chromium设置，如自动播放策略更改中所述。这类似于Android设备上的Chrome的行为，而禁用此设置时的默认行为类似于桌面上的Chrome。要覆盖默认行为，请禁用此设置。（自Qt 5.11起添加） |
QWebEngineSettings::JavascriptCanPaste | 28 | 启用 JavaScript execCommand("paste")。这也需要启用 JavascriptCanAccessClipboard。默认禁用。(自 Qt 5.11 加入) |
QWebEngineSettings::WebRTCPublicInterfacesOnly | 27 | 将 WebRTC 限制为仅使用公网 IP 地址。当禁用时，WebRTC 也可能使用本地网络 IP 地址，但远程主机也可以看到您的本地网络 IP 地址。默认禁用。(自 Qt 5.11 加入) |
QWebEngineSettings::DnsPrefetchEnabled | 29 | 指定 WebEngine 是否尝试预先获取 DNS 记录以加快浏览速度。默认禁用。(自 Qt 5.12 加入) |
QWebEngineSettings::PdfViewerEnabled | 30 | 指定 PDF 文档将在内置 PDF 查看器中打开，而不是下载。默认启用。(自 Qt 5.13 加入) |
QWebEngineSettings::NavigateOnDropEnabled | 31 | 指定可以通过将 URL 拖放到视图中来触发导航。默认启用。(自 Qt 6.4 加入) |
QWebEngineSettings::ReadingFromCanvasEnabled | 32 | 指定启用从所有画布元素中读取。此设置将影响所有 HTML5 画布元素，无论其来源如何，并且可以禁用以防止画布指纹识别。默认启用。(自 Qt 6.6 加入) |
QWebEngineSettings::ForceDarkMode | 33 | 指定所有网页内容都将使用深色主题渲染。有关更多信息，请参阅 自动深色主题。默认禁用。(自 Qt 6.7 加入) |
成员函数文档
QString QWebEngineSettings::defaultTextEncoding() const
返回默认文本编码。
另请参阅 setDefaultTextEncoding。
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
返回指定的泛型字体族 which 的实际字体族。
int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const
返回在像素中指定 type 的默认字体大小。
另请参阅 setFontSize。
void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)
将 attribute 的设置重置为页面所属配置文件中指定的值。
void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)
将 which 指定的实际字体族重置为页面所属配置文件中指定的字体族。
void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)
将 type 的字体大小重置为页面所属配置文件中指定的大小。
[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()
移除处理未知方案的导航请求的策略。
此函数自 Qt 5.11 中引入。
另请参阅 unknownUrlSchemePolicy 和 setUnknownUrlSchemePolicy.
void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
根据on的值启用或禁用指定的attribute功能。
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
指定默认文本编码系统。
encoding的值必须是一个描述编码的字符串，例如"utf-8"或"iso-8859-1"。如果为空，将使用默认值。有关编码名称的更完整列表，请参阅QTextCodec。
另请参阅 defaultTextEncoding。
void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)
将type的字体大小设置为size像素。
另请参阅 fontSize。
[since Qt 5.11] void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
将处理未知方案URL导航请求的策略设置为policy。默认为QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction。
此函数自 Qt 5.11 中引入。
另请参阅 unknownUrlSchemePolicy 和 resetUnknownUrlSchemePolicy。
bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const
如果启用attribute，则返回true；否则返回false。
[since Qt 5.11] QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const
返回当前所选用于处理未知方案URL导航请求的策略。默认为QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction。
此函数自 Qt 5.11 中引入。
另请参阅 setUnknownUrlSchemePolicy 和 resetUnknownUrlSchemePolicy。
© 2024 The Qt Company Ltd. 本文档中的文档贡献是各自所有者的版权。本文档提供的内容是根据Free Software Foundation发布的GNU自由文档许可证版本1.3的条款进行许可的。Qt和相应的标志是The Qt Company Ltd.在芬兰及其他全球国家的商标。所有其他商标均为其各自所有者的财产。
