diff options
Diffstat (limited to 'Documentation/webkit2gtk-4.0/html/WebKitWebContext.html')
| -rw-r--r-- | Documentation/webkit2gtk-4.0/html/WebKitWebContext.html | 2142 |
1 files changed, 2142 insertions, 0 deletions
diff --git a/Documentation/webkit2gtk-4.0/html/WebKitWebContext.html b/Documentation/webkit2gtk-4.0/html/WebKitWebContext.html new file mode 100644 index 000000000..6059cb29a --- /dev/null +++ b/Documentation/webkit2gtk-4.0/html/WebKitWebContext.html @@ -0,0 +1,2142 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>WebKitWebContext: WebKit2GTK+ Reference Manual</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> +<link rel="home" href="index.html" title="WebKit2GTK+ Reference Manual"> +<link rel="up" href="ch01.html" title="Class Overview"> +<link rel="prev" href="ch01.html" title="Class Overview"> +<link rel="next" href="WebKitWebView.html" title="WebKitWebView"> +<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> +<td width="100%" align="left" class="shortcuts"> +<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> + <a href="#WebKitWebContext.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> + <a href="#WebKitWebContext.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> + <a href="#WebKitWebContext.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span> + <a href="#WebKitWebContext.signals" class="shortcut">Signals</a></span> +</td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> +<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> +<td><a accesskey="p" href="ch01.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> +<td><a accesskey="n" href="WebKitWebView.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="WebKitWebContext"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="WebKitWebContext.top_of_page"></a>WebKitWebContext</span></h2> +<p>WebKitWebContext — Manages aspects common to all <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s</p> +</td> +<td class="gallery_image" valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="WebKitWebContext.functions"></a><h2>Functions</h2> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="functions_return"> +<col class="functions_name"> +</colgroup> +<tbody> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-default" title="webkit_web_context_get_default ()">webkit_web_context_get_default</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-new" title="webkit_web_context_new ()">webkit_web_context_new</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-new-ephemeral" title="webkit_web_context_new_ephemeral ()">webkit_web_context_new_ephemeral</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-new-with-website-data-manager" title="webkit_web_context_new_with_website_data_manager ()">webkit_web_context_new_with_website_data_manager</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-is-ephemeral" title="webkit_web_context_is_ephemeral ()">webkit_web_context_is_ephemeral</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="returnvalue">WebKitWebsiteDataManager</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-website-data-manager" title="webkit_web_context_get_website_data_manager ()">webkit_web_context_get_website_data_manager</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="returnvalue">WebKitCacheModel</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-cache-model" title="webkit_web_context_get_cache_model ()">webkit_web_context_get_cache_model</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-cache-model" title="webkit_web_context_set_cache_model ()">webkit_web_context_set_cache_model</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-web-process-count-limit" title="webkit_web_context_get_web_process_count_limit ()">webkit_web_context_get_web_process_count_limit</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-web-process-count-limit" title="webkit_web_context_set_web_process_count_limit ()">webkit_web_context_set_web_process_count_limit</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-clear-cache" title="webkit_web_context_clear_cache ()">webkit_web_context_clear_cache</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-network-proxy-settings" title="webkit_web_context_set_network_proxy_settings ()">webkit_web_context_set_network_proxy_settings</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="returnvalue">WebKitDownload</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-download-uri" title="webkit_web_context_download_uri ()">webkit_web_context_download_uri</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitCookieManager.html" title="WebKitCookieManager"><span class="returnvalue">WebKitCookieManager</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-cookie-manager" title="webkit_web_context_get_cookie_manager ()">webkit_web_context_get_cookie_manager</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitFaviconDatabase.html" title="WebKitFaviconDatabase"><span class="returnvalue">WebKitFaviconDatabase</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-favicon-database" title="webkit_web_context_get_favicon_database ()">webkit_web_context_get_favicon_database</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-favicon-database-directory" title="webkit_web_context_set_favicon_database_directory ()">webkit_web_context_set_favicon_database_directory</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-favicon-database-directory" title="webkit_web_context_get_favicon_database_directory ()">webkit_web_context_get_favicon_database_directory</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitSecurityManager.html" title="WebKitSecurityManager"><span class="returnvalue">WebKitSecurityManager</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-security-manager" title="webkit_web_context_get_security_manager ()">webkit_web_context_get_security_manager</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-additional-plugins-directory" title="webkit_web_context_set_additional_plugins_directory ()">webkit_web_context_set_additional_plugins_directory</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-plugins" title="webkit_web_context_get_plugins ()">webkit_web_context_get_plugins</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-plugins-finish" title="webkit_web_context_get_plugins_finish ()">webkit_web_context_get_plugins_finish</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-spell-checking-enabled" title="webkit_web_context_get_spell_checking_enabled ()">webkit_web_context_get_spell_checking_enabled</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-spell-checking-enabled" title="webkit_web_context_set_spell_checking_enabled ()">webkit_web_context_set_spell_checking_enabled</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-spell-checking-languages" title="webkit_web_context_get_spell_checking_languages ()">webkit_web_context_get_spell_checking_languages</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-spell-checking-languages" title="webkit_web_context_set_spell_checking_languages ()">webkit_web_context_set_spell_checking_languages</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-preferred-languages" title="webkit_web_context_set_preferred_languages ()">webkit_web_context_set_preferred_languages</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-tls-errors-policy" title="webkit_web_context_set_tls_errors_policy ()">webkit_web_context_set_tls_errors_policy</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="returnvalue">WebKitTLSErrorsPolicy</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-tls-errors-policy" title="webkit_web_context_get_tls_errors_policy ()">webkit_web_context_get_tls_errors_policy</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-web-extensions-directory" title="webkit_web_context_set_web_extensions_directory ()">webkit_web_context_set_web_extensions_directory</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-web-extensions-initialization-user-data" title="webkit_web_context_set_web_extensions_initialization_user_data ()">webkit_web_context_set_web_extensions_initialization_user_data</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-prefetch-dns" title="webkit_web_context_prefetch_dns ()">webkit_web_context_prefetch_dns</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-disk-cache-directory" title="webkit_web_context_set_disk_cache_directory ()">webkit_web_context_set_disk_cache_directory</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-allow-tls-certificate-for-host" title="webkit_web_context_allow_tls_certificate_for_host ()">webkit_web_context_allow_tls_certificate_for_host</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="returnvalue">WebKitProcessModel</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-process-model" title="webkit_web_context_get_process_model ()">webkit_web_context_get_process_model</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-process-model" title="webkit_web_context_set_process_model ()">webkit_web_context_set_process_model</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-initialize-notification-permissions" title="webkit_web_context_initialize_notification_permissions ()">webkit_web_context_initialize_notification_permissions</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<span class="c_punctuation">(</span><a class="link" href="WebKitWebContext.html#WebKitURISchemeRequestCallback" title="WebKitURISchemeRequestCallback ()">*WebKitURISchemeRequestCallback</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">void</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebContext.html#webkit-web-context-register-uri-scheme" title="webkit_web_context_register_uri_scheme ()">webkit_web_context_register_uri_scheme</a> <span class="c_punctuation">()</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.properties"></a><h2>Properties</h2> +<div class="informaltable"><table class="informaltable" border="0"> +<colgroup> +<col width="150px" class="properties_type"> +<col width="300px" class="properties_name"> +<col width="200px" class="properties_flags"> +</colgroup> +<tbody> +<tr> +<td class="property_type"> +<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext--local-storage-directory" title="The “local-storage-directory” property">local-storage-directory</a></td> +<td class="property_flags">Read / Write / Construct Only</td> +</tr> +<tr> +<td class="property_type"> +<a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext--website-data-manager" title="The “website-data-manager” property">website-data-manager</a></td> +<td class="property_flags">Read / Write / Construct Only</td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.signals"></a><h2>Signals</h2> +<div class="informaltable"><table class="informaltable" border="0"> +<colgroup> +<col width="150px" class="signals_return"> +<col width="300px" class="signals_name"> +<col width="200px" class="signals_flags"> +</colgroup> +<tbody> +<tr> +<td class="signal_type"><span class="returnvalue">void</span></td> +<td class="signal_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext-download-started" title="The “download-started” signal">download-started</a></td> +<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td> +</tr> +<tr> +<td class="signal_type"><span class="returnvalue">void</span></td> +<td class="signal_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext-initialize-notification-permissions" title="The “initialize-notification-permissions” signal">initialize-notification-permissions</a></td> +<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td> +</tr> +<tr> +<td class="signal_type"><span class="returnvalue">void</span></td> +<td class="signal_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext-initialize-web-extensions" title="The “initialize-web-extensions” signal">initialize-web-extensions</a></td> +<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.other"></a><h2>Types and Values</h2> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="name"> +<col class="description"> +</colgroup> +<tbody> +<tr> +<td class="datatype_keyword">struct</td> +<td class="function_name"><a class="link" href="WebKitWebContext.html#WebKitWebContext-struct" title="struct WebKitWebContext">WebKitWebContext</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel">WebKitCacheModel</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel">WebKitProcessModel</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy">WebKitTLSErrorsPolicy</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebContext.html#WebKitNetworkProxyMode" title="enum WebKitNetworkProxyMode">WebKitNetworkProxyMode</a></td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.object-hierarchy"></a><h2>Object Hierarchy</h2> +<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> + <span class="lineart">╰──</span> WebKitWebContext +</pre> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.description"></a><h2>Description</h2> +<p>The <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> manages all aspects common to all +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s.</p> +<p>You can define the <a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="type">WebKitCacheModel</span></a> and <a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="type">WebKitProcessModel</span></a> with +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-cache-model" title="webkit_web_context_set_cache_model ()"><code class="function">webkit_web_context_set_cache_model()</code></a> and +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-process-model" title="webkit_web_context_set_process_model ()"><code class="function">webkit_web_context_set_process_model()</code></a>, depending on the needs of +your application. You can access the <a class="link" href="WebKitSecurityManager.html" title="WebKitSecurityManager"><span class="type">WebKitSecurityManager</span></a> to specify +the behaviour of your application regarding security using +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-security-manager" title="webkit_web_context_get_security_manager ()"><code class="function">webkit_web_context_get_security_manager()</code></a>.</p> +<p>It is also possible to change your preferred language or enable +spell checking, using <a class="link" href="WebKitWebContext.html#webkit-web-context-set-preferred-languages" title="webkit_web_context_set_preferred_languages ()"><code class="function">webkit_web_context_set_preferred_languages()</code></a>, +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-spell-checking-languages" title="webkit_web_context_set_spell_checking_languages ()"><code class="function">webkit_web_context_set_spell_checking_languages()</code></a> and +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-spell-checking-enabled" title="webkit_web_context_set_spell_checking_enabled ()"><code class="function">webkit_web_context_set_spell_checking_enabled()</code></a>.</p> +<p>You can use <a class="link" href="WebKitWebContext.html#webkit-web-context-register-uri-scheme" title="webkit_web_context_register_uri_scheme ()"><code class="function">webkit_web_context_register_uri_scheme()</code></a> to register +custom URI schemes, and manage several other settings.</p> +<p>TLS certificate validation failure is now treated as a transport +error by default. To handle TLS failures differently, you can +connect to <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed-with-tls-errors" title="The “load-failed-with-tls-errors” signal"><span class="type">“load-failed-with-tls-errors”</span></a>. +Alternatively, you can use <a class="link" href="WebKitWebContext.html#webkit-web-context-set-tls-errors-policy" title="webkit_web_context_set_tls_errors_policy ()"><code class="function">webkit_web_context_set_tls_errors_policy()</code></a> +to set the policy <a class="link" href="WebKitWebContext.html#WEBKIT-TLS-ERRORS-POLICY-IGNORE:CAPS"><code class="literal">WEBKIT_TLS_ERRORS_POLICY_IGNORE</code></a>; however, this is +not appropriate for Internet applications.</p> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.functions_details"></a><h2>Functions</h2> +<div class="refsect2"> +<a name="webkit-web-context-get-default"></a><h3>webkit_web_context_get_default ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +webkit_web_context_get_default (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p>Gets the default web context</p> +<div class="refsect3"> +<a name="webkit-web-context-get-default.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-new"></a><h3>webkit_web_context_new ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +webkit_web_context_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p>Create a new <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p> +<div class="refsect3"> +<a name="webkit-web-context-new.returns"></a><h4>Returns</h4> +<p> a newly created <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. </p> +<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-new-ephemeral"></a><h3>webkit_web_context_new_ephemeral ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +webkit_web_context_new_ephemeral (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p>Create a new ephemeral <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. An ephemeral <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> is a context +created with an ephemeral <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>. This is just a convenient method +to create ephemeral contexts without having to create your own <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>. +All <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s associated with this context will also be ephemeral. Websites will +not store any data in the client storage. +This is normally used to implement private instances.</p> +<div class="refsect3"> +<a name="webkit-web-context-new-ephemeral.returns"></a><h4>Returns</h4> +<p> a new ephemeral <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. </p> +<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-new-with-website-data-manager"></a><h3>webkit_web_context_new_with_website_data_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +webkit_web_context_new_with_website_data_manager + (<em class="parameter"><code><a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> *manager</code></em>);</pre> +<p>Create a new <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> with a <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-new-with-website-data-manager.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>manager</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-new-with-website-data-manager.returns"></a><h4>Returns</h4> +<p> a newly created <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. </p> +<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-is-ephemeral"></a><h3>webkit_web_context_is_ephemeral ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_context_is_ephemeral (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get whether a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> is ephemeral.</p> +<div class="refsect3"> +<a name="webkit-web-context-is-ephemeral.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-is-ephemeral.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>context</code></em> +is ephemeral or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-website-data-manager"></a><h3>webkit_web_context_get_website_data_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="returnvalue">WebKitWebsiteDataManager</span></a> * +webkit_web_context_get_website_data_manager + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> of <em class="parameter"><code>context</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-website-data-manager.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-website-data-manager.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-cache-model"></a><h3>webkit_web_context_get_cache_model ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="returnvalue">WebKitCacheModel</span></a> +webkit_web_context_get_cache_model (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Returns the current cache model. For more information about this +value check the documentation of the function +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-cache-model" title="webkit_web_context_set_cache_model ()"><code class="function">webkit_web_context_set_cache_model()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-cache-model.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-cache-model.returns"></a><h4>Returns</h4> +<p> the current <a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="type">WebKitCacheModel</span></a></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-cache-model"></a><h3>webkit_web_context_set_cache_model ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_cache_model (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="type">WebKitCacheModel</span></a> cache_model</code></em>);</pre> +<p>Specifies a usage model for WebViews, which WebKit will use to +determine its caching behavior. All web views follow the cache +model. This cache model determines the RAM and disk space to use +for caching previously viewed content .</p> +<p>Research indicates that users tend to browse within clusters of +documents that hold resources in common, and to revisit previously +visited documents. WebKit and the frameworks below it include +built-in caches that take advantage of these patterns, +substantially improving document load speed in browsing +situations. The WebKit cache model controls the behaviors of all of +these caches, including various WebCore caches.</p> +<p>Browsers can improve document load speed substantially by +specifying <a class="link" href="WebKitWebContext.html#WEBKIT-CACHE-MODEL-WEB-BROWSER:CAPS"><code class="literal">WEBKIT_CACHE_MODEL_WEB_BROWSER</code></a>. Applications without a +browsing interface can reduce memory usage substantially by +specifying <a class="link" href="WebKitWebContext.html#WEBKIT-CACHE-MODEL-DOCUMENT-VIEWER:CAPS"><code class="literal">WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER</code></a>. The default value is +<a class="link" href="WebKitWebContext.html#WEBKIT-CACHE-MODEL-WEB-BROWSER:CAPS"><code class="literal">WEBKIT_CACHE_MODEL_WEB_BROWSER</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-cache-model.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>cache_model</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html#WebKitCacheModel" title="enum WebKitCacheModel"><span class="type">WebKitCacheModel</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-web-process-count-limit"></a><h3>webkit_web_context_get_web_process_count_limit ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> +webkit_web_context_get_web_process_count_limit + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Gets the maximum number of web processes that can be created at the same time for the <em class="parameter"><code>context</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-web-process-count-limit.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-web-process-count-limit.returns"></a><h4>Returns</h4> +<p> the maximum limit of web processes, or 0 if there isn't a limit.</p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-web-process-count-limit"></a><h3>webkit_web_context_set_web_process_count_limit ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_web_process_count_limit + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> limit</code></em>);</pre> +<p>Sets the maximum number of web processes that can be created at the same time for the <em class="parameter"><code>context</code></em> +. +The default value is 0 and means no limit.</p> +<p>This method **must be called before any web process has been created**, +as early as possible in your application. Calling it later will make +your application crash.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-web-process-count-limit.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>limit</p></td> +<td class="parameter_description"><p>the maximum number of web processes</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-clear-cache"></a><h3>webkit_web_context_clear_cache ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_clear_cache (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Clears all resources currently cached. +See also <a class="link" href="WebKitWebContext.html#webkit-web-context-set-cache-model" title="webkit_web_context_set_cache_model ()"><code class="function">webkit_web_context_set_cache_model()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-clear-cache.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-network-proxy-settings"></a><h3>webkit_web_context_set_network_proxy_settings ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_network_proxy_settings + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebContext.html#WebKitNetworkProxyMode" title="enum WebKitNetworkProxyMode"><span class="type">WebKitNetworkProxyMode</span></a> proxy_mode</code></em>, + <em class="parameter"><code><a class="link" href="WebKitNetworkProxySettings.html" title="WebKitNetworkProxySettings"><span class="type">WebKitNetworkProxySettings</span></a> *proxy_settings</code></em>);</pre> +<p>Set the network proxy settings to be used by connections started in <em class="parameter"><code>context</code></em> +. +By default <a class="link" href="WebKitWebContext.html#WEBKIT-NETWORK-PROXY-MODE-DEFAULT:CAPS"><code class="literal">WEBKIT_NETWORK_PROXY_MODE_DEFAULT</code></a> is used, which means that the +system settings will be used (<a href="../gio/GProxyResolver.html#g-proxy-resolver-get-default"><code class="function">g_proxy_resolver_get_default()</code></a>). +If you want to override the system default settings, you can either use +<a class="link" href="WebKitWebContext.html#WEBKIT-NETWORK-PROXY-MODE-NO-PROXY:CAPS"><code class="literal">WEBKIT_NETWORK_PROXY_MODE_NO_PROXY</code></a> to make sure no proxies are used at all, +or <a class="link" href="WebKitWebContext.html#WEBKIT-NETWORK-PROXY-MODE-CUSTOM:CAPS"><code class="literal">WEBKIT_NETWORK_PROXY_MODE_CUSTOM</code></a> to provide your own proxy settings. +When <em class="parameter"><code>proxy_mode</code></em> + is <a class="link" href="WebKitWebContext.html#WEBKIT-NETWORK-PROXY-MODE-CUSTOM:CAPS"><code class="literal">WEBKIT_NETWORK_PROXY_MODE_CUSTOM</code></a> <em class="parameter"><code>proxy_settings</code></em> + must be +a valid <a class="link" href="WebKitNetworkProxySettings.html" title="WebKitNetworkProxySettings"><span class="type">WebKitNetworkProxySettings</span></a>; otherwise, <em class="parameter"><code>proxy_settings</code></em> + must be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-network-proxy-settings.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>proxy_mode</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html#WebKitNetworkProxyMode" title="enum WebKitNetworkProxyMode"><span class="type">WebKitNetworkProxyMode</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>proxy_settings</p></td> +<td class="parameter_description"><p> a <a class="link" href="WebKitNetworkProxySettings.html" title="WebKitNetworkProxySettings"><span class="type">WebKitNetworkProxySettings</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-download-uri"></a><h3>webkit_web_context_download_uri ()</h3> +<pre class="programlisting"><a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="returnvalue">WebKitDownload</span></a> * +webkit_web_context_download_uri (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre> +<p>Requests downloading of the specified URI string. The download operation +will not be associated to any <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>, if you are interested in +starting a download from a particular <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> use +<a class="link" href="WebKitWebView.html#webkit-web-view-download-uri" title="webkit_web_view_download_uri ()"><code class="function">webkit_web_view_download_uri()</code></a> instead.</p> +<div class="refsect3"> +<a name="webkit-web-context-download-uri.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>uri</p></td> +<td class="parameter_description"><p>the URI to download</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-download-uri.returns"></a><h4>Returns</h4> +<p> a new <a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="type">WebKitDownload</span></a> representing the +the download operation. </p> +<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-cookie-manager"></a><h3>webkit_web_context_get_cookie_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitCookieManager.html" title="WebKitCookieManager"><span class="returnvalue">WebKitCookieManager</span></a> * +webkit_web_context_get_cookie_manager (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the <a class="link" href="WebKitCookieManager.html" title="WebKitCookieManager"><span class="type">WebKitCookieManager</span></a> of the <em class="parameter"><code>context</code></em> +'s <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-cookie-manager.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-cookie-manager.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitCookieManager.html" title="WebKitCookieManager"><span class="type">WebKitCookieManager</span></a> of <em class="parameter"><code>context</code></em> +. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-favicon-database"></a><h3>webkit_web_context_get_favicon_database ()</h3> +<pre class="programlisting"><a class="link" href="WebKitFaviconDatabase.html" title="WebKitFaviconDatabase"><span class="returnvalue">WebKitFaviconDatabase</span></a> * +webkit_web_context_get_favicon_database + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the <a class="link" href="WebKitFaviconDatabase.html" title="WebKitFaviconDatabase"><span class="type">WebKitFaviconDatabase</span></a> associated with <em class="parameter"><code>context</code></em> +.</p> +<p>To initialize the database you need to call +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-favicon-database-directory" title="webkit_web_context_set_favicon_database_directory ()"><code class="function">webkit_web_context_set_favicon_database_directory()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-favicon-database.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-favicon-database.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitFaviconDatabase.html" title="WebKitFaviconDatabase"><span class="type">WebKitFaviconDatabase</span></a> of <em class="parameter"><code>context</code></em> +. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-favicon-database-directory"></a><h3>webkit_web_context_set_favicon_database_directory ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_favicon_database_directory + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre> +<p>Set the directory path to be used to store the favicons database +for <em class="parameter"><code>context</code></em> + on disk. Passing <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as <em class="parameter"><code>path</code></em> + means using the +default directory for the platform (see <a href="../glib/glib-Miscellaneous-Utility-Functions.html#g-get-user-data-dir"><code class="function">g_get_user_data_dir()</code></a>).</p> +<p>Calling this method also means enabling the favicons database for +its use from the applications, so that's why it's expected to be +called only once. Further calls for the same instance of +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> won't cause any effect.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-favicon-database-directory.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>path</p></td> +<td class="parameter_description"><p> an absolute path to the icon database +directory or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the defaults. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-favicon-database-directory"></a><h3>webkit_web_context_get_favicon_database_directory ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_web_context_get_favicon_database_directory + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the directory path being used to store the favicons database +for <em class="parameter"><code>context</code></em> +, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-favicon-database-directory" title="webkit_web_context_set_favicon_database_directory ()"><code class="function">webkit_web_context_set_favicon_database_directory()</code></a> hasn't been +called yet.</p> +<p>This function will always return the same path after having called +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-favicon-database-directory" title="webkit_web_context_set_favicon_database_directory ()"><code class="function">webkit_web_context_set_favicon_database_directory()</code></a> for the first +time.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-favicon-database-directory.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-favicon-database-directory.returns"></a><h4>Returns</h4> +<p> the path of the directory of the favicons +database associated with <em class="parameter"><code>context</code></em> +, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-security-manager"></a><h3>webkit_web_context_get_security_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitSecurityManager.html" title="WebKitSecurityManager"><span class="returnvalue">WebKitSecurityManager</span></a> * +webkit_web_context_get_security_manager + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the <a class="link" href="WebKitSecurityManager.html" title="WebKitSecurityManager"><span class="type">WebKitSecurityManager</span></a> of <em class="parameter"><code>context</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-security-manager.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-security-manager.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitSecurityManager.html" title="WebKitSecurityManager"><span class="type">WebKitSecurityManager</span></a> of <em class="parameter"><code>context</code></em> +. </p> +<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-additional-plugins-directory"></a><h3>webkit_web_context_set_additional_plugins_directory ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_additional_plugins_directory + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *directory</code></em>);</pre> +<p>Set an additional directory where WebKit will look for plugins.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-additional-plugins-directory.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>directory</p></td> +<td class="parameter_description"><p>the directory to add</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-plugins"></a><h3>webkit_web_context_get_plugins ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_get_plugins (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p>Asynchronously get the list of installed plugins.</p> +<p>When the operation is finished, <em class="parameter"><code>callback</code></em> + will be called. You can then call +<a class="link" href="WebKitWebContext.html#webkit-web-context-get-plugins-finish" title="webkit_web_context_get_plugins_finish ()"><code class="function">webkit_web_context_get_plugins_finish()</code></a> to get the result of the operation.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-plugins.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>cancellable</p></td> +<td class="parameter_description"><p> a <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>callback</p></td> +<td class="parameter_description"><p> a <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p> the data to pass to callback function. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-plugins-finish"></a><h3>webkit_web_context_get_plugins_finish ()</h3> +<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * +webkit_web_context_get_plugins_finish (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *result</code></em>, + <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p>Finish an asynchronous operation started with webkit_web_context_get_plugins.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-plugins-finish.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>result</p></td> +<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>error</p></td> +<td class="parameter_description"><p>return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-plugins-finish.returns"></a><h4>Returns</h4> +<p> a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="WebKitPlugin.html" title="WebKitPlugin"><span class="type">WebKitPlugin</span></a>. You must free the <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> with +<a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> and unref the <a class="link" href="WebKitPlugin.html" title="WebKitPlugin"><span class="type">WebKitPlugin</span></a>s with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when you're done with them. </p> +<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> WebKitPlugin][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-spell-checking-enabled"></a><h3>webkit_web_context_get_spell_checking_enabled ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_context_get_spell_checking_enabled + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get whether spell checking feature is currently enabled.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-spell-checking-enabled.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-spell-checking-enabled.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> If spell checking is enabled, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-spell-checking-enabled"></a><h3>webkit_web_context_set_spell_checking_enabled ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_spell_checking_enabled + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>);</pre> +<p>Enable or disable the spell checking feature.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-spell-checking-enabled.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>enabled</p></td> +<td class="parameter_description"><p>Value to be set</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-spell-checking-languages"></a><h3>webkit_web_context_get_spell_checking_languages ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * +webkit_web_context_get_spell_checking_languages + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the the list of spell checking languages associated with +<em class="parameter"><code>context</code></em> +, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no languages have been previously set.</p> +<p>See <a class="link" href="WebKitWebContext.html#webkit-web-context-set-spell-checking-languages" title="webkit_web_context_set_spell_checking_languages ()"><code class="function">webkit_web_context_set_spell_checking_languages()</code></a> for more +details on the format of the languages in the list.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-spell-checking-languages.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-spell-checking-languages.returns"></a><h4>Returns</h4> +<p> A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated +array of languages if available, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise. </p> +<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-spell-checking-languages"></a><h3>webkit_web_context_set_spell_checking_languages ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_spell_checking_languages + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *languages</code></em>);</pre> +<p>Set the list of spell checking languages to be used for spell +checking.</p> +<p>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.</p> +<p>You need to call this function with a valid list of languages at +least once in order to properly enable the spell checking feature +in WebKit.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-spell-checking-languages.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>languages</p></td> +<td class="parameter_description"><p> a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of spell checking languages. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-preferred-languages"></a><h3>webkit_web_context_set_preferred_languages ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_preferred_languages + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *languages</code></em>);</pre> +<p>Set the list of preferred languages, sorted from most desirable +to least desirable. The list will be used to build the "Accept-Language" +header that will be included in the network requests started by +the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-preferred-languages.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>languages</p></td> +<td class="parameter_description"><p> a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of language identifiers. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-tls-errors-policy"></a><h3>webkit_web_context_set_tls_errors_policy ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_tls_errors_policy + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="type">WebKitTLSErrorsPolicy</span></a> policy</code></em>);</pre> +<p>Set the TLS errors policy of <em class="parameter"><code>context</code></em> + as <em class="parameter"><code>policy</code></em> +</p> +<div class="refsect3"> +<a name="webkit-web-context-set-tls-errors-policy.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>policy</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="type">WebKitTLSErrorsPolicy</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-tls-errors-policy"></a><h3>webkit_web_context_get_tls_errors_policy ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="returnvalue">WebKitTLSErrorsPolicy</span></a> +webkit_web_context_get_tls_errors_policy + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Get the TLS errors policy of <em class="parameter"><code>context</code></em> +</p> +<div class="refsect3"> +<a name="webkit-web-context-get-tls-errors-policy.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-tls-errors-policy.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="type">WebKitTLSErrorsPolicy</span></a></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-web-extensions-directory"></a><h3>webkit_web_context_set_web_extensions_directory ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_web_extensions_directory + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *directory</code></em>);</pre> +<p>Set the directory where WebKit will look for Web Extensions. +This method must be called before loading anything in this context, +otherwise it will not have any effect. You can connect to +<a class="link" href="WebKitWebContext.html#WebKitWebContext-initialize-web-extensions" title="The “initialize-web-extensions” signal"><span class="type">“initialize-web-extensions”</span></a> to call this method +before anything is loaded.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-web-extensions-directory.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>directory</p></td> +<td class="parameter_description"><p>the directory to add</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-web-extensions-initialization-user-data"></a><h3>webkit_web_context_set_web_extensions_initialization_user_data ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_web_extensions_initialization_user_data + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *user_data</code></em>);</pre> +<p>Set user data to be passed to Web Extensions on initialization. +The data will be passed to the +<a class="link" href="WebKitWebExtension.html#WebKitWebExtensionInitializeWithUserDataFunction" title="WebKitWebExtensionInitializeWithUserDataFunction ()"><span class="type">WebKitWebExtensionInitializeWithUserDataFunction</span></a>. +This method must be called before loading anything in this context, +otherwise it will not have any effect. You can connect to +<a class="link" href="WebKitWebContext.html#WebKitWebContext-initialize-web-extensions" title="The “initialize-web-extensions” signal"><span class="type">“initialize-web-extensions”</span></a> to call this method +before anything is loaded.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-web-extensions-initialization-user-data.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-prefetch-dns"></a><h3>webkit_web_context_prefetch_dns ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_prefetch_dns (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre> +<p>Resolve the domain name of the given <em class="parameter"><code>hostname</code></em> + in advance, so that if a URI +of <em class="parameter"><code>hostname</code></em> + is requested the load will be performed more quickly.</p> +<div class="refsect3"> +<a name="webkit-web-context-prefetch-dns.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>hostname</p></td> +<td class="parameter_description"><p>a hostname to be resolved</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-disk-cache-directory"></a><h3>webkit_web_context_set_disk_cache_directory ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_disk_cache_directory + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *directory</code></em>);</pre> +<div class="warning"> +<p><code class="literal">webkit_web_context_set_disk_cache_directory</code> has been deprecated since version 2.10. and should not be used in newly-written code.</p> +<p>Use <a class="link" href="WebKitWebContext.html#webkit-web-context-new-with-website-data-manager" title="webkit_web_context_new_with_website_data_manager ()"><code class="function">webkit_web_context_new_with_website_data_manager()</code></a> instead.</p> +</div> +<p>Set the directory where disk cache files will be stored +This method must be called before loading anything in this context, otherwise +it will not have any effect.</p> +<p>Note that this method overrides the directory set in the <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a>, +but it doesn't change the value returned by <a class="link" href="WebKitWebsiteDataManager.html#webkit-website-data-manager-get-disk-cache-directory" title="webkit_website_data_manager_get_disk_cache_directory ()"><code class="function">webkit_website_data_manager_get_disk_cache_directory()</code></a> +since the <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> is immutable.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-disk-cache-directory.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>directory</p></td> +<td class="parameter_description"><p>the directory to set</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-allow-tls-certificate-for-host"></a><h3>webkit_web_context_allow_tls_certificate_for_host ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_allow_tls_certificate_for_host + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a> *certificate</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host</code></em>);</pre> +<p>Ignore further TLS errors on the <em class="parameter"><code>host</code></em> + for the certificate present in <em class="parameter"><code>info</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-context-allow-tls-certificate-for-host.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>certificate</p></td> +<td class="parameter_description"><p>a <a href="../gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>host</p></td> +<td class="parameter_description"><p>the host for which a certificate is to be allowed</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-get-process-model"></a><h3>webkit_web_context_get_process_model ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="returnvalue">WebKitProcessModel</span></a> +webkit_web_context_get_process_model (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Returns the current process model. For more information about this value +see <a class="link" href="WebKitWebContext.html#webkit-web-context-set-process-model" title="webkit_web_context_set_process_model ()"><code class="function">webkit_web_context_set_process_model()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-context-get-process-model.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody><tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-context-get-process-model.returns"></a><h4>Returns</h4> +<p> the current <a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="type">WebKitProcessModel</span></a></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-set-process-model"></a><h3>webkit_web_context_set_process_model ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_set_process_model (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="type">WebKitProcessModel</span></a> process_model</code></em>);</pre> +<p>Specifies a process model for WebViews, which WebKit will use to +determine how auxiliary processes are handled. The default setting +(<a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-SHARED-SECONDARY-PROCESS:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_SHARED_SECONDARY_PROCESS</code></a>) is suitable for most +applications which embed a small amount of WebViews, or are used to +display documents which are considered safe — like local files.</p> +<p>Applications which may potentially use a large amount of WebViews +—for example a multi-tabbed web browser— may want to use +<a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-MULTIPLE-SECONDARY-PROCESSES:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES</code></a>, which will use +one process per view most of the time, while still allowing for web +views to share a process when needed (for example when different +views interact with each other). Using this model, when a process +hangs or crashes, only the WebViews using it stop working, while +the rest of the WebViews in the application will still function +normally.</p> +<p>This method **must be called before any web process has been created**, +as early as possible in your application. Calling it later will make +your application crash.</p> +<div class="refsect3"> +<a name="webkit-web-context-set-process-model.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>process_model</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html#WebKitProcessModel" title="enum WebKitProcessModel"><span class="type">WebKitProcessModel</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-initialize-notification-permissions"></a><h3>webkit_web_context_initialize_notification_permissions ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_initialize_notification_permissions + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *allowed_origins</code></em>, + <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *disallowed_origins</code></em>);</pre> +<p>Sets initial desktop notification permissions for the <em class="parameter"><code>context</code></em> +. +<em class="parameter"><code>allowed_origins</code></em> + and <em class="parameter"><code>disallowed_origins</code></em> + must each be <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of +<a class="link" href="WebKitSecurityOrigin.html" title="WebKitSecurityOrigin"><span class="type">WebKitSecurityOrigin</span></a> objects representing origins that will, +respectively, either always or never have permission to show desktop +notifications. No <a class="link" href="WebKitNotificationPermissionRequest.html" title="WebKitNotificationPermissionRequest"><span class="type">WebKitNotificationPermissionRequest</span></a> will ever be +generated for any of the security origins represented in +<em class="parameter"><code>allowed_origins</code></em> + or <em class="parameter"><code>disallowed_origins</code></em> +. This function is necessary +because some webpages proactively check whether they have permission +to display notifications without ever creating a permission request.</p> +<p>This function only affects web processes that have not already been +created. The best time to call it is when handling +<a class="link" href="WebKitWebContext.html#WebKitWebContext-initialize-notification-permissions" title="The “initialize-notification-permissions” signal"><span class="type">“initialize-notification-permissions”</span></a> so as to +ensure that new web processes receive the most recent set of +permissions.</p> +<div class="refsect3"> +<a name="webkit-web-context-initialize-notification-permissions.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>allowed_origins</p></td> +<td class="parameter_description"><p> a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of security origins. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> WebKitSecurityOrigin]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>disallowed_origins</p></td> +<td class="parameter_description"><p> a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of security origins. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> WebKitSecurityOrigin]</span></td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitURISchemeRequestCallback"></a><h3>WebKitURISchemeRequestCallback ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +<span class="c_punctuation">(</span>*WebKitURISchemeRequestCallback<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="WebKitURISchemeRequest.html" title="WebKitURISchemeRequest"><span class="type">WebKitURISchemeRequest</span></a> *request</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p>Type definition for a function that will be called back when an URI request is +made for a user registered URI scheme.</p> +<div class="refsect3"> +<a name="WebKitURISchemeRequestCallback.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitURISchemeRequest.html" title="WebKitURISchemeRequest"><span class="type">WebKitURISchemeRequest</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>user data passed to the callback</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-context-register-uri-scheme"></a><h3>webkit_web_context_register_uri_scheme ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_context_register_uri_scheme + (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebContext.html#WebKitURISchemeRequestCallback" title="WebKitURISchemeRequestCallback ()"><span class="type">WebKitURISchemeRequestCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code><a href="../glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> user_data_destroy_func</code></em>);</pre> +<p>Register <em class="parameter"><code>scheme</code></em> + in <em class="parameter"><code>context</code></em> +, so that when an URI request with <em class="parameter"><code>scheme</code></em> + is made in the +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>, the <a class="link" href="WebKitWebContext.html#WebKitURISchemeRequestCallback" title="WebKitURISchemeRequestCallback ()"><span class="type">WebKitURISchemeRequestCallback</span></a> registered will be called with a +<a class="link" href="WebKitURISchemeRequest.html" title="WebKitURISchemeRequest"><span class="type">WebKitURISchemeRequest</span></a>. +It is possible to handle URI scheme requests asynchronously, by calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on the +<a class="link" href="WebKitURISchemeRequest.html" title="WebKitURISchemeRequest"><span class="type">WebKitURISchemeRequest</span></a> and calling <a class="link" href="WebKitURISchemeRequest.html#webkit-uri-scheme-request-finish" title="webkit_uri_scheme_request_finish ()"><code class="function">webkit_uri_scheme_request_finish()</code></a> later +when the data of the request is available or +<a class="link" href="WebKitURISchemeRequest.html#webkit-uri-scheme-request-finish-error" title="webkit_uri_scheme_request_finish_error ()"><code class="function">webkit_uri_scheme_request_finish_error()</code></a> in case of error.</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span> +about_uri_scheme_request_cb (WebKitURISchemeRequest *request, + gpointer user_data) +{ + GInputStream *stream; + gsize stream_length; + <span class="type">const</span> gchar *path; + + path = webkit_uri_scheme_request_get_path (request); + <span class="keyword">if</span> (!g_strcmp0 (path, <span class="number">"plugins"</span>)) { + <span class="comment">/*</span><span class="comment"> Create a GInputStream with the contents of plugins about page, and set its length to stream_length </span><span class="comment">*/</span> + } <span class="keyword">else</span> <span class="keyword">if</span> (!g_strcmp0 (path, <span class="number">"memory"</span>)) { + <span class="comment">/*</span><span class="comment"> Create a GInputStream with the contents of memory about page, and set its length to stream_length </span><span class="comment">*/</span> + } <span class="keyword">else</span> <span class="keyword">if</span> (!g_strcmp0 (path, <span class="number">"applications"</span>)) { + <span class="comment">/*</span><span class="comment"> Create a GInputStream with the contents of applications about page, and set its length to stream_length </span><span class="comment">*/</span> + } <span class="keyword">else</span> <span class="keyword">if</span> (!g_strcmp0 (path, <span class="number">"example"</span>)) { + gchar *contents; + + contents = g_strdup_printf (<span class="number">"<html><body><p>Example about page</p></body></html>"</span>); + stream_length = strlen (contents); + stream = g_memory_input_stream_new_from_data (contents, stream_length, g_free); + } <span class="keyword">else</span> { + GError *error; + + error = g_error_new (ABOUT_HANDLER_ERROR, ABOUT_HANDLER_ERROR_INVALID, <span class="number">"Invalid about:</span><span class="symbol">%s</span><span class="number"> page."</span>, path); + webkit_uri_scheme_request_finish_error (request, error); + g_error_free (error); + <span class="keyword">return</span>; + } + webkit_uri_scheme_request_finish (request, stream, stream_length, <span class="number">"text/html"</span>); + g_object_unref (stream); +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<div class="refsect3"> +<a name="webkit-web-context-register-uri-scheme.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>scheme</p></td> +<td class="parameter_description"><p>the network scheme to register</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>callback</p></td> +<td class="parameter_description"><p> a <a class="link" href="WebKitWebContext.html#WebKitURISchemeRequestCallback" title="WebKitURISchemeRequestCallback ()"><span class="type">WebKitURISchemeRequestCallback</span></a>. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>data to pass to callback function</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data_destroy_func</p></td> +<td class="parameter_description"><p>destroy notify for <em class="parameter"><code>user_data</code></em> +</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.other_details"></a><h2>Types and Values</h2> +<div class="refsect2"> +<a name="WebKitWebContext-struct"></a><h3>struct WebKitWebContext</h3> +<pre class="programlisting">struct WebKitWebContext;</pre> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitCacheModel"></a><h3>enum WebKitCacheModel</h3> +<p>Enum values used for determining the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> cache model.</p> +<div class="refsect3"> +<a name="WebKitCacheModel.members"></a><h4>Members</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="300px" class="enum_members_name"> +<col class="enum_members_description"> +<col width="200px" class="enum_members_annotations"> +</colgroup> +<tbody> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-CACHE-MODEL-DOCUMENT-VIEWER:CAPS"></a>WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER</p></td> +<td class="enum_member_description"> +<p>Disable the cache completely, which + substantially reduces memory usage. Useful for applications that only + access a single local file, with no navigation to other pages. No remote + resources will be cached.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-CACHE-MODEL-WEB-BROWSER:CAPS"></a>WEBKIT_CACHE_MODEL_WEB_BROWSER</p></td> +<td class="enum_member_description"> +<p>Improve document load speed substantially + by caching a very large number of resources and previously viewed content.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-CACHE-MODEL-DOCUMENT-BROWSER:CAPS"></a>WEBKIT_CACHE_MODEL_DOCUMENT_BROWSER</p></td> +<td class="enum_member_description"> +<p>A cache model optimized for viewing + a series of local files -- for example, a documentation viewer or a website + designer. WebKit will cache a moderate number of resources.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitProcessModel"></a><h3>enum WebKitProcessModel</h3> +<p>Enum values used for determining the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> process model.</p> +<div class="refsect3"> +<a name="WebKitProcessModel.members"></a><h4>Members</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="300px" class="enum_members_name"> +<col class="enum_members_description"> +<col width="200px" class="enum_members_annotations"> +</colgroup> +<tbody> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-PROCESS-MODEL-SHARED-SECONDARY-PROCESS:CAPS"></a>WEBKIT_PROCESS_MODEL_SHARED_SECONDARY_PROCESS</p></td> +<td class="enum_member_description"> +<p>Use a single process to + perform content rendering. The process is shared among all the + <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> instances created by the application: if the process + hangs or crashes all the web views in the application will be affected. + This is the default process model, and it should suffice for most cases.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-PROCESS-MODEL-MULTIPLE-SECONDARY-PROCESSES:CAPS"></a>WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES</p></td> +<td class="enum_member_description"> +<p>Use one process + for each <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>, while still allowing for some of them to + share a process in certain situations. The main advantage + of this process model is that the rendering process for a web view + can crash while the rest of the views keep working normally. This + process model is indicated for applications which may use a number + of web views and the content of in each must not interfere with the + rest — for example a full-fledged web browser with support for + multiple tabs.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitTLSErrorsPolicy"></a><h3>enum WebKitTLSErrorsPolicy</h3> +<p>Enum values used to denote the TLS errors policy.</p> +<div class="refsect3"> +<a name="WebKitTLSErrorsPolicy.members"></a><h4>Members</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="300px" class="enum_members_name"> +<col class="enum_members_description"> +<col width="200px" class="enum_members_annotations"> +</colgroup> +<tbody> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-TLS-ERRORS-POLICY-IGNORE:CAPS"></a>WEBKIT_TLS_ERRORS_POLICY_IGNORE</p></td> +<td class="enum_member_description"> +<p>Ignore TLS errors.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-TLS-ERRORS-POLICY-FAIL:CAPS"></a>WEBKIT_TLS_ERRORS_POLICY_FAIL</p></td> +<td class="enum_member_description"> +<p>TLS errors will emit + <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed-with-tls-errors" title="The “load-failed-with-tls-errors” signal"><span class="type">“load-failed-with-tls-errors”</span></a> and, if the signal is handled, + finish the load. In case the signal is not handled, + <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal"><span class="type">“load-failed”</span></a> is emitted before the load finishes.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitNetworkProxyMode"></a><h3>enum WebKitNetworkProxyMode</h3> +<p>Enum values used to set the network proxy mode.</p> +<div class="refsect3"> +<a name="WebKitNetworkProxyMode.members"></a><h4>Members</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="300px" class="enum_members_name"> +<col class="enum_members_description"> +<col width="200px" class="enum_members_annotations"> +</colgroup> +<tbody> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-NETWORK-PROXY-MODE-DEFAULT:CAPS"></a>WEBKIT_NETWORK_PROXY_MODE_DEFAULT</p></td> +<td class="enum_member_description"> +<p>Use the default proxy of the system.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-NETWORK-PROXY-MODE-NO-PROXY:CAPS"></a>WEBKIT_NETWORK_PROXY_MODE_NO_PROXY</p></td> +<td class="enum_member_description"> +<p>Do not use any proxy.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-NETWORK-PROXY-MODE-CUSTOM:CAPS"></a>WEBKIT_NETWORK_PROXY_MODE_CUSTOM</p></td> +<td class="enum_member_description"> +<p>Use custom proxy settings.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.property-details"></a><h2>Property Details</h2> +<div class="refsect2"> +<a name="WebKitWebContext--local-storage-directory"></a><h3>The <code class="literal">“local-storage-directory”</code> property</h3> +<pre class="programlisting"> “local-storage-directory” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<p>The directory where local storage data will be saved.</p> +<div class="warning"> +<p><code class="literal">WebKitWebContext:local-storage-directory</code> has been deprecated since version 2.10. and should not be used in newly-written code.</p> +<p>Use <a class="link" href="WebKitWebsiteDataManager.html#WebKitWebsiteDataManager--local-storage-directory" title="The “local-storage-directory” property"><span class="type">“local-storage-directory”</span></a> instead.</p> +</div> +<p>Flags: Read / Write / Construct Only</p> +<p>Default value: NULL</p> +<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebContext--website-data-manager"></a><h3>The <code class="literal">“website-data-manager”</code> property</h3> +<pre class="programlisting"> “website-data-manager” <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> *</pre> +<p>The <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> associated with this context.</p> +<p>Flags: Read / Write / Construct Only</p> +<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebContext.signal-details"></a><h2>Signal Details</h2> +<div class="refsect2"> +<a name="WebKitWebContext-download-started"></a><h3>The <code class="literal">“download-started”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context, + <a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="type">WebKitDownload</span></a> *download, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when a new download request is made.</p> +<div class="refsect3"> +<a name="WebKitWebContext-download-started.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>download</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="type">WebKitDownload</span></a> associated with this event</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebContext-initialize-notification-permissions"></a><h3>The <code class="literal">“initialize-notification-permissions”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when a <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> needs to set +initial notification permissions for a web process. It is emitted +when a new web process is about to be launched, and signals the +most appropriate moment to use +<a class="link" href="WebKitWebContext.html#webkit-web-context-initialize-notification-permissions" title="webkit_web_context_initialize_notification_permissions ()"><code class="function">webkit_web_context_initialize_notification_permissions()</code></a>. If no +notification permissions have changed since the last time this +signal was emitted, then there is no need to call +<a class="link" href="WebKitWebContext.html#webkit-web-context-initialize-notification-permissions" title="webkit_web_context_initialize_notification_permissions ()"><code class="function">webkit_web_context_initialize_notification_permissions()</code></a> again.</p> +<div class="refsect3"> +<a name="WebKitWebContext-initialize-notification-permissions.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p> +<p class="since">Since: <a class="link" href="api-index-2-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebContext-initialize-web-extensions"></a><h3>The <code class="literal">“initialize-web-extensions”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when a new web process is about to be +launched. It signals the most appropriate moment to use +<a class="link" href="WebKitWebContext.html#webkit-web-context-set-web-extensions-initialization-user-data" title="webkit_web_context_set_web_extensions_initialization_user_data ()"><code class="function">webkit_web_context_set_web_extensions_initialization_user_data()</code></a> +and <a class="link" href="WebKitWebContext.html#webkit-web-context-set-web-extensions-directory" title="webkit_web_context_set_web_extensions_directory ()"><code class="function">webkit_web_context_set_web_extensions_directory()</code></a>.</p> +<div class="refsect3"> +<a name="WebKitWebContext-initialize-web-extensions.parameters"></a><h4>Parameters</h4> +<div class="informaltable"><table class="informaltable" width="100%" border="0"> +<colgroup> +<col width="150px" class="parameters_name"> +<col class="parameters_description"> +<col width="200px" class="parameters_annotations"> +</colgroup> +<tbody> +<tr> +<td class="parameter_name"><p>context</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>user_data</p></td> +<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p> +<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> +</div> +</div> +</div> +<div class="footer"> +<hr>Generated by GTK-Doc V1.25.1</div> +</body> +</html>
\ No newline at end of file |
