Struct Settings 

pub struct Settings { /* private fields */ }

Control the behaviour of a WebView.

Settings can be applied to a WebView to control text charset, color, font sizes, printing mode, script support, loading of images and various other things on a WebView. After creation, a Settings object contains default settings.

⚠️ The following code is in c ⚠️

// Disable JavaScript
WebKitSettings *settings = webkit_web_view_group_get_settings (my_view_group);
webkit_settings_set_enable_javascript (settings, FALSE);

Properties

allow-file-access-from-file-urls

Whether file access is allowed from file URLs. By default, when something is loaded in a WebView using a file URI, cross origin requests to other file resources are not allowed. This setting allows you to change that behaviour, so that it would be possible to do a XMLHttpRequest of a local file, for example.

Readable | Writeable | Construct

allow-modal-dialogs

Determine whether it’s allowed to create and run modal dialogs from a WebView through JavaScript with <function>window.showModalDialog</function>. If it’s set to false, the associated WebView won’t be able to create new modal dialogs, so not even the create signal will be emitted.

Readable | Writeable | Construct

allow-top-navigation-to-data-urls

Whether or not the top frame is allowed to navigate to data URLs. It is disabled by default due to the risk it poses when loading untrusted URLs, with data URLs being used in scamming and phishing attacks. In contrast, a scenario where it could be enabled could be an app that embeds a WebView and you have control of the pages being show instead of a generic browser.

Readable | Writeable | Construct

allow-universal-access-from-file-urls

Whether or not JavaScript running in the context of a file scheme URL should be allowed to access content from any origin. By default, when something is loaded in a WebView using a file scheme URL, access to the local file system and arbitrary local storage is not allowed. This setting allows you to change that behaviour, so that it would be possible to use local storage, for example.

Readable | Writeable | Construct

auto-load-images

Determines whether images should be automatically loaded or not. On devices where network bandwidth is of concern, it might be useful to turn this property off.

Readable | Writeable | Construct

cursive-font-family

The font family used as the default for content using a cursive font.

Readable | Writeable | Construct

default-charset

The default text charset used when interpreting content with an unspecified charset.

Readable | Writeable | Construct

default-font-family

The font family to use as the default for content that does not specify a font.

Readable | Writeable | Construct

default-font-size

The default font size in pixels to use for content displayed if no font size is specified.

Readable | Writeable | Construct

default-monospace-font-size

The default font size in pixels to use for content displayed in monospace font if no font size is specified.

Readable | Writeable | Construct

disable-web-security

Enable or disable support for Web Security on pages.

This setting disables the same-origin policy, allowing every website full control over all other websites. This is for use in special environments where you wish to disable all security and allow websites to hack each other. It is impossible to use this setting securely.

Readable | Writeable | Construct

draw-compositing-indicators

Whether to draw compositing borders and repaint counters on layers drawn with accelerated compositing. This is useful for debugging issues related to web content that is composited with the GPU.

Readable | Writeable | Construct

enable-2d-canvas-acceleration

Enable or disable 2D canvas acceleration. If this setting is enabled, the 2D canvas will be accelerated even if Skia CPU is used for rendering. However, the canvas can be unaccelerated even when this setting is enabled, for other reasons like its size or when willReadFrequently property is used.

Readable | Writeable | Construct

enable-back-forward-navigation-gestures

Enable or disable horizontal swipe gesture for back-forward navigation.

Readable | Writeable | Construct

enable-caret-browsing

Whether to enable accessibility enhanced keyboard navigation.

Readable | Writeable | Construct

enable-developer-extras

Determines whether or not developer tools, such as the Web Inspector, are enabled.

Readable | Writeable | Construct

enable-dns-prefetching

Determines whether or not to prefetch domain names. DNS prefetching attempts to resolve domain names before a user tries to follow a link.

Readable | Writeable | Construct

enable-encrypted-media

Enable or disable support for Encrypted Media API on pages. EncryptedMedia is an experimental JavaScript API for playing encrypted media in HTML. This property will only work as intended if the EncryptedMedia feature is enabled at build time with the ENABLE_ENCRYPTED_MEDIA flag.

See https://www.w3.org/TR/encrypted-media/

Readable | Writeable | Construct

enable-fullscreen

Whether to enable the Javascript Fullscreen API. The API allows any HTML element to request fullscreen display. See also the current draft of the spec: http://www.w3.org/TR/fullscreen/

Readable | Writeable | Construct

enable-html5-database

Whether to enable HTML5 client-side SQL database support (IndexedDB).

Readable | Writeable | Construct

enable-html5-local-storage

Whether to enable HTML5 local storage support. Local storage provides simple synchronous storage access.

HTML5 local storage specification is available at http://dev.w3.org/html5/webstorage/.

Readable | Writeable | Construct

enable-hyperlink-auditing

Determines whether or not hyperlink auditing is enabled.

The hyperlink auditing specification is available at http://www.whatwg.org/specs/web-apps/current-work/multipage/links.htmlhyperlink-auditing.

Readable | Writeable | Construct

enable-javascript

Determines whether or not JavaScript executes within a page.

Readable | Writeable | Construct

enable-javascript-markup

Determines whether or not JavaScript markup is allowed in document. When this setting is disabled, all JavaScript-related elements and attributes are removed from the document during parsing. Note that executing JavaScript is still allowed if enable-javascript is true.

Readable | Writeable | Construct

enable-media

Enable or disable support for media playback on pages. This setting is enabled by default. Disabling it means <audio>, <track> and <video> elements will have playback support disabled.

Readable | Writeable | Construct

enable-media-capabilities

Enable or disable support for MediaCapabilities on pages. This specification intends to provide APIs to allow websites to make an optimal decision when picking media content for the user. The APIs will expose information about the decoding and encoding capabilities for a given format but also output capabilities to find the best match based on the device’s display.

See also https://wicg.github.io/media-capabilities/

Readable | Writeable | Construct

enable-media-stream

Enable or disable support for MediaStream on pages. MediaStream is an experimental proposal for allowing web pages to access audio and video devices for capture.

See also http://dev.w3.org/2011/webrtc/editor/getusermedia.html

Readable | Writeable | Construct

enable-mediasource

Enable or disable support for MediaSource on pages. MediaSource extends HTMLMediaElement to allow JavaScript to generate media streams for playback.

See also http://www.w3.org/TR/media-source/

Readable | Writeable | Construct

enable-mock-capture-devices

Enable or disable the Mock Capture Devices. Those are fake Microphone and Camera devices to be used as MediaStream sources.

Readable | Writeable | Construct

enable-offline-web-application-cache

Unsupported setting. This property does nothing.

Readable | Writeable | Construct

enable-page-cache

Enable or disable the page cache. Disabling the page cache is generally only useful for special circumstances like low-memory scenarios or special purpose applications like static HTML viewers. This setting only controls the Page Cache, this cache is different than the disk-based or memory-based traditional resource caches, its point is to make going back and forth between pages much faster. For details about the different types of caches and their purposes see: http://webkit.org/blog/427/webkit-page-cache-i-the-basics/

Readable | Writeable | Construct

enable-resizable-text-areas

Determines whether or not text areas can be resized.

Readable | Writeable | Construct

enable-site-specific-quirks

Whether to turn on site-specific quirks. Turning this on will tell WebKit to use some site-specific workarounds for better web compatibility. For example, older versions of MediaWiki will incorrectly send to WebKit a CSS file with KHTML workarounds. By turning on site-specific quirks, WebKit will special-case this and other cases to make some specific sites work.

Readable | Writeable | Construct

enable-smooth-scrolling

Enable or disable smooth scrolling.

Readable | Writeable | Construct

enable-spatial-navigation

Whether to enable Spatial Navigation. This feature consists in the ability to navigate between focusable elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow keys. For example, if an user presses the Right key, heuristics determine whether there is an element they might be trying to reach towards the right, and if there are multiple elements, which element they probably wants.

Readable | Writeable | Construct

enable-tabs-to-links

Determines whether the tab key cycles through the elements on the page. When this setting is enabled, users will be able to focus the next element in the page by pressing the tab key. If the selected element is editable, then pressing tab key will insert the tab character.

Readable | Writeable | Construct

enable-webaudio

Enable or disable support for WebAudio on pages. WebAudio is an API for processing and synthesizing audio in web applications

See also https://webaudio.github.io/web-audio-api

Readable | Writeable | Construct

enable-webgl

Enable or disable support for WebGL on pages. WebGL enables web content to use an API based on OpenGL ES 2.0.

Readable | Writeable | Construct

enable-webrtc

Enable WebRTC support for loaded pages.

Enabling this setting implies that [propertySettings] will be enabled as well.

See also https://www.w3.org/TR/webrtc/

Readable | Writeable | Construct

enable-write-console-messages-to-stdout

Enable or disable writing console messages to stdout. These are messages sent to the console with console.log and related methods.

Readable | Writeable | Construct

fantasy-font-family

The font family used as the default for content using a fantasy font.

Readable | Writeable | Construct

hardware-acceleration-policy

The HardwareAccelerationPolicy to decide how to enable and disable hardware acceleration. Disabling hardware acceleration might cause some websites to not render correctly or consume more CPU.

Note that changing this setting might not be possible if hardware acceleration is not supported by the hardware or the system. In that case, you can get the value to know the actual policy being used, but changing the setting will not have any effect.

Readable | Writeable | Construct

javascript-can-access-clipboard

Whether JavaScript can access the clipboard. The default value is false. If set to true, document.execCommand() allows cut, copy and paste commands.

Readable | Writeable | Construct

javascript-can-open-windows-automatically

Whether JavaScript can open popup windows automatically without user intervention.

Readable | Writeable | Construct

load-icons-ignoring-image-load-setting

Unsupported setting. This property does nothing.

Readable | Writeable | Construct

math-font-family

The font family used as the default for content using a math font.

Readable | Writeable | Construct

media-content-types-requiring-hardware-support

List of media content types requiring hardware support, split by semicolons (:). For example: ‘video/webm; codecs=“vp*”:video/mp4; codecs=“avc*”:video/* codecs=“av1*”’.

Readable | Writeable | Construct

media-playback-allows-inline

Whether media playback is full-screen only or inline playback is allowed. This is true by default, so media playback can be inline. Setting it to false allows specifying that media playback should be always fullscreen.

Readable | Writeable | Construct

media-playback-requires-user-gesture

Whether a user gesture (such as clicking the play button) would be required to start media playback or load media. This is off by default, so media playback could start automatically. Setting it on requires a gesture by the user to start playback, or to load the media.

Readable | Writeable | Construct

minimum-font-size

The minimum font size in pixels used to display text. This setting controls the absolute smallest size. Values other than 0 can potentially break page layouts.

Readable | Writeable | Construct

monospace-font-family

The font family used as the default for content using a monospace font.

Readable | Writeable | Construct

pictograph-font-family

The font family used as the default for content using a pictograph font.

Readable | Writeable | Construct

print-backgrounds

Whether background images should be drawn during printing.

Readable | Writeable | Construct

sans-serif-font-family

The font family used as the default for content using a sans-serif font.

Readable | Writeable | Construct

serif-font-family

The font family used as the default for content using a serif font.

Readable | Writeable | Construct

user-agent

The user-agent string used by WebKit. Unusual user-agent strings may cause web content to render incorrectly or fail to run, as many web pages are written to parse the user-agent strings of only the most popular browsers. Therefore, it’s typically better to not completely override the standard user-agent, but to use Settings::set_user_agent_with_application_details() instead.

If this property is set to the empty string or None, it will revert to the standard user-agent.

Readable | Writeable | Construct

webrtc-udp-ports-range

Allow customization of the WebRTC UDP ports range.

In some constrained environments where a firewall blocks UDP network traffic excepted on a specific port range, this settings can be used to give hints to the WebRTC backend regarding which ports to allocate. The format is min-port:max-port, so for instance 20000:30000. The default empty string value means the OS will use no hints from the WebRTC backend. Using 0 for one of the values is allowed and means the value is unspecified.

Readable | Writeable | Construct

zoom-text-only

Whether zoom-level affects only the text of the page or all the contents. Other contents containing text like form controls will be also affected by zoom factor when this property is enabled.

Readable | Writeable | Construct

GLib type: GObject with reference counted clone semantics.

Implementations

impl Settings

pub fn new() -> Settings

Creates a new Settings instance with default values.

It must be manually attached to a WebView. See also webkit_settings_new_with_settings().

Returns

a new Settings instance.

pub fn builder() -> SettingsBuilder

Creates a new builder-pattern struct instance to construct Settings objects.

This method returns an instance of SettingsBuilder which can be used to create Settings objects.

pub fn apply_from_key_file( &self, key_file: &KeyFile, group_name: &str, ) -> Result<(), Error>

Available on crate feature v2_46 only.

Reads the contents of the given group_name from the given key_file and apply the value of each key/value to the corresponding property on the self.

Value types have to match with the corresponding setting property type and the group keys have to match existing setting property names. If those conditions are not met, the function will return false.

Supported value types are strings (unquoted), booleans (0, 1, true, false) and unsigned integers.

key_file

a glib::KeyFile

group_name

Name of the group to read from key_file

Returns

true if the settings were correctly applied or false on error.

pub fn allows_file_access_from_file_urls(&self) -> bool

Get the allow-file-access-from-file-urls property.

Returns

true If file access from file URLs is allowed or false otherwise.

pub fn allows_modal_dialogs(&self) -> bool

Get the allow-modal-dialogs property.

Returns

true if it’s allowed to create and run modal dialogs or false otherwise.

pub fn allows_top_navigation_to_data_urls(&self) -> bool

Get the allow-top-navigation-to-data-urls property.

Returns

true If navigation to data URLs from the top frame is allowed or false
otherwise.

pub fn allows_universal_access_from_file_urls(&self) -> bool

Get the allow-universal-access-from-file-urls property.

Returns

true If universal access from file URLs is allowed or false otherwise.

pub fn is_auto_load_images(&self) -> bool

Get the auto-load-images property.

Returns

true If auto loading of images is enabled or false otherwise.

pub fn cursive_font_family(&self) -> Option<GString>

Gets the cursive-font-family property.

Returns

The default font family used to display content marked with cursive font.

pub fn default_charset(&self) -> Option<GString>

Gets the default-charset property.

Returns

Default charset.

pub fn default_font_family(&self) -> Option<GString>

Gets the default-font-family property.

Returns

The default font family used to display content that does not specify a font.

pub fn default_font_size(&self) -> u32

Gets the default-font-size property.

Returns

The default font size, in pixels.

pub fn default_monospace_font_size(&self) -> u32

Gets the default-monospace-font-size property.

Returns

Default monospace font size, in pixels.

pub fn is_disable_web_security(&self) -> bool

Get the disable-web-security property.

Returns

true If web security support is disabled or false otherwise.

pub fn draws_compositing_indicators(&self) -> bool

Get the draw-compositing-indicators property.

Returns

true If compositing borders are drawn or false otherwise.

pub fn enables_2d_canvas_acceleration(&self) -> bool

Available on crate feature v2_46 only.

Get the enable-2d-canvas-acceleration property.

Returns

true if 2D canvas acceleration is enabled or false otherwise.

pub fn enables_back_forward_navigation_gestures(&self) -> bool

Get the enable-back-forward-navigation-gestures property.

Returns

true if horizontal swipe gesture will trigger back-forward navigaiton or false otherwise.

pub fn enables_caret_browsing(&self) -> bool

Get the enable-caret-browsing property.

Returns

true If caret browsing is enabled or false otherwise.

pub fn enables_developer_extras(&self) -> bool

Get the enable-developer-extras property.

Returns

true If developer extras is enabled or false otherwise.

pub fn enables_dns_prefetching(&self) -> bool

👎Deprecated:

Since 2.48

Get the enable-dns-prefetching property.

Deprecated since 2.48

Returns

true If DNS prefetching is enabled or false otherwise.

pub fn enables_encrypted_media(&self) -> bool

Get the enable-encrypted-media property.

Returns

true if EncryptedMedia support is enabled or false otherwise.

pub fn enables_fullscreen(&self) -> bool

Get the enable-fullscreen property.

Returns

true If fullscreen support is enabled or false otherwise.

pub fn enables_html5_database(&self) -> bool

Get the enable-html5-database property.

Returns

true if IndexedDB support is enabled or false otherwise.

pub fn enables_html5_local_storage(&self) -> bool

Get the enable-html5-local-storage property.

Returns

true If HTML5 local storage support is enabled or false otherwise.

pub fn enables_hyperlink_auditing(&self) -> bool

👎Deprecated:

Since 2.50

Get the enable-hyperlink-auditing property.

Deprecated since 2.50

Returns

true If hyper link auditing is enabled or false otherwise.

pub fn enables_javascript(&self) -> bool

Get the enable-javascript property.

Returns

true If JavaScript is enabled or false otherwise.

pub fn enables_javascript_markup(&self) -> bool

Get the enable-javascript-markup property.

Returns

true if JavaScript markup is enabled or false otherwise.

pub fn enables_media(&self) -> bool

Get the enable-media property.

Returns

true if media support is enabled or false otherwise.

pub fn enables_media_capabilities(&self) -> bool

Get the enable-media-capabilities property.

Returns

true if MediaCapabilities support is enabled or false otherwise.

pub fn enables_media_stream(&self) -> bool

Get the enable-media-stream property.

Returns

true If mediastream support is enabled or false otherwise.

pub fn enables_mediasource(&self) -> bool

Get the enable-mediasource property.

Returns

true If MediaSource support is enabled or false otherwise.

pub fn enables_mock_capture_devices(&self) -> bool

Get the enable-mock-capture-devices property.

Returns

true If mock capture devices is enabled or false otherwise.

pub fn enables_offline_web_application_cache(&self) -> bool

👎Deprecated:

Since 2.44

Get the enable-offline-web-application-cache property.

Deprecated since 2.44

Returns

false.

pub fn enables_page_cache(&self) -> bool

Get the enable-page-cache property.

Returns

true if page cache enabled or false otherwise.

pub fn enables_resizable_text_areas(&self) -> bool

Get the enable-resizable-text-areas property.

Returns

true If text areas can be resized or false otherwise.

pub fn enables_site_specific_quirks(&self) -> bool

Get the enable-site-specific-quirks property.

Returns

true if site specific quirks are enabled or false otherwise.

pub fn enables_smooth_scrolling(&self) -> bool

Get the enable-smooth-scrolling property.

Returns

true if smooth scrolling is enabled or false otherwise.

pub fn enables_spatial_navigation(&self) -> bool

Get the enable-spatial-navigation property.

Returns

true If HTML5 spatial navigation support is enabled or false otherwise.

pub fn enables_tabs_to_links(&self) -> bool

Get the enable-tabs-to-links property.

Returns

true If tabs to link is enabled or false otherwise.

pub fn enables_webaudio(&self) -> bool

Get the enable-webaudio property.

Returns

true If webaudio support is enabled or false otherwise.

pub fn enables_webgl(&self) -> bool

Get the enable-webgl property.

Returns

true If WebGL support is enabled or false otherwise.

pub fn enables_webrtc(&self) -> bool

Get the [propertySettings] property.

Returns

true If WebRTC support is enabled or false otherwise.

pub fn enables_write_console_messages_to_stdout(&self) -> bool

Get the enable-write-console-messages-to-stdout property.

Returns

true if writing console messages to stdout is enabled or false otherwise.

pub fn fantasy_font_family(&self) -> Option<GString>

Gets the fantasy-font-family property.

Returns

The default font family used to display content marked with fantasy font.

pub fn is_feature_enabled(&self, feature: &Feature) -> bool

Available on crate feature v2_42 only.

Gets whether a feature is enabled.

feature

the feature to toggle.

Returns

Whether the feature is enabled.

pub fn hardware_acceleration_policy(&self) -> HardwareAccelerationPolicy

Get the hardware-acceleration-policy property.

Returns

a HardwareAccelerationPolicy

pub fn is_javascript_can_access_clipboard(&self) -> bool

Get the javascript-can-access-clipboard property.

Returns

true If javascript-can-access-clipboard is enabled or false otherwise.

pub fn is_javascript_can_open_windows_automatically(&self) -> bool

Get the javascript-can-open-windows-automatically property.

Returns

true If JavaScript can open window automatically or false otherwise.

pub fn is_load_icons_ignoring_image_load_setting(&self) -> bool

👎Deprecated:

Since 2.42

Setting no longer supported. This function returns false.

Deprecated since 2.42

Returns

false

pub fn math_font_family(&self) -> Option<GString>

Gets the math-font-family property.

Returns

The default font family used to display content marked with math font.

Since 2.52

pub fn media_content_types_requiring_hardware_support(&self) -> Option<GString>

Gets the media-content-types-requiring-hardware-support property.

Returns

Media content types requiring hardware support, or None.

pub fn is_media_playback_allows_inline(&self) -> bool

Get the media-playback-allows-inline property.

Returns

true If inline playback is allowed for media or false if only fullscreen playback is allowed.

pub fn is_media_playback_requires_user_gesture(&self) -> bool

Get the media-playback-requires-user-gesture property.

Returns

true If an user gesture is needed to play or load media or false if no user gesture is needed.

pub fn minimum_font_size(&self) -> u32

Gets the minimum-font-size property.

Returns

Minimum font size, in pixels.

pub fn monospace_font_family(&self) -> Option<GString>

Gets the monospace-font-family property.

Returns

Default font family used to display content marked with monospace font.

pub fn pictograph_font_family(&self) -> Option<GString>

Gets the pictograph-font-family property.

Returns

The default font family used to display content marked with pictograph font.

pub fn is_print_backgrounds(&self) -> bool

Get the print-backgrounds property.

Returns

true If background images should be printed or false otherwise.

pub fn sans_serif_font_family(&self) -> Option<GString>

Gets the sans-serif-font-family property.

Returns

The default font family used to display content marked with sans-serif font.

pub fn serif_font_family(&self) -> Option<GString>

Gets the serif-font-family property.

Returns

The default font family used to display content marked with serif font.

pub fn user_agent(&self) -> Option<GString>

Get the user-agent property.

Returns

The current value of the user-agent property.

pub fn webrtc_udp_ports_range(&self) -> Option<GString>

Available on crate feature v2_48 only.

Get the [propertySettings] property.

Returns

The WebRTC UDP ports range, or None if un-set.

pub fn is_zoom_text_only(&self) -> bool

Get the zoom-text-only property.

Returns

true If zoom level of the view should only affect the text or false if all view contents should be scaled.

pub fn set_allow_file_access_from_file_urls(&self, allowed: bool)

Set the allow-file-access-from-file-urls property.

allowed

Value to be set

pub fn set_allow_modal_dialogs(&self, allowed: bool)

Set the allow-modal-dialogs property.

allowed

Value to be set

pub fn set_allow_top_navigation_to_data_urls(&self, allowed: bool)

Set the allow-top-navigation-to-data-urls property.

allowed

Value to be set

pub fn set_allow_universal_access_from_file_urls(&self, allowed: bool)

Set the allow-universal-access-from-file-urls property.

allowed

Value to be set

pub fn set_auto_load_images(&self, enabled: bool)

Set the auto-load-images property.

enabled

Value to be set

pub fn set_cursive_font_family(&self, cursive_font_family: &str)

Set the cursive-font-family property.

cursive_font_family

the new default cursive font family

pub fn set_default_charset(&self, default_charset: &str)

Set the default-charset property.

default_charset

default charset to be set

pub fn set_default_font_family(&self, default_font_family: &str)

Set the default-font-family property.

default_font_family

the new default font family

pub fn set_default_font_size(&self, font_size: u32)

Set the default-font-size property.

font_size

default font size to be set in pixels

pub fn set_default_monospace_font_size(&self, font_size: u32)

Set the default-monospace-font-size property.

font_size

default monospace font size to be set in pixels

pub fn set_disable_web_security(&self, disabled: bool)

Set the disable-web-security property.

disabled

Value to be set

pub fn set_draw_compositing_indicators(&self, enabled: bool)

Set the draw-compositing-indicators property.

enabled

Value to be set

pub fn set_enable_2d_canvas_acceleration(&self, enabled: bool)

Available on crate feature v2_46 only.

Set the enable-2d-canvas-acceleration property.

enabled

Value to be set

pub fn set_enable_back_forward_navigation_gestures(&self, enabled: bool)

Set the enable-back-forward-navigation-gestures property.

enabled

value to be set

pub fn set_enable_caret_browsing(&self, enabled: bool)

Set the enable-caret-browsing property.

enabled

Value to be set

pub fn set_enable_developer_extras(&self, enabled: bool)

Set the enable-developer-extras property.

enabled

Value to be set

pub fn set_enable_dns_prefetching(&self, enabled: bool)

👎Deprecated:

Since 2.48

Set the enable-dns-prefetching property.

Deprecated since 2.48

enabled

Value to be set

pub fn set_enable_encrypted_media(&self, enabled: bool)

Set the enable-encrypted-media property.

enabled

Value to be set

pub fn set_enable_fullscreen(&self, enabled: bool)

Set the enable-fullscreen property.

enabled

Value to be set

pub fn set_enable_html5_database(&self, enabled: bool)

Set the enable-html5-database property.

enabled

Value to be set

pub fn set_enable_html5_local_storage(&self, enabled: bool)

Set the enable-html5-local-storage property.

enabled

Value to be set

pub fn set_enable_hyperlink_auditing(&self, enabled: bool)

👎Deprecated:

Since 2.50

Set the enable-hyperlink-auditing property.

Deprecated since 2.50

enabled

Value to be set

pub fn set_enable_javascript(&self, enabled: bool)

Set the enable-javascript property.

enabled

Value to be set

pub fn set_enable_javascript_markup(&self, enabled: bool)

Set the enable-javascript-markup property.

enabled

Value to be set

pub fn set_enable_media(&self, enabled: bool)

Set the enable-media property.

enabled

Value to be set

pub fn set_enable_media_capabilities(&self, enabled: bool)

Set the enable-media-capabilities property.

enabled

Value to be set

pub fn set_enable_media_stream(&self, enabled: bool)

Set the enable-media-stream property.

enabled

Value to be set

pub fn set_enable_mediasource(&self, enabled: bool)

Set the enable-mediasource property.

enabled

Value to be set

pub fn set_enable_mock_capture_devices(&self, enabled: bool)

Set the enable-mock-capture-devices property.

enabled

Value to be set

pub fn set_enable_offline_web_application_cache(&self, enabled: bool)

👎Deprecated:

Since 2.44

Setting no longer supported. This function does nothing.

Deprecated since 2.44

enabled

Value to be set

pub fn set_enable_page_cache(&self, enabled: bool)

Set the enable-page-cache property.

enabled

Value to be set

pub fn set_enable_resizable_text_areas(&self, enabled: bool)

Set the enable-resizable-text-areas property.

enabled

Value to be set

pub fn set_enable_site_specific_quirks(&self, enabled: bool)

Set the enable-site-specific-quirks property.

enabled

Value to be set

pub fn set_enable_smooth_scrolling(&self, enabled: bool)

Set the enable-smooth-scrolling property.

enabled

Value to be set

pub fn set_enable_spatial_navigation(&self, enabled: bool)

Set the enable-spatial-navigation property.

enabled

Value to be set

pub fn set_enable_tabs_to_links(&self, enabled: bool)

Set the enable-tabs-to-links property.

enabled

Value to be set

pub fn set_enable_webaudio(&self, enabled: bool)

Set the enable-webaudio property.

enabled

Value to be set

pub fn set_enable_webgl(&self, enabled: bool)

Set the enable-webgl property.

enabled

Value to be set

pub fn set_enable_webrtc(&self, enabled: bool)

Set the [propertySettings] property.

Setting this property to true implies the media-stream web-setting will also be enabled.

enabled

Value to be set

pub fn set_enable_write_console_messages_to_stdout(&self, enabled: bool)

Set the enable-write-console-messages-to-stdout property.

enabled

Value to be set

pub fn set_fantasy_font_family(&self, fantasy_font_family: &str)

Set the fantasy-font-family property.

fantasy_font_family

the new default fantasy font family

pub fn set_feature_enabled(&self, feature: &Feature, enabled: bool)

Available on crate feature v2_42 only.

Enables or disables a feature.

The current status of the feature can be determined with [idis_feature_enabled()]. To reset a feature to its initial status, pass the value returned by [idFeature::is_default_value()] as the enabled parameter.

feature

the feature to toggle.

enabled

whether the feature will be enabled.

pub fn set_hardware_acceleration_policy( &self, policy: HardwareAccelerationPolicy, )

Set the hardware-acceleration-policy property.

policy

a HardwareAccelerationPolicy

pub fn set_javascript_can_access_clipboard(&self, enabled: bool)

Set the javascript-can-access-clipboard property.

enabled

Value to be set

pub fn set_javascript_can_open_windows_automatically(&self, enabled: bool)

Set the javascript-can-open-windows-automatically property.

enabled

Value to be set

pub fn set_load_icons_ignoring_image_load_setting(&self, enabled: bool)

👎Deprecated:

Since 2.42

Setting no longer supported. This function does nothing.

Deprecated since 2.42

enabled

Value to be set

pub fn set_math_font_family(&self, math_font_family: Option<&str>)

Set the math-font-family property.

Since 2.52

math_font_family

the new default math font family

pub fn set_media_content_types_requiring_hardware_support( &self, content_types: Option<&str>, )

Set the media-content-types-requiring-hardware-support property.

content_types

list of media content types requiring hardware support split by semicolons (:) or None to use the default value.

pub fn set_media_playback_allows_inline(&self, enabled: bool)

Set the media-playback-allows-inline property.

enabled

Value to be set

pub fn set_media_playback_requires_user_gesture(&self, enabled: bool)

Set the media-playback-requires-user-gesture property.

enabled

Value to be set

pub fn set_minimum_font_size(&self, font_size: u32)

Set the minimum-font-size property.

font_size

minimum font size to be set in pixels

pub fn set_monospace_font_family(&self, monospace_font_family: &str)

Set the monospace-font-family property.

monospace_font_family

the new default monospace font family

pub fn set_pictograph_font_family(&self, pictograph_font_family: &str)

Set the pictograph-font-family property.

pictograph_font_family

the new default pictograph font family

pub fn set_print_backgrounds(&self, print_backgrounds: bool)

Set the print-backgrounds property.

print_backgrounds

Value to be set

pub fn set_sans_serif_font_family(&self, sans_serif_font_family: &str)

Set the sans-serif-font-family property.

sans_serif_font_family

the new default sans-serif font family

pub fn set_serif_font_family(&self, serif_font_family: &str)

Set the serif-font-family property.

serif_font_family

the new default serif font family

pub fn set_user_agent(&self, user_agent: Option<&str>)

Set the user-agent property.

user_agent

The new custom user agent string or None to use the default user agent

pub fn set_user_agent_with_application_details( &self, application_name: Option<&str>, application_version: Option<&str>, )

Set the user-agent property by appending the application details.

Set the user-agent property by appending the application details to the default user agent. If no application name or version is given, the default user agent used will be used. If only the version is given, the default engine version is used with the given application name.

application_name

The application name used for the user agent or None to use the default user agent.

application_version

The application version for the user agent or None to user the default version.

pub fn set_webrtc_udp_ports_range(&self, udp_port_range: &str)

Available on crate feature v2_48 only.

Set the [propertySettings] property.

udp_port_range

Value to be set

pub fn set_zoom_text_only(&self, zoom_text_only: bool)

Set the zoom-text-only property.

zoom_text_only

Value to be set

pub fn font_size_to_pixels(points: u32) -> u32

Convert points to the equivalent value in pixels.

Applications can use this function to convert font size values in points to font size values in pixels when setting the font size properties of Settings.

points

the font size in points to convert to pixels

Returns

the equivalent font size in pixels.

pub fn font_size_to_points(pixels: u32) -> u32

Convert pixels to the equivalent value in points.

Applications can use this function to convert font size values in pixels to font size values in points when getting the font size properties of Settings.

pixels

the font size in pixels to convert to points

Returns

the equivalent font size in points.

pub fn all_features() -> Option<FeatureList>

Available on crate feature v2_42 only.

Gets the list of all available WebKit features.

Features can be toggled with [methodSettings], and their current state determined with [methodSettings].

Note that most applications should use [funcSettings] and [funcSettings] instead.

Returns

List of all features.

pub fn development_features() -> Option<FeatureList>

Available on crate feature v2_42 only.

Gets the list of available development WebKit features.

The returned features are a subset of those returned by [funcSettings], and includes those which web and WebKit developers might find useful, but in general should not be exposed to end users; see [enumFeatureStatus] for more details.

Returns

List of development features.

pub fn experimental_features() -> Option<FeatureList>

Available on crate feature v2_42 only.

Gets the list of available experimental WebKit features.

The returned features are a subset of those returned by [funcSettings], and includes those which certain applications may want to expose to end users; see [enumFeatureStatus] for more details.

Returns

List of experimental features.

pub fn connect_allow_file_access_from_file_urls_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_allow_modal_dialogs_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_allow_top_navigation_to_data_urls_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_allow_universal_access_from_file_urls_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_auto_load_images_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_cursive_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_default_charset_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_default_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_default_font_size_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_default_monospace_font_size_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_disable_web_security_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_draw_compositing_indicators_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_2d_canvas_acceleration_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v2_46 only.

pub fn connect_enable_back_forward_navigation_gestures_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_caret_browsing_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_developer_extras_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_dns_prefetching_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

👎Deprecated:

Since 2.48

pub fn connect_enable_encrypted_media_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_fullscreen_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_html5_database_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_html5_local_storage_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_hyperlink_auditing_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

👎Deprecated:

Since 2.50

pub fn connect_enable_javascript_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_javascript_markup_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_media_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_media_capabilities_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_media_stream_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_mediasource_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_mock_capture_devices_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_offline_web_application_cache_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

👎Deprecated:

Since 2.44

pub fn connect_enable_page_cache_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_resizable_text_areas_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_site_specific_quirks_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_smooth_scrolling_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_spatial_navigation_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_tabs_to_links_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_webaudio_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_webgl_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_webrtc_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_enable_write_console_messages_to_stdout_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_fantasy_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_hardware_acceleration_policy_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_javascript_can_access_clipboard_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_javascript_can_open_windows_automatically_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_load_icons_ignoring_image_load_setting_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

👎Deprecated:

Since 2.42

pub fn connect_math_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v2_52 only.

pub fn connect_media_content_types_requiring_hardware_support_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_media_playback_allows_inline_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_media_playback_requires_user_gesture_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_minimum_font_size_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_monospace_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_pictograph_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_print_backgrounds_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_sans_serif_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_serif_font_family_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_user_agent_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_webrtc_udp_ports_range_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v2_48 only.

pub fn connect_zoom_text_only_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Settings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for Settings

type ParamSpec = ParamSpecObject

type SetValue = Settings

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(&str) -> ParamSpecObjectBuilder<'_, Settings>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for Settings

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Settings

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for Settings

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for Settings

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for Settings

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Settings

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Settings