The QWebEngineSettings 类提供对象以存储设置,用于 QWebEnginePage . 更多...
头: | #include <QWebEngineSettings> |
qmake: | QT += webenginewidgets |
Since: | Qt 5.4 |
enum | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, ..., PictographFont } |
enum | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
enum | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, ..., AllowGeolocationOnInsecureOrigins } |
QString | defaultTextEncoding () const |
QString | fontFamily (FontFamily which ) const |
int | fontSize (FontSize type ) const |
void | resetAttribute (WebAttribute 属性 ) |
void | resetFontFamily (FontFamily which ) |
void | resetFontSize (FontSize type ) |
void | setAttribute (WebAttribute 属性 , bool on ) |
void | setDefaultTextEncoding (const QString & encoding ) |
void | setFontFamily (FontFamily which , const QString & family ) |
void | setFontSize (FontSize type , int size ) |
bool | testAttribute (WebAttribute 属性 ) const |
QWebEngineSettings * | defaultSettings () |
The QWebEngineSettings 类提供对象以存储设置,用于 QWebEnginePage .
QWebEngineSettings allows configuration of browser properties, such as font sizes and families, the location of a custom style sheet, and generic attributes, such as JavaScript support. Individual attributes are set using the setAttribute () 函数。 WebAttribute 枚举进一步描述各属性。
每个 QWebEnginePage object has its own QWebEngineSettings object, which configures the settings for that page. If a setting is not configured for a web engine page, it is looked up in the settings of the profile the page belongs to.
另请参阅 QWebEnginePage::settings () 和 QWebEngineView::settings ().
此枚举描述由 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 添加) |
此枚举描述字体大小, 可配置透过 QWebEngineSettings :
常量 | 值 | 描述 |
---|---|---|
QWebEngineSettings::MinimumFontSize
|
0
|
硬最小字体大小。 |
QWebEngineSettings::MinimumLogicalFontSize
|
1
|
当缩小时应用的最小逻辑字体大小。 |
QWebEngineSettings::DefaultFontSize
|
2
|
用于常规文本的默认字体大小。 |
QWebEngineSettings::DefaultFixedFontSize
|
3
|
用于固定间距文本的默认字体大小。 |
此枚举类型指定网页设置:
常量 | 值 | 描述 |
---|---|---|
QWebEngineSettings::AutoLoadImages
|
0
|
自动下载网页图像。当禁用此设置时,将从缓存加载图像。默认启用。 |
QWebEngineSettings::JavascriptEnabled
|
1
|
Enables the running of JavaScript programs. Enabled by default. |
QWebEngineSettings::JavascriptCanOpenWindows
|
2
|
允许 JavaScript 程序打开弹出窗口 (无需用户交互)。默认启用。 |
QWebEngineSettings::JavascriptCanAccessClipboard
|
3
|
Allows JavaScript programs to read from and write to the clipboard. Writing to the clipboard is always allowed if it is specifically requested by the user. Disabled by default. |
QWebEngineSettings::LinksIncludedInFocusChain
|
4
|
包括键盘聚焦链中的超链接。默认启用。 |
QWebEngineSettings::LocalStorageEnabled
|
5
|
启用支持 HTML 5 本地存储特征。默认启用。 |
QWebEngineSettings::LocalContentCanAccessRemoteUrls
|
6
|
允许本地加载文档忽略跨源规则,以便它们通常可以访问被阻塞的远程资源,因为所有远程资源都被认为是跨源的对于本地文件。不被跨源规则阻塞的远程访问仍是可能的,当此设置被禁用时 (默认)。注意,禁用此设置不会停止 XMLHttpRequest 或本地文件中的媒体元素访问远程内容。基本上,仅停止一些 HTML 子资源 (譬如:脚本),因此禁用此设置不是安全机制。 |
QWebEngineSettings::XSSAuditingEnabled
|
7
|
Monitors load requests for cross-site scripting attempts. Suspicious scripts are blocked and reported in the inspector's JavaScript console. Disabled by default, because it might negatively affect performance. |
QWebEngineSettings::SpatialNavigationEnabled
|
8
|
启用空间导航特征,这意味着能够通过使用左、右、上、下箭头键在网页可聚焦元素 (譬如:超链接和表单控件) 之间导航。例如,若用户按下右箭头键,试探确定是否试着朝右有可能到达的元素,及它们可能想要到达哪个元素。默认禁用。 |
QWebEngineSettings::LocalContentCanAccessFileUrls
|
9
|
允许本地加载文档访问其它本地 URL。默认启用。 |
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
|
启用支持 HTML 5 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
|
Gives focus to the view associated with the page, whenever a navigation operation occurs (load, stop, reload, reload and bypass cache, forward, backward, set content, and so on). Enabled by default. (Added in Qt 5.8) |
QWebEngineSettings::PrintElementBackgrounds
|
21
|
打开 CSS 背景的打印,当打印网页时。默认启用 (在 Qt 5.8 添加)。 |
QWebEngineSettings::AllowRunningInsecureContent
|
22
|
默认情况下,HTTPS 页面无法从 HTTP URL 运行 JavaScript、CSS、插件或 Web 套接字。这提供覆写以获得旧的不安全行为。默认禁用 (在 Qt 5.8 添加)。 |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins
|
23
|
从 Qt 5.7 起,仅安全源 (譬如 HTTPS) 能够请求地理位置特征。这提供覆写以允许非安全源能再次访问地理位置。默认禁用 (在 Qt 5.9 添加)。 |
[static]
QWebEngineSettings
*QWebEngineSettings::
defaultSettings
()
Returns the settings for a web engine page that belongs to the default profile. All web pages not specifically created with another profile belong to the default profile.
返回默认文本编码。
另请参阅 setDefaultTextEncoding ().
Returns the actual font family for the specified generic font family, which .
另请参阅 setFontFamily ().
返回默认字体大小对于 type (以像素为单位)。
另请参阅 setFontSize ().
Resets the setting of 属性 to the value specified in the profile that the page belongs to.
Resets the actual font family specified by which to the one specified in the profile that the page belongs to.
Resets the font size for type to the size specified in the profile that the page belongs to.
启用或禁用指定 属性 特征从属值对于 on .
指定默认文本编码系统。
值 encoding must be a string describing an encoding such as "utf-8" or "iso-8859-1". If left empty, a default value will be used. For a more extensive list of encoding names see QTextCodec .
另请参阅 defaultTextEncoding ().
将实际字体系列设为 family 为指定一般系列, which .
另请参阅 fontFamily ().
设置字体大小对于 type to size (以像素为单位)。
另请参阅 fontSize ().
返回
true
if
属性
被启用;否则返回
false
.