QWebEngineSettings¶
The
QWebEngineSettings
class provides an object to store the settings used byQWebEnginePage
. More…
Synopsis¶
Functions¶
def
defaultTextEncoding
()def
fontFamily
(which)def
fontSize
(type)def
resetAttribute
(attr)def
resetFontFamily
(which)def
resetFontSize
(type)def
resetUnknownUrlSchemePolicy
()def
setAttribute
(attr, on)def
setDefaultTextEncoding
(encoding)def
setFontFamily
(which, family)def
setFontSize
(type, size)def
setUnknownUrlSchemePolicy
(policy)def
testAttribute
(attr)def
unknownUrlSchemePolicy
()
Static functions¶
def
defaultSettings
()def
globalSettings
()
Detailed Description¶
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 thesetAttribute()
function. TheWebAttribute
enum further describes each attribute.Each
QWebEnginePage
object has its ownQWebEngineSettings
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.See also
- class PySide2.QtWebEngineWidgets.QWebEngineSettings¶
- PySide2.QtWebEngineWidgets.QWebEngineSettings.FontFamily¶
This enum describes the generic font families defined by CSS 2. For more information see the CSS standard .
Constant
Description
QWebEngineSettings.StandardFont
QWebEngineSettings.FixedFont
QWebEngineSettings.SerifFont
QWebEngineSettings.SansSerifFont
QWebEngineSettings.CursiveFont
QWebEngineSettings.FantasyFont
QWebEngineSettings.PictographFont
(added in Qt 5.7)
- PySide2.QtWebEngineWidgets.QWebEngineSettings.WebAttribute¶
This enum type specifies settings for web pages:
Constant
Description
QWebEngineSettings.AutoLoadImages
Automatically dowloads images for web pages. When this setting is disabled, images are loaded from the cache. Enabled by default.
QWebEngineSettings.JavascriptEnabled
Enables the running of JavaScript programs in the
MainWorld
. Enabled by default.QWebEngineSettings.JavascriptCanOpenWindows
Allows JavaScript programs to open popup windows without user interaction. Enabled by default.
QWebEngineSettings.JavascriptCanAccessClipboard
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.
QWebEngineSettings.LinksIncludedInFocusChain
Includes hyperlinks in the keyboard focus chain. Enabled by default.
QWebEngineSettings.LocalStorageEnabled
Enables support for the HTML 5 local storage feature. Enabled by default.
QWebEngineSettings.LocalContentCanAccessRemoteUrls
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
Obsolete and has no effect.
QWebEngineSettings.SpatialNavigationEnabled
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.
QWebEngineSettings.LocalContentCanAccessFileUrls
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
Enables support for the
ping
attribute for hyperlinks. Disabled by default.QWebEngineSettings.ScrollAnimatorEnabled
Enables animated scrolling. Disabled by default.
QWebEngineSettings.ErrorPageEnabled
Enables displaying the built-in error pages of Chromium. Enabled by default.
QWebEngineSettings.PluginsEnabled
Enables support for Pepper plugins, such as the Flash player. Disabled by default. See also Pepper Plugin API . (Added in Qt 5.6)
QWebEngineSettings.FullScreenSupportEnabled
Enables fullscreen support in an application. Disabled by default. (Added in Qt 5.6)
QWebEngineSettings.ScreenCaptureEnabled
Enables screen capture in an application. Disabled by default. (Added in Qt 5.7)
QWebEngineSettings.WebGLEnabled
Enables support for HTML 5 WebGL. Enabled by default if available. (Added in Qt 5.7)
QWebEngineSettings.Accelerated2dCanvasEnabled
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)
QWebEngineSettings.AutoLoadIconsForPage
Automatically downloads icons for web pages. Enabled by default. (Added in Qt 5.7)
QWebEngineSettings.TouchIconsEnabled
Enables support for touch icons and precomposed touch icons Disabled by default. (Added in Qt 5.7)
QWebEngineSettings.FocusOnNavigationEnabled
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)
QWebEngineSettings.PrintElementBackgrounds
Turns on printing of CSS backgrounds when printing a web page. Enabled by default. (Added in Qt 5.8)
QWebEngineSettings.AllowRunningInsecureContent
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)
QWebEngineSettings.AllowGeolocationOnInsecureOrigins
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)
QWebEngineSettings.AllowWindowActivationFromJavaScript
Allows activating windows by using the window.focus() JavaScript method. Disabled by default. (Added in Qt 5.10)
QWebEngineSettings.ShowScrollBars
Shows scroll bars. Enabled by default. (Added in Qt 5.10)
QWebEngineSettings.PlaybackRequiresUserGesture
Inhibits playback of media content until the user interacts with the page. By default, WebEngine uses Chromium settings, as described in Autoplay Policy Changes . This is similar to how Chrome on Android behaves, while the default behavior when it is disabled is similar to Chrome on desktops. To overwrite the default behavior, disable this setting. (Added in Qt 5.11)
QWebEngineSettings.JavascriptCanPaste
Enables JavaScript
execCommand("paste")
. This also requires enabling . Disabled by default. (Added in Qt 5.11)QWebEngineSettings.WebRTCPublicInterfacesOnly
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)
QWebEngineSettings.DnsPrefetchEnabled
Specifies whether WebEngine will try to pre-fetch DNS entries to speed up browsing. Disabled by default. (Added in Qt 5.12)
QWebEngineSettings.PdfViewerEnabled
Specifies that PDF documents will be opened in the internal PDF viewer instead of being downloaded. Enabled by default. (Added in Qt 5.13)
- PySide2.QtWebEngineWidgets.QWebEngineSettings.FontSize¶
This enum describes the font sizes configurable through
QWebEngineSettings
:Constant
Description
QWebEngineSettings.MinimumFontSize
The hard minimum font size.
QWebEngineSettings.MinimumLogicalFontSize
The minimum logical font size that is applied when zooming out.
QWebEngineSettings.DefaultFontSize
The default font size for regular text.
QWebEngineSettings.DefaultFixedFontSize
The default font size for fixed-pitch text.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.UnknownUrlSchemePolicy¶
This enum describes how navigation requests to URLs with unknown schemes are handled.
Constant
Description
QWebEngineSettings.DisallowUnknownUrlSchemes
Disallows all navigation requests to URLs with unknown schemes.
QWebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction
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
Allows all navigation requests to URLs with unknown schemes.
New in version 5.11.
- static PySide2.QtWebEngineWidgets.QWebEngineSettings.defaultSettings()¶
- Return type:
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.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.defaultTextEncoding()¶
- Return type:
str
Returns the default text encoding.
See also
- PySide2.QtWebEngineWidgets.QWebEngineSettings.fontFamily(which)¶
- Parameters:
which –
FontFamily
- Return type:
str
Returns the actual font family for the specified generic font family,
which
.See also
- PySide2.QtWebEngineWidgets.QWebEngineSettings.fontSize(type)¶
- Parameters:
type –
FontSize
- Return type:
int
Returns the default font size for
type
in pixels.See also
- static PySide2.QtWebEngineWidgets.QWebEngineSettings.globalSettings()¶
- Return type:
Use
defaultSettings()
instead.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.resetAttribute(attr)¶
- Parameters:
attr –
WebAttribute
Resets the setting of
attribute
to the value specified in the profile that the page belongs to.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.resetFontFamily(which)¶
- Parameters:
which –
FontFamily
Resets the actual font family specified by
which
to the one specified in the profile that the page belongs to.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.resetFontSize(type)¶
- Parameters:
type –
FontSize
Resets the font size for
type
to the size specified in the profile that the page belongs to.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.resetUnknownUrlSchemePolicy()¶
Removes the policy for handling navigation requests to URLs with unknown schemes.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.setAttribute(attr, on)¶
- Parameters:
attr –
WebAttribute
on – bool
Enables or disables the specified
attribute
feature depending on the value ofon
.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.setDefaultTextEncoding(encoding)¶
- Parameters:
encoding – str
Specifies the default text encoding system.
The value of
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 seeQTextCodec
.See also
- PySide2.QtWebEngineWidgets.QWebEngineSettings.setFontFamily(which, family)¶
- Parameters:
which –
FontFamily
family – str
Sets the actual font family to
family
for the specified generic family,which
.See also
- PySide2.QtWebEngineWidgets.QWebEngineSettings.setFontSize(type, size)¶
- Parameters:
type –
FontSize
size – int
Sets the font size for
type
tosize
in pixels.See also
- PySide2.QtWebEngineWidgets.QWebEngineSettings.setUnknownUrlSchemePolicy(policy)¶
- Parameters:
policy –
UnknownUrlSchemePolicy
Sets the policy for handling navigation requests to URLs with unknown schemes to
policy
. Default isAllowUnknownUrlSchemesFromUserInteraction
.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.testAttribute(attr)¶
- Parameters:
attr –
WebAttribute
- Return type:
bool
Returns
true
ifattribute
is enabled; otherwise returnsfalse
.
- PySide2.QtWebEngineWidgets.QWebEngineSettings.unknownUrlSchemePolicy()¶
- Return type:
Returns the currently selected policy for handling navigation requests to URLs with unknown schemes. Default is
AllowUnknownUrlSchemesFromUserInteraction
.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.