QWebEngineSettings 類提供對象以存儲設置，用於 QWebEnginePage . 更多...
| 頭： | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| Since: | Qt 5.4 |
該類在 Qt 5.4 引入。
| enum | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont } |
| enum | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| enum | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| enum | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, PdfViewerEnabled } |
| 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 ) |
| void | resetUnknownUrlSchemePolicy () |
| void | setAttribute (QWebEngineSettings::WebAttribute attribute , bool on ) |
| void | setDefaultTextEncoding (const QString & encoding ) |
| void | setFontFamily (QWebEngineSettings::FontFamily which , const QString & family ) |
| void | setFontSize (QWebEngineSettings::FontSize type , int size ) |
| void | setUnknownUrlSchemePolicy (QWebEngineSettings::UnknownUrlSchemePolicy policy ) |
| bool | testAttribute (QWebEngineSettings::WebAttribute attribute ) const |
| QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy () const |
| QWebEngineSettings * | defaultSettings () |
QWebEngineSettings 允許配置瀏覽器特性，譬如字體大小和係列、自定義樣式錶的位置及一般屬性 (譬如 JavaScript 支持)。單個屬性的設置使用 setAttribute () 函數。 WebAttribute 枚舉進一步描述各屬性。
每個 QWebEnginePage 對象有它自己的 qwebengineessettings 對象 (為該頁麵配置設置)。若尚未為 Web 引擎頁麵配置設置，將在頁麵所屬 Profile (配置文件) 設置中查找它。
另請參閱 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
|
用於固定間距文本的默認字體大小。 |
此枚舉描述如何處理具有未知方案的 URL 導航請求。
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes
|
1
|
禁止所有具有未知方案的 URL 導航請求。 |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction
|
2
|
Allows navigation requests to URLs with unknown schemes that are issued from user-interaction (like a mouse-click), whereas other navigation requests (for example from JavaScript) are suppressed. |
QWebEngineSettings::AllowAllUnknownUrlSchemes
|
3
|
Allows all navigation requests to URLs with unknown schemes. |
該枚舉在 Qt 5.11 引入 (或被修改)。
另請參閱 unknownUrlSchemePolicy , setUnknownUrlSchemePolicy ，和 resetUnknownUrlSchemePolicy .
此枚舉類型指定網頁設置：
| 常量 | 值 | 描述 |
|---|---|---|
QWebEngineSettings::AutoLoadImages
|
0
|
自動下載網頁圖像。當禁用此設置時，將從緩存加載圖像。默認啓用。 |
QWebEngineSettings::JavascriptEnabled
|
1
|
使 JavaScript 程序能夠運行在 MainWorld 。默認啓用。 |
QWebEngineSettings::JavascriptCanOpenWindows
|
2
|
允許 JavaScript 程序打開彈齣窗口 (無需用戶交互)。默認啓用。 |
QWebEngineSettings::JavascriptCanAccessClipboard
|
3
|
允許 JavaScript 程序讀取自和寫入到剪貼闆。寫入到剪貼闆始終允許，若用戶有具體請求。見 JavascriptCanPaste 還允許從 JavaScript 粘貼剪貼闆內容。默認禁用。 |
QWebEngineSettings::LinksIncludedInFocusChain
|
4
|
包括鍵盤聚焦鏈中的超鏈接。默認啓用。 |
QWebEngineSettings::LocalStorageEnabled
|
5
|
啓用支持 HTML 5 本地存儲特徵。默認啓用。 |
QWebEngineSettings::LocalContentCanAccessRemoteUrls
|
6
|
Allows locally loaded documents to ignore cross-origin rules so that they can access remote resources that would normally be blocked, since remote resources are considered cross-origin for a local document. Remote access that would not be blocked by cross-origin rules is still possible when this setting is disabled (default). Note that disabling this setting does not prevent media elements in local files from accessing remote content. Disabled by default. |
QWebEngineSettings::XSSAuditingEnabled
|
7
|
過時且不起作用。 |
QWebEngineSettings::SpatialNavigationEnabled
|
8
|
啓用空間導航特徵，這意味著能夠通過使用左、右、上、下箭頭鍵在網頁可聚焦元素 (譬如：超鏈接和錶單控件) 之間導航。例如，若用戶按下右箭頭鍵，試探確定是否試著朝右有可能到達的元素，及它們可能想要到達哪個元素。默認禁用。 |
QWebEngineSettings::LocalContentCanAccessFileUrls
|
9
|
Allows locally loaded documents to access other local URLs. Disabling this makes QtWebEngine behave more like Chrome and Firefox does by default. Enabled by default. |
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
|
將聚焦賦予頁麵關聯的視圖，每當發生導航操作時 (加載、停止、重新加載、重新加載和繞過緩存、前進、後退、設置內容、等)。默認禁用 (在 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 添加)。 |
QWebEngineSettings::AllowWindowActivationFromJavaScript
|
24
|
允許通過使用 window.focus() JavaScript 方法激活窗口。默認禁用 (在 Qt 5.10 添加)。 |
QWebEngineSettings::ShowScrollBars
|
25
|
展示滾動條。默認啓用 (在 Qt 5.10 添加)。 |
QWebEngineSettings::PlaybackRequiresUserGesture
|
26
|
禁止媒體內容迴放，直到用戶與頁麵交互。默認情況下， WebEngine 使用 Chromium 設置，作為描述在 自動播放策略變化 。這與 Chrome 在 Android 中的行為類似，而禁用它時的默認行為與桌麵 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 添加)。 |
[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 attribute 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.
Removes the policy for handling navigation requests to URLs with unknown schemes.
該函數在 Qt 5.11 引入。
另請參閱 unknownUrlSchemePolicy and setUnknownUrlSchemePolicy .
啓用或禁用指定 attribute 特徵從屬值對於 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 ().
將未知方案 URL 的導航請求處理策略設為 policy 。默認為 QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction .
該函數在 Qt 5.11 引入。
另請參閱 unknownUrlSchemePolicy and resetUnknownUrlSchemePolicy .
返迴
true
if
attribute
被啓用；否則返迴
false
.
Returns the currently selected policy for handling navigation requests to URLs with unknown schemes. Default is QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction .
該函數在 Qt 5.11 引入。
另請參閱 setUnknownUrlSchemePolicy and resetUnknownUrlSchemePolicy .