- Qt 6.12
- Qt WebEngine
- C++ Classes
- QtWebEngineCore
- QWebEngineSettings
- Qt 6.12.0 Reference Documentation

# QWebEngineSettings Class

The QWebEngineSettings class provides an object to store the settings used by QWebEnginePage. More...

Header: | `#include <QWebEngineSettings>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)` `target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)`
qmake: | `QT += webenginecore`

- List of all members, including inherited members

## Public Types

enum | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont }
enum | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize }
`(since Qt 6.8)` enum class | ImageAnimationPolicy { Allow, AnimateOnce, Disallow }
`(since Qt 5.11)` enum | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes }
enum | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, TrimAccessibilityIdentifiers }

## Public Functions

QString | defaultTextEncoding() const
QString | fontFamily(QWebEngineSettings::FontFamily which) const
int | fontSize(QWebEngineSettings::FontSize type) const
`(since Qt 6.8)` QWebEngineSettings::ImageAnimationPolicy | imageAnimationPolicy() const
void | resetAttribute(QWebEngineSettings::WebAttribute attribute)
void | resetFontFamily(QWebEngineSettings::FontFamily which)
void | resetFontSize(QWebEngineSettings::FontSize type)
`(since Qt 6.8)` void | resetImageAnimationPolicy()
`(since Qt 5.11)` void | resetUnknownUrlSchemePolicy()
void | setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
void | setDefaultTextEncoding(const QString &encoding)
void | setFontSize(QWebEngineSettings::FontSize type, int size)
`(since Qt 6.8)` void | setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)
`(since Qt 5.11)` void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const
`(since Qt 5.11)` QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const

## Detailed Description

QWebEngineSettings allows configuration of Qt WebEngine properties, such as font sizes and families, 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.

See also QWebEnginePage::settings() and QWebEngineView::settings().

## Member Type Documentation

### enum QWebEngineSettings::FontFamily

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

Constant | Value
--- | ---
`QWebEngineSettings::StandardFont` | `0`
`QWebEngineSettings::FixedFont` | `1`
`QWebEngineSettings::SerifFont` | `2`
`QWebEngineSettings::SansSerifFont` | `3`
`QWebEngineSettings::CursiveFont` | `4`
`QWebEngineSettings::FantasyFont` | `5`
`QWebEngineSettings::PictographFont (since Qt 5.7, deprecated in Qt 6.4)` | `6`

### enum QWebEngineSettings::FontSize

This enum describes the font sizes configurable through QWebEngineSettings:

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

### `[since Qt 6.8]` enum class QWebEngineSettings::ImageAnimationPolicy

This enum describes how an image animation should be handled when the image frames are rendered for animation.

Constant | Value | Description
--- | --- | ---
`QWebEngineSettings::ImageAnimationPolicy::Allow` | `1` | Allows image animation when the image frames are rendered.
`QWebEngineSettings::ImageAnimationPolicy::AnimateOnce` | `2` | Animate the image once when the image frames are rendered.
`QWebEngineSettings::ImageAnimationPolicy::Disallow` | `3` | Disallows image animation when the image frames are rendered.

This enum was introduced in Qt 6.8.

See also imageAnimationPolicy, setImageAnimationPolicy, and resetImageAnimationPolicy.

### `[since Qt 5.11]` enum QWebEngineSettings::UnknownUrlSchemePolicy

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

Constant | Value | Description
--- | --- | ---
`QWebEngineSettings::DisallowUnknownUrlSchemes` | `1` | Disallows all navigation requests to URLs with unknown schemes.
`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.

This enum was introduced in Qt 5.11.

See also unknownUrlSchemePolicy, setUnknownUrlSchemePolicy, and resetUnknownUrlSchemePolicy.

### enum QWebEngineSettings::WebAttribute

This enum type specifies settings for web pages:

Constant | Value | Description
--- | --- | ---
`QWebEngineSettings::AutoLoadImages` | `0` | Automatically dowloads images for web pages. When this setting is disabled, images are loaded from the cache. Enabled by default.
`QWebEngineSettings::JavascriptEnabled` | `1` | Enables the running of JavaScript programs in the MainWorld. Enabled by default.
`QWebEngineSettings::JavascriptCanOpenWindows` | `2` | Allows JavaScript programs to open popup windows without user interaction. Enabled by default.
`QWebEngineSettings::JavascriptCanAccessClipboard` | `3` | Allows JavaScript programs to write (copy) sanitized content to the clipboard. A sanitized write is done with the `write` and `writeText` JavaScript Clipboard API calls and must be accompanied by user action. Unsanitized writes, and reading from the clipboard, are enabled by JavascriptCanPaste. Prior to Chromium version 81, this setting enabled all clipboard writes. Since unrestricted clipboard access is a potential security concern, it is recommended that applications leave this disabled and instead respond to ClipboardReadWrite feature permission requests. Disabled by default.
`QWebEngineSettings::LinksIncludedInFocusChain` | `4` | Includes hyperlinks in the keyboard focus chain. Enabled by default.
`QWebEngineSettings::LocalStorageEnabled` | `5` | Enables support for the HTML 5 local storage feature. Enabled by default.
`QWebEngineSettings::LocalContentCanAccessRemoteUrls` | `6` | Allows local origin documents to access remote resources that would normally be blocked. Disabled by default. Note DnsPrefetchEnabled below operates independently of this setting, and can if enabled, cause remote accesses from local content.
`QWebEngineSettings::XSSAuditingEnabled` | `7` | Obsolete and has no effect.
`QWebEngineSettings::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.
`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` | Enables support for the `ping` attribute for hyperlinks. Disabled by default.
`QWebEngineSettings::ScrollAnimatorEnabled` | `11` | Enables animated scrolling. Disabled by default.
`QWebEngineSettings::ErrorPageEnabled` | `12` | Enables displaying the built-in error pages of Chromium. Enabled by default.
`QWebEngineSettings::PluginsEnabled (since Qt 5.6)` | `13` | Enables support for Pepper plugins, such as the Flash player. Disabled by default.
`QWebEngineSettings::FullScreenSupportEnabled (since Qt 5.6)` | `14` | Enables fullscreen support in an application. Disabled by default.
`QWebEngineSettings::ScreenCaptureEnabled (since Qt 5.7)` | `15` | Enables screen capture in an application. Disabled by default.
`QWebEngineSettings::WebGLEnabled (since Qt 5.7)` | `16` | Enables support for HTML 5 WebGL. Enabled by default if available.
`QWebEngineSettings::Accelerated2dCanvasEnabled (since Qt 5.7)` | `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.
`QWebEngineSettings::AutoLoadIconsForPage (since Qt 5.7)` | `18` | Automatically downloads icons for web pages. Enabled by default.
`QWebEngineSettings::TouchIconsEnabled (since Qt 5.7)` | `19` | Enables support for touch icons and precomposed touch icons Disabled by default.
`QWebEngineSettings::FocusOnNavigationEnabled (since Qt 5.8)` | `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.
`QWebEngineSettings::PrintElementBackgrounds (since Qt 5.8)` | `21` | Turns on printing of CSS backgrounds when printing a web page. Enabled by default.
`QWebEngineSettings::AllowRunningInsecureContent (since Qt 5.8)` | `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.
`QWebEngineSettings::AllowGeolocationOnInsecureOrigins (since Qt 5.9)` | `23` | Only secure origins such as HTTPS are able to request Geolocation features. This provides an override to allow non secure origins to access Geolocation. Disabled by default.
`QWebEngineSettings::AllowWindowActivationFromJavaScript (since Qt 5.10)` | `24` | Allows activating windows by using the window.focus() JavaScript method. Disabled by default.
`QWebEngineSettings::ShowScrollBars (since Qt 5.10)` | `25` | Shows scroll bars. Enabled by default.
`QWebEngineSettings::PlaybackRequiresUserGesture (since Qt 5.11)` | `26` | 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.
`QWebEngineSettings::JavascriptCanPaste (since Qt 5.11)` | `28` | Enables JavaScript `execCommand("paste")`. This also requires enabling JavascriptCanAccessClipboard. Since unrestricted clipboard access is a potential security concern, it is recommended that applications leave this disabled and instead respond to ClipboardReadWrite feature permission requests. Disabled by default.
`QWebEngineSettings::WebRTCPublicInterfacesOnly (since Qt 5.11)` | `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.
`QWebEngineSettings::DnsPrefetchEnabled (since Qt 5.12)` | `29` | Specifies whether WebEngine will try to pre-fetch DNS entries. Disabled by default.
`QWebEngineSettings::PdfViewerEnabled (since Qt 5.13)` | `30` | Specifies that PDF documents will be opened in the internal PDF viewer instead of being downloaded. Enabled by default.
`QWebEngineSettings::NavigateOnDropEnabled (since Qt 6.4)` | `31` | Specifies that navigations can be triggered by dropping URLs on the view. Enabled by default.
`QWebEngineSettings::ReadingFromCanvasEnabled (since Qt 6.6)` | `32` | Specifies that reading from all canvas elements is enabled. This setting will have impact on all HTML5 canvas elements irrespective of origin, and can be disabled to prevent canvas fingerprinting. Enabled by default.
`QWebEngineSettings::ForceDarkMode (since Qt 6.7)` | `33` | Specifies that all web contents will be rendered using a dark theme. For more information, see Auto dark theme. Disabled by default.
`QWebEngineSettings::PrintHeaderAndFooter (since Qt 6.9)` | `34` | Specifies that printing results will contain basic page information (URL, title, date, page number) in header and footer area. It is the embedder's responsibility to provide enough space for these texts by setting proper top and bottom margins. Disabled by default.
`QWebEngineSettings::PreferCSSMarginsForPrinting (since Qt 6.9)` | `35` | Turns on preferring CSS margins over the margins of the specified QPageLayout. Disabled by default.
`QWebEngineSettings::TouchEventsApiEnabled (since Qt 6.9)` | `36` | Enables support for JavaScript touch events API, meaning `ontouchstart`, `ontouchend` and `ontouchmove` handlers will be present in the `document.window` object. Enabled by default if a touch device detected by the system and disabled otherwise. Note that some websites use this API to decide whether they run on a mobile device or on desktop and base their design on it. This can cause unwanted results on touchscreen laptops or other setups that emulate a fake touch device.
`QWebEngineSettings::BackForwardCacheEnabled (since Qt 6.10)` | `37` | Enables support for back/forward cache (or bfcache) to speed up back and forward navigation. Disabled by default.
`QWebEngineSettings::TrimAccessibilityIdentifiers (since Qt 6.11)` | `38` | Forces the HTML 'id' attribute to be used as the automation ID (QAccessible::Identifier) without modification. When disabled, Qt will instead prepend the entire object hierarchy to the identifier. Disabled by default.

## Member Function Documentation

### QString QWebEngineSettings::defaultTextEncoding() const

Returns the default text encoding.

See also setDefaultTextEncoding().

### QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const

Returns the actual font family for the specified generic font family, which.

### int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const

Returns the default font size for type in pixels.

See also setFontSize().

### `[since Qt 6.8]` QWebEngineSettings::ImageAnimationPolicy QWebEngineSettings::imageAnimationPolicy() const

Returns the currently selected policy for handling image animation when the image frames are rendered. Default is QWebEngineSettings::ImageAnimationPolicy::Allow.

This function was introduced in Qt 6.8.

See also setImageAnimationPolicy and resetImageAnimationPolicy.

### void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)

Resets the setting of attribute to the value specified in the profile that the page belongs to.

### void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)

Resets the actual font family specified by which to the one specified in the profile that the page belongs to.

### void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)

Resets the font size for type to the size specified in the profile that the page belongs to.

### `[since Qt 6.8]` void QWebEngineSettings::resetImageAnimationPolicy()

Removes the policy for handling image animation.

This function was introduced in Qt 6.8.

See also imageAnimationPolicy and setImageAnimationPolicy.

### `[since Qt 5.11]` void QWebEngineSettings::resetUnknownUrlSchemePolicy()

Removes the policy for handling navigation requests to URLs with unknown schemes.

This function was introduced in Qt 5.11.

See also unknownUrlSchemePolicy and setUnknownUrlSchemePolicy.

### void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)

Enables or disables the specified attribute feature depending on the value of on.

### void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)

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 see QTextCodec.

See also defaultTextEncoding().

### void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)

Sets the font size for type to size in pixels.

See also fontSize().

### `[since Qt 6.8]` void QWebEngineSettings::setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)

Sets the policy for handling image animation when the image frames are rendered to policy. Default is QWebEngineSettings::ImageAnimationPolicy::Allow.

This function was introduced in Qt 6.8.

See also imageAnimationPolicy and resetImageAnimationPolicy.

### `[since Qt 5.11]` void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)

Sets the policy for handling navigation requests to URLs with unknown schemes to policy. Default is QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.

This function was introduced in Qt 5.11.

See also unknownUrlSchemePolicy and resetUnknownUrlSchemePolicy.

### bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const

Returns `true` if attribute is enabled; otherwise returns `false`.

### `[since Qt 5.11]` QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const

Returns the currently selected policy for handling navigation requests to URLs with unknown schemes. Default is QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.

This function was introduced in Qt 5.11.

See also setUnknownUrlSchemePolicy and resetUnknownUrlSchemePolicy.