QWebEngineSettings露

PyQt5.QtWebEngineWidgets.QWebEngineSettings

Description露

The QWebEngineSettings class provides an object to store the settings used by 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() function. The WebAttribute enum further describes each attribute.

Each 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.

Enums露

FontFamily

This enum describes the generic font families defined by CSS 2. For more information see the CSS standard.

Member	Value	Description
CursiveFont	TODO	TODO
FantasyFont	TODO	TODO
FixedFont	TODO	TODO
PictographFont	6	(added in Qt 5.7)
SansSerifFont	TODO	TODO
SerifFont	TODO	TODO
StandardFont	TODO	TODO

FontSize

This enum describes the font sizes configurable through QWebEngineSettings:

Member	Value	Description
DefaultFixedFontSize	3	The default font size for fixed-pitch text.
DefaultFontSize	2	The default font size for regular text.
MinimumFontSize	0	The hard minimum font size.
MinimumLogicalFontSize	1	The minimum logical font size that is applied when zooming out.

UnknownUrlSchemePolicy

This enum describes how navigation requests to URLs with unknown schemes are handled.

Member	Value	Description
AllowAllUnknownUrlSchemes	3	Allows all navigation requests to URLs with unknown schemes.
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.
DisallowUnknownUrlSchemes	1	Disallows all navigation requests to URLs with unknown schemes.

WebAttribute

This enum type specifies settings for web pages:

Member	Value	Description
Accelerated2dCanvasEnabled	17	Specifies whether the HTML5 2D canvas should be a OpenGL framebuffer. This makes many painting operations faster, but slows down pixel access. Enabled by default if available. (Added in Qt 5.7)
AllowGeolocationOnInsecureOrigins	23	Since Qt 5.7, only secure origins such as HTTPS have been able to request Geolocation features. This provides an override to allow non secure origins to access Geolocation again. Disabled by default. (Added in Qt 5.9)
AllowRunningInsecureContent	22	By default, HTTPS pages cannot run JavaScript, CSS, plugins or web-sockets from HTTP URLs. This provides an override to get the old insecure behavior. Disabled by default. (Added in Qt 5.8)
AllowWindowActivationFromJavaScript	24	Allows activating windows by using the window.focus() JavaScript method. Disabled by default. (Added in Qt 5.10)
AutoLoadIconsForPage	18	Automatically downloads icons for web pages. Enabled by default. (Added in Qt 5.7)
AutoLoadImages	0	Automatically dowloads images for web pages. When this setting is disabled, images are loaded from the cache. Enabled by default.
DnsPrefetchEnabled	29	Specifies whether will try to pre-fetch DNS entries to speed up browsing. Disabled by default. (Added in Qt 5.12)
ErrorPageEnabled	12	Enables displaying the built-in error pages of Chromium. Enabled by default.
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). Disabled by default. (Added in Qt 5.8)
FullScreenSupportEnabled	14	Enables fullscreen support in an application. Disabled by default. (Added in Qt 5.6)
HyperlinkAuditingEnabled	10	Enables support for the `ping` attribute for hyperlinks. Disabled by default.
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. See to also allow pasting the content of the clipboard content from JavaScript. Disabled by default.
JavascriptCanOpenWindows	2	Allows JavaScript programs to open popup windows without user interaction. Enabled by default.
JavascriptCanPaste	28	Enables JavaScript `execCommand("paste")`. This also requires enabling . Disabled by default. (Added in Qt 5.11)
JavascriptEnabled	1	Enables the running of JavaScript programs in the MainWorld. Enabled by default.
LinksIncludedInFocusChain	4	Includes hyperlinks in the keyboard focus chain. Enabled by default.
LocalContentCanAccessFileUrls	9	Allows locally loaded documents to access other local URLs. Enabled by default.
LocalContentCanAccessRemoteUrls	6	Allows locally loaded documents to ignore cross-origin rules so that they can access remote resources that would normally be blocked, because all remote resources are considered cross-origin for a local file. 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 stop XMLHttpRequests or media elements in local files from accessing remote content. Basically, it only stops some HTML subresources, such as scripts, and therefore disabling this setting is not a safety mechanism.
LocalStorageEnabled	5	Enables support for the HTML 5 local storage feature. Enabled by default.
PdfViewerEnabled	TODO	TODO
PlaybackRequiresUserGesture	26	Inhibits playback of media content until the user interacts with the page. This is similar to how Chrome on Android behaves, while the default behavior when it is disabled is similar to Chrome on desktops. (Added in Qt 5.11)
PluginsEnabled	13	Enables support for Pepper plugins, such as the Flash player. Disabled by default. See also Pepper Plugin API. (Added in Qt 5.6)
PrintElementBackgrounds	21	Turns on printing of CSS backgrounds when printing a web page. Enabled by default. (Added in Qt 5.8)
ScreenCaptureEnabled	15	Enables screen capture in an application. Disabled by default. (Added in Qt 5.7)
ScrollAnimatorEnabled	11	Enables animated scrolling. Disabled by default.
ShowScrollBars	25	Shows scroll bars. Enabled by default. (Added in Qt 5.10)
SpatialNavigationEnabled	8	Enables the Spatial Navigation feature, which means the ability to navigate between focusable elements, such as hyperlinks and form controls, on a web page by using the Left, Right, Up and Down arrow keys. For example, if a user presses the Right key, heuristics determine whether there is an element they might be trying to reach towards the right and which element they probably want. Disabled by default.
TouchIconsEnabled	19	Enables support for touch icons and precomposed touch icons Disabled by default. (Added in Qt 5.7)
WebGLEnabled	16	Enables support for HTML 5 WebGL. Enabled by default if available. (Added in Qt 5.7)
WebRTCPublicInterfacesOnly	27	Limits WebRTC to public IP addresses only. When disabled WebRTC may also use local network IP addresses, but remote hosts can also see your local network IP address. Disabled by default. (Added in Qt 5.11)
XSSAuditingEnabled	7	Monitors load requests for cross-site scripting attempts. Suspicious scripts are blocked and reported in the inspector鈥檚 JavaScript console. Enabled by default.

Methods露

@staticmethod defaultSettings() → QWebEngineSettings: TODO

defaultTextEncoding() → str: See also

setDefaultTextEncoding().

fontFamily(FontFamily) → str: See also

setFontFamily().

fontSize(FontSize) → int: See also

setFontSize().

@staticmethod globalSettings() → QWebEngineSettings: TODO

resetAttribute(WebAttribute): TODO

resetFontFamily(FontFamily): TODO

resetFontSize(FontSize): TODO

resetUnknownUrlSchemePolicy(): TODO

setAttribute(WebAttribute, bool): TODO

setDefaultTextEncoding(str): See also

defaultTextEncoding().

setFontFamily(FontFamily, str): See also

fontFamily().

setFontSize(FontSize, int): See also

fontSize().

setUnknownUrlSchemePolicy(UnknownUrlSchemePolicy): See also

unknownUrlSchemePolicy().

testAttribute(WebAttribute) → bool: TODO

unknownUrlSchemePolicy() → UnknownUrlSchemePolicy: See also

setUnknownUrlSchemePolicy().