Back to Seed Clases

WebKit

Classes

Interfaces

DOMEventTarget

Structs

Unions

Enums

GObject.Object
parent-child marker WebKit.WebSettings

Class WebKit.WebSettings

Import line:	WebKit = imports.gi.WebKit;
GIR File:	WebKit-3.0.gir
C documentation:	WebKitWebSettings
Class :	WebSettings
Extends:	GObject.Object

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

/* Create a new websettings and disable java script */
WebKitWebSettings *settings = webkit_web_settings_new ();
g_object_set (G_OBJECT(settings), "enable-scripts", FALSE, NULL);
/* Apply the result */
webkit_web_view_set_settings (WEBKIT_WEB_VIEW(my_webview), settings);

Properties
Properties		Defined By
	auto_load_images : gboolean	WebKit.WebSettings
	auto_resize_window : gboolean Web pages can request to modify the size and position of the window containing the WebKitWebView through various DOM methods (resizeTo, moveTo, resizeBy, moveBy). Web pages can request to modify the size and position of the window containing the WebKitWebView through various DOM methods (resizeTo, moveTo, resizeBy, moveBy). By default WebKit will not honor this requests, but you can set this property to TRUE if you'd like it to do so. If you wish to handle this manually, you can connect to the notify signal for the WebKitWebWindowFeatures of your WebKitWebView.	WebKit.WebSettings
	auto_shrink_images : gboolean	WebKit.WebSettings
	cursive_font_family : String	WebKit.WebSettings
	default_encoding : String	WebKit.WebSettings
	default_font_family : String	WebKit.WebSettings
	default_font_size : gint32	WebKit.WebSettings
	default_monospace_font_size : gint32	WebKit.WebSettings
	editing_behavior : WebKit.EditingBehavior This setting controls various editing behaviors that differ between platforms and that have been combined in two groups, 'Mac' and 'Windows'. This setting controls various editing behaviors that differ between platforms and that have been combined in two groups, 'Mac' and 'Windows'. Some examples: 1) Clicking below the last line of an editable area puts the caret at the end of the last line on Mac, but in the middle of the last line on Windows. 2) Pushing down the arrow key on the last line puts the caret at the end of the last line on Mac, but does nothing on Windows. A similar case exists on the top line.	WebKit.WebSettings
	enable_caret_browsing : gboolean Whether to enable caret browsing mode. Whether to enable caret browsing mode.	WebKit.WebSettings
	enable_default_context_menu : gboolean Whether right-clicks should be handled automatically to create, and display the context menu. Whether right-clicks should be handled automatically to create, and display the context menu. Turning this off will make WebKitGTK+ not emit the populate-popup signal. Notice that the default button press event handler may still handle right clicks for other reasons, such as in-page context menus, or right-clicks that are handled by the page itself.	WebKit.WebSettings
	enable_developer_extras : gboolean Whether developer extensions should be enabled. Whether developer extensions should be enabled. This enables, for now, the Web Inspector, which can be controlled using the WebKitWebInspector instance held by the WebKitWebView this setting is enabled for.	WebKit.WebSettings
	enable_dns_prefetching : gboolean Whether webkit prefetches domain names. Whether webkit prefetches domain names. This is a separate knob from private browsing. Whether private browsing should set this or not is up for debate, for now it doesn't.	WebKit.WebSettings
	enable_dom_paste : gboolean Whether to enable DOM paste. Whether to enable DOM paste. If set to TRUE, document.execCommand("Paste") will correctly execute and paste content of the clipboard.	WebKit.WebSettings
	enable_file_access_from_file_uris : gboolean Boolean property to control file access for file:// URIs. Boolean property to control file access for file:// URIs. If this option is enabled every file:// will have its own security unique domain.	WebKit.WebSettings
	enable_frame_flattening : gboolean Whether to enable the Frame Flattening. Whether to enable the Frame Flattening. With this setting each subframe is expanded to its contents, which will flatten all the frames to become one scrollable page. On touch devices, it is desired to not have any scrollable sub parts of the page as it results in a confusing user experience, with scrolling sometimes scrolling sub parts and at other times scrolling the page itself. For this reason iframes and framesets are barely usable on touch devices.	WebKit.WebSettings
	enable_fullscreen : gboolean	WebKit.WebSettings
	enable_html5_database : gboolean Whether to enable HTML5 client-side SQL database support. Whether to enable HTML5 client-side SQL database support. Client-side SQL database allows web pages to store structured data and be able to use SQL to manipulate that data asynchronously.	WebKit.WebSettings
	enable_html5_local_storage : gboolean Whether to enable HTML5 localStorage support. Whether to enable HTML5 localStorage support. localStorage provides simple synchronous storage access.	WebKit.WebSettings
	enable_hyperlink_auditing : gboolean Enable or disable support for . Enable or disable support for .	WebKit.WebSettings
	enable_java_applet : gboolean Enable or disable support for the Java <applet> tag. Enable or disable support for the Java <applet> tag. Keep in mind that Java content can be still shown in the page through <object> or <embed>, which are the preferred tags for this task.	WebKit.WebSettings
	enable_offline_web_application_cache : gboolean Whether to enable HTML5 offline web application cache support. Whether to enable HTML5 offline web application cache support. Offline Web Application Cache ensures web applications are available even when the user is not connected to the network.	WebKit.WebSettings
	enable_page_cache : gboolean Enable or disable the 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/	WebKit.WebSettings
	enable_plugins : gboolean	WebKit.WebSettings
	enable_private_browsing : gboolean Whether to enable private browsing mode. Whether to enable private browsing mode. Private browsing mode prevents WebKit from updating the global history and storing any session information e.g., on-disk cache, as well as suppressing any messages from being printed into the (javascript) console. This is currently experimental for WebKitGtk.	WebKit.WebSettings
	enable_scripts : gboolean	WebKit.WebSettings
	enable_site_specific_quirks : gboolean	WebKit.WebSettings
	enable_spatial_navigation : gboolean Whether to enable the Spatial Navigation. Whether to enable the 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 he might be trying to reach towards the right, and if there are multiple elements, which element he probably wants.	WebKit.WebSettings
	enable_spell_checking : gboolean Whether to enable spell checking while typing. Whether to enable spell checking while typing.	WebKit.WebSettings
	enable_universal_access_from_file_uris : gboolean Whether to allow files loaded through file:// URIs universal access to all pages. Whether to allow files loaded through file:// URIs universal access to all pages.	WebKit.WebSettings
	enable_xss_auditor : gboolean Whether to enable the XSS Auditor. Whether to enable the XSS Auditor. This feature filters some kinds of reflective XSS attacks on vulnerable web sites.	WebKit.WebSettings
	enforce_96_dpi : gboolean Enforce a resolution of 96 DPI. Enforce a resolution of 96 DPI. This is meant for compatibility with web pages which cope badly with different screen resolutions and for automated testing. Web browsers and applications that typically display arbitrary content from the web should provide a preference for this.	WebKit.WebSettings
	fantasy_font_family : String	WebKit.WebSettings
	javascript_can_access_clipboard : gboolean Whether JavaScript can access Clipboard. Whether JavaScript can access Clipboard.	WebKit.WebSettings
	javascript_can_open_windows_automatically : gboolean Whether JavaScript can open popup windows automatically without user intervention. Whether JavaScript can open popup windows automatically without user intervention.	WebKit.WebSettings
	minimum_font_size : gint32	WebKit.WebSettings
	minimum_logical_font_size : gint32	WebKit.WebSettings
	monospace_font_family : String	WebKit.WebSettings
	parent_instance : GObject.Object read only	WebKit.WebSettings
	print_backgrounds : gboolean	WebKit.WebSettings
	priv : WebKit.WebSettingsPrivate read only	WebKit.WebSettings
	resizable_text_areas : gboolean	WebKit.WebSettings
	sans_serif_font_family : String	WebKit.WebSettings
	serif_font_family : String	WebKit.WebSettings
	spell_checking_languages : String The languages to be used for spell checking, separated by commas. The languages to be used for spell checking, separated by commas. The locale string typically is in the form lang_COUNTRY, where lang is an ISO-639 language code, and COUNTRY is an ISO-3166 country code. For instance, sv_FI for Swedish as written in Finland or pt_BR for Portuguese as written in Brazil. If no value is specified then the value returned by gtk_get_default_language will be used.	WebKit.WebSettings
	tab_key_cycles_through_elements : gboolean Whether the tab key cycles through elements on the page. Whether the tab key cycles through elements on the page. If flag is TRUE, pressing the tab key will focus the next element in the web_view. If flag is FALSE, the web_view will interpret tab key presses as normal key presses. If the selected element is editable, the tab key will cause the insertion of a tab character.	WebKit.WebSettings
	user_agent : String The User-Agent string used by WebKitGtk. The User-Agent string used by WebKitGtk. This will return a default User-Agent string if a custom string wasn't provided by the application. Setting this property to a NULL value or an empty string will result in the User-Agent string being reset to the default value.	WebKit.WebSettings
	user_stylesheet_uri : String	WebKit.WebSettings
	zoom_step : gfloat The value by which the zoom level is changed when zooming in or out. The value by which the zoom level is changed when zooming in or out.	WebKit.WebSettings

Methods / Constructors
Method / Constructor		Defined By
	new WebKit.WebSettings (Object *properties) Create a new WebKit.WebSettings Create a new WebKit.WebSettings Parameters: Object properties*
	copy () : WebKit.WebSettings Copies an existing WebKitWebSettings instance. Copies an existing WebKitWebSettings instance. Returns: WebKit.WebSettings a new WebKitWebSettings instance	WebKit.WebSettings
	get_user_agent () : String Returns the User-Agent string currently used by the web view(s) associated with the web_settings. Returns the User-Agent string currently used by the web view(s) associated with the web_settings. Returns: String	WebKit.WebSettings

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
WebKit.WebView Property	settings : WebKit.WebSettings
WebKit.WebView Method	get_settings () : WebKit.WebSettings Obtains the WebKitWebSettings associated with the WebKitWebView.
WebKit.WebView Method	set_settings (WebSettings *settings) : none Replaces the WebKitWebSettings* instance that is currently attached to web_view with settings.