diff options
Diffstat (limited to 'Documentation/webkit2gtk-4.0/html/WebKitWebView.html')
-rw-r--r-- | Documentation/webkit2gtk-4.0/html/WebKitWebView.html | 5932 |
1 files changed, 5932 insertions, 0 deletions
diff --git a/Documentation/webkit2gtk-4.0/html/WebKitWebView.html b/Documentation/webkit2gtk-4.0/html/WebKitWebView.html new file mode 100644 index 000000000..a73bd7034 --- /dev/null +++ b/Documentation/webkit2gtk-4.0/html/WebKitWebView.html @@ -0,0 +1,5932 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>WebKitWebView: 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="WebKitWebContext.html" title="WebKitWebContext"> +<link rel="next" href="WebKitAuthenticationRequest.html" title="WebKitAuthenticationRequest"> +<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="#WebKitWebView.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> + <a href="#WebKitWebView.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> + <a href="#WebKitWebView.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> + <a href="#WebKitWebView.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span> + <a href="#WebKitWebView.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="WebKitWebContext.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> +<td><a accesskey="n" href="WebKitAuthenticationRequest.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="WebKitWebView"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="WebKitWebView.top_of_page"></a>WebKitWebView</span></h2> +<p>WebKitWebView — The central class of the WebKit2GTK+ API</p> +</td> +<td class="gallery_image" valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="WebKitWebView.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 href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-new" title="webkit_web_view_new ()">webkit_web_view_new</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-context" title="webkit_web_view_new_with_context ()">webkit_web_view_new_with_context</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-related-view" title="webkit_web_view_new_with_related_view ()">webkit_web_view_new_with_related_view</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-settings" title="webkit_web_view_new_with_settings ()">webkit_web_view_new_with_settings</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-user-content-manager" title="webkit_web_view_new_with_user_content_manager ()">webkit_web_view_new_with_user_content_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="WebKitWebView.html#webkit-web-view-is-ephemeral" title="webkit_web_view_is_ephemeral ()">webkit_web_view_is_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="WebKitWebView.html#webkit-web-view-get-context" title="webkit_web_view_get_context ()">webkit_web_view_get_context</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="returnvalue">WebKitUserContentManager</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-user-content-manager" title="webkit_web_view_get_user_content_manager ()">webkit_web_view_get_user_content_manager</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="WebKitWebView.html#webkit-web-view-get-website-data-manager" title="webkit_web_view_get_website_data_manager ()">webkit_web_view_get_website_data_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="WebKitWebView.html#webkit-web-view-try-close" title="webkit_web_view_try_close ()">webkit_web_view_try_close</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="WebKitWebView.html#webkit-web-view-load-uri" title="webkit_web_view_load_uri ()">webkit_web_view_load_uri</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="WebKitWebView.html#webkit-web-view-load-html" title="webkit_web_view_load_html ()">webkit_web_view_load_html</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="WebKitWebView.html#webkit-web-view-load-alternate-html" title="webkit_web_view_load_alternate_html ()">webkit_web_view_load_alternate_html</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="WebKitWebView.html#webkit-web-view-load-plain-text" title="webkit_web_view_load_plain_text ()">webkit_web_view_load_plain_text</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="WebKitWebView.html#webkit-web-view-load-bytes" title="webkit_web_view_load_bytes ()">webkit_web_view_load_bytes</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="WebKitWebView.html#webkit-web-view-load-request" title="webkit_web_view_load_request ()">webkit_web_view_load_request</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="WebKitWebView.html#webkit-web-view-can-go-back" title="webkit_web_view_can_go_back ()">webkit_web_view_can_go_back</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="WebKitWebView.html#webkit-web-view-go-back" title="webkit_web_view_go_back ()">webkit_web_view_go_back</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="WebKitWebView.html#webkit-web-view-can-go-forward" title="webkit_web_view_can_go_forward ()">webkit_web_view_can_go_forward</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="WebKitWebView.html#webkit-web-view-go-forward" title="webkit_web_view_go_forward ()">webkit_web_view_go_forward</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="WebKitWebView.html#webkit-web-view-get-title" title="webkit_web_view_get_title ()">webkit_web_view_get_title</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-page-id" title="webkit_web_view_get_page_id ()">webkit_web_view_get_page_id</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="WebKitWebView.html#webkit-web-view-reload" title="webkit_web_view_reload ()">webkit_web_view_reload</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="WebKitWebView.html#webkit-web-view-reload-bypass-cache" title="webkit_web_view_reload_bypass_cache ()">webkit_web_view_reload_bypass_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="WebKitWebView.html#webkit-web-view-stop-loading" title="webkit_web_view_stop_loading ()">webkit_web_view_stop_loading</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="WebKitWebView.html#webkit-web-view-is-loading" title="webkit_web_view_is_loading ()">webkit_web_view_is_loading</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="WebKitWebView.html#webkit-web-view-is-playing-audio" title="webkit_web_view_is_playing_audio ()">webkit_web_view_is_playing_audio</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-estimated-load-progress" title="webkit_web_view_get_estimated_load_progress ()">webkit_web_view_get_estimated_load_progress</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="WebKitWebView.html#webkit-web-view-get-custom-charset" title="webkit_web_view_get_custom_charset ()">webkit_web_view_get_custom_charset</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="WebKitWebView.html#webkit-web-view-set-custom-charset" title="webkit_web_view_set_custom_charset ()">webkit_web_view_set_custom_charset</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="returnvalue">WebKitBackForwardList</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-back-forward-list" title="webkit_web_view_get_back_forward_list ()">webkit_web_view_get_back_forward_list</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="WebKitWebView.html#webkit-web-view-go-to-back-forward-list-item" title="webkit_web_view_go_to_back_forward_list_item ()">webkit_web_view_go_to_back_forward_list_item</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="WebKitWebView.html#webkit-web-view-get-uri" title="webkit_web_view_get_uri ()">webkit_web_view_get_uri</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">cairo_surface_t</span> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-favicon" title="webkit_web_view_get_favicon ()">webkit_web_view_get_favicon</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="WebKitWebView.html#webkit-web-view-set-settings" title="webkit_web_view_set_settings ()">webkit_web_view_set_settings</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="returnvalue">WebKitSettings</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-settings" title="webkit_web_view_get_settings ()">webkit_web_view_get_settings</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWindowProperties.html" title="WebKitWindowProperties"><span class="returnvalue">WebKitWindowProperties</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-window-properties" title="webkit_web_view_get_window_properties ()">webkit_web_view_get_window_properties</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="WebKitWebView.html#webkit-web-view-set-zoom-level" title="webkit_web_view_set_zoom_level ()">webkit_web_view_set_zoom_level</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-zoom-level" title="webkit_web_view_get_zoom_level ()">webkit_web_view_get_zoom_level</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="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()">webkit_web_view_can_execute_editing_command</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="WebKitWebView.html#webkit-web-view-can-execute-editing-command-finish" title="webkit_web_view_can_execute_editing_command_finish ()">webkit_web_view_can_execute_editing_command_finish</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="WebKitWebView.html#webkit-web-view-execute-editing-command" title="webkit_web_view_execute_editing_command ()">webkit_web_view_execute_editing_command</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="WebKitWebView.html#webkit-web-view-execute-editing-command-with-argument" title="webkit_web_view_execute_editing_command_with_argument ()">webkit_web_view_execute_editing_command_with_argument</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitFindController.html" title="WebKitFindController"><span class="returnvalue">WebKitFindController</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-find-controller" title="webkit_web_view_get_find_controller ()">webkit_web_view_get_find_controller</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebInspector.html" title="WebKitWebInspector"><span class="returnvalue">WebKitWebInspector</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-inspector" title="webkit_web_view_get_inspector ()">webkit_web_view_get_inspector</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">JSGlobalContextRef</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-javascript-global-context" title="webkit_web_view_get_javascript_global_context ()">webkit_web_view_get_javascript_global_context</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="WebKitWebView.html#webkit-web-view-run-javascript" title="webkit_web_view_run_javascript ()">webkit_web_view_run_javascript</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript-finish" title="webkit_web_view_run_javascript_finish ()">webkit_web_view_run_javascript_finish</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="WebKitWebView.html#webkit-web-view-run-javascript-from-gresource" title="webkit_web_view_run_javascript_from_gresource ()">webkit_web_view_run_javascript_from_gresource</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript-from-gresource-finish" title="webkit_web_view_run_javascript_from_gresource_finish ()">webkit_web_view_run_javascript_from_gresource_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="WebKitWebView.html#webkit-web-view-can-show-mime-type" title="webkit_web_view_can_show_mime_type ()">webkit_web_view_can_show_mime_type</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="WebKitWebView.html#webkit-web-view-save" title="webkit_web_view_save ()">webkit_web_view_save</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../gio/GInputStream.html#GInputStream-struct"><span class="returnvalue">GInputStream</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-save-finish" title="webkit_web_view_save_finish ()">webkit_web_view_save_finish</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="WebKitWebView.html#webkit-web-view-save-to-file" title="webkit_web_view_save_to_file ()">webkit_web_view_save_to_file</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="WebKitWebView.html#webkit-web-view-save-to-file-finish" title="webkit_web_view_save_to_file_finish ()">webkit_web_view_save_to_file_finish</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="WebKitWebView.html#webkit-web-view-download-uri" title="webkit_web_view_download_uri ()">webkit_web_view_download_uri</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="WebKitWebView.html#webkit-web-view-get-tls-info" title="webkit_web_view_get_tls_info ()">webkit_web_view_get_tls_info</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="WebKitWebView.html#webkit-web-view-get-snapshot" title="webkit_web_view_get_snapshot ()">webkit_web_view_get_snapshot</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">cairo_surface_t</span> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-snapshot-finish" title="webkit_web_view_get_snapshot_finish ()">webkit_web_view_get_snapshot_finish</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="WebKitWebView.html#webkit-web-view-set-background-color" title="webkit_web_view_set_background_color ()">webkit_web_view_set_background_color</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="WebKitWebView.html#webkit-web-view-get-background-color" title="webkit_web_view_get_background_color ()">webkit_web_view_get_background_color</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="WebKitWebView.html#webkit-web-view-set-editable" title="webkit_web_view_set_editable ()">webkit_web_view_set_editable</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="WebKitWebView.html#webkit-web-view-is-editable" title="webkit_web_view_is_editable ()">webkit_web_view_is_editable</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitEditorState.html" title="WebKitEditorState"><span class="returnvalue">WebKitEditorState</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-editor-state" title="webkit_web_view_get_editor_state ()">webkit_web_view_get_editor_state</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-session-state" title="webkit_web_view_get_session_state ()">webkit_web_view_get_session_state</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="WebKitWebView.html#webkit-web-view-restore-session-state" title="webkit_web_view_restore_session_state ()">webkit_web_view_restore_session_state</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-javascript-result-ref" title="webkit_javascript_result_ref ()">webkit_javascript_result_ref</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="WebKitWebView.html#webkit-javascript-result-unref" title="webkit_javascript_result_unref ()">webkit_javascript_result_unref</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">JSGlobalContextRef</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-javascript-result-get-global-context" title="webkit_javascript_result_get_global_context ()">webkit_javascript_result_get_global_context</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<span class="returnvalue">JSValueRef</span> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-javascript-result-get-value" title="webkit_javascript_result_get_value ()">webkit_javascript_result_get_value</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitScriptDialogType" title="enum WebKitScriptDialogType"><span class="returnvalue">WebKitScriptDialogType</span></a> +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-script-dialog-get-dialog-type" title="webkit_script_dialog_get_dialog_type ()">webkit_script_dialog_get_dialog_type</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="WebKitWebView.html#webkit-script-dialog-get-message" title="webkit_script_dialog_get_message ()">webkit_script_dialog_get_message</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="WebKitWebView.html#webkit-script-dialog-confirm-set-confirmed" title="webkit_script_dialog_confirm_set_confirmed ()">webkit_script_dialog_confirm_set_confirmed</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="WebKitWebView.html#webkit-script-dialog-prompt-get-default-text" title="webkit_script_dialog_prompt_get_default_text ()">webkit_script_dialog_prompt_get_default_text</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="WebKitWebView.html#webkit-script-dialog-prompt-set-text" title="webkit_script_dialog_prompt_set_text ()">webkit_script_dialog_prompt_set_text</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebResource.html" title="WebKitWebResource"><span class="returnvalue">WebKitWebResource</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-get-main-resource" title="webkit_web_view_get_main_resource ()">webkit_web_view_get_main_resource</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-session-state-new" title="webkit_web_view_session_state_new ()">webkit_web_view_session_state_new</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-session-state-ref" title="webkit_web_view_session_state_ref ()">webkit_web_view_session_state_ref</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="WebKitWebView.html#webkit-web-view-session-state-unref" title="webkit_web_view_session_state_unref ()">webkit_web_view_session_state_unref</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> +<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +</td> +<td class="function_name"> +<a class="link" href="WebKitWebView.html#webkit-web-view-session-state-serialize" title="webkit_web_view_session_state_serialize ()">webkit_web_view_session_state_serialize</a> <span class="c_punctuation">()</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.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#gboolean"><span class="type">gboolean</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--editable" title="The “editable” property">editable</a></td> +<td class="property_flags">Read / Write</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--estimated-load-progress" title="The “estimated-load-progress” property">estimated-load-progress</a></td> +<td class="property_flags">Read</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--favicon" title="The “favicon” property">favicon</a></td> +<td class="property_flags">Read</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--is-ephemeral" title="The “is-ephemeral” property">is-ephemeral</a></td> +<td class="property_flags">Read / Write / Construct Only</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--is-loading" title="The “is-loading” property">is-loading</a></td> +<td class="property_flags">Read</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--is-playing-audio" title="The “is-playing-audio” property">is-playing-audio</a></td> +<td class="property_flags">Read</td> +</tr> +<tr> +<td class="property_type"> +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--related-view" title="The “related-view” property">related-view</a></td> +<td class="property_flags">Write / Construct Only</td> +</tr> +<tr> +<td class="property_type"> +<a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--settings" title="The “settings” property">settings</a></td> +<td class="property_flags">Write / Construct</td> +</tr> +<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="WebKitWebView.html#WebKitWebView--title" title="The “title” property">title</a></td> +<td class="property_flags">Read</td> +</tr> +<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="WebKitWebView.html#WebKitWebView--uri" title="The “uri” property">uri</a></td> +<td class="property_flags">Read</td> +</tr> +<tr> +<td class="property_type"> +<a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--user-content-manager" title="The “user-content-manager” property">user-content-manager</a></td> +<td class="property_flags">Read / Write / Construct Only</td> +</tr> +<tr> +<td class="property_type"> +<a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *</td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--web-context" title="The “web-context” property">web-context</a></td> +<td class="property_flags">Read / Write / Construct Only</td> +</tr> +<tr> +<td class="property_type"><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></td> +<td class="property_name"><a class="link" href="WebKitWebView.html#WebKitWebView--zoom-level" title="The “zoom-level” property">zoom-level</a></td> +<td class="property_flags">Read / Write</td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-authenticate" title="The “authenticate” signal">authenticate</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="WebKitWebView.html#WebKitWebView-close" title="The “close” signal">close</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-context-menu" title="The “context-menu” signal">context-menu</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="WebKitWebView.html#WebKitWebView-context-menu-dismissed" title="The “context-menu-dismissed” signal">context-menu-dismissed</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"> +<a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a>*</td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-create" title="The “create” signal">create</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-decide-policy" title="The “decide-policy” signal">decide-policy</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-enter-fullscreen" title="The “enter-fullscreen” signal">enter-fullscreen</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="WebKitWebView.html#WebKitWebView-insecure-content-detected" title="The “insecure-content-detected” signal">insecure-content-detected</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-leave-fullscreen" title="The “leave-fullscreen” signal">leave-fullscreen</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="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal">load-changed</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal">load-failed</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-load-failed-with-tls-errors" title="The “load-failed-with-tls-errors” signal">load-failed-with-tls-errors</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="WebKitWebView.html#WebKitWebView-mouse-target-changed" title="The “mouse-target-changed” signal">mouse-target-changed</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-permission-request" title="The “permission-request” signal">permission-request</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-print" title="The “print” signal">print</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="WebKitWebView.html#WebKitWebView-ready-to-show" title="The “ready-to-show” signal">ready-to-show</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="WebKitWebView.html#WebKitWebView-resource-load-started" title="The “resource-load-started” signal">resource-load-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="WebKitWebView.html#WebKitWebView-run-as-modal" title="The “run-as-modal” signal">run-as-modal</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-run-color-chooser" title="The “run-color-chooser” signal">run-color-chooser</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-run-file-chooser" title="The “run-file-chooser” signal">run-file-chooser</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-script-dialog" title="The “script-dialog” signal">script-dialog</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-show-notification" title="The “show-notification” signal">show-notification</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="WebKitWebView.html#WebKitWebView-submit-form" title="The “submit-form” signal">submit-form</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"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td> +<td class="signal_name"><a class="link" href="WebKitWebView.html#WebKitWebView-web-process-crashed" title="The “web-process-crashed” signal">web-process-crashed</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> +<a name="WebKitJavascriptResult"></a><a name="WebKitScriptDialog"></a><a name="WebKitWebViewSessionState"></a><div class="refsect1"> +<a name="WebKitWebView.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"> </td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitWebView-struct" title="WebKitWebView">WebKitWebView</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitLoadEvent" title="enum WebKitLoadEvent">WebKitLoadEvent</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitPolicyDecisionType" title="enum WebKitPolicyDecisionType">WebKitPolicyDecisionType</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitSaveMode" title="enum WebKitSaveMode">WebKitSaveMode</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitInsecureContentEvent" title="enum WebKitInsecureContentEvent">WebKitInsecureContentEvent</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitSnapshotOptions" title="enum WebKitSnapshotOptions">WebKitSnapshotOptions</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitSnapshotRegion" title="enum WebKitSnapshotRegion">WebKitSnapshotRegion</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-CUT:CAPS" title="WEBKIT_EDITING_COMMAND_CUT">WEBKIT_EDITING_COMMAND_CUT</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-COPY:CAPS" title="WEBKIT_EDITING_COMMAND_COPY">WEBKIT_EDITING_COMMAND_COPY</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-PASTE:CAPS" title="WEBKIT_EDITING_COMMAND_PASTE">WEBKIT_EDITING_COMMAND_PASTE</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-SELECT-ALL:CAPS" title="WEBKIT_EDITING_COMMAND_SELECT_ALL">WEBKIT_EDITING_COMMAND_SELECT_ALL</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-UNDO:CAPS" title="WEBKIT_EDITING_COMMAND_UNDO">WEBKIT_EDITING_COMMAND_UNDO</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-REDO:CAPS" title="WEBKIT_EDITING_COMMAND_REDO">WEBKIT_EDITING_COMMAND_REDO</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-INSERT-IMAGE:CAPS" title="WEBKIT_EDITING_COMMAND_INSERT_IMAGE">WEBKIT_EDITING_COMMAND_INSERT_IMAGE</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WEBKIT-EDITING-COMMAND-CREATE-LINK:CAPS" title="WEBKIT_EDITING_COMMAND_CREATE_LINK">WEBKIT_EDITING_COMMAND_CREATE_LINK</a></td> +</tr> +<tr> +<td class="datatype_keyword"> </td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitJavascriptResult-struct" title="WebKitJavascriptResult">WebKitJavascriptResult</a></td> +</tr> +<tr> +<td class="datatype_keyword"> </td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitScriptDialog-struct" title="WebKitScriptDialog">WebKitScriptDialog</a></td> +</tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitScriptDialogType" title="enum WebKitScriptDialogType">WebKitScriptDialogType</a></td> +</tr> +<tr> +<td class="datatype_keyword"> </td> +<td class="function_name"><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState-struct" title="WebKitWebViewSessionState">WebKitWebViewSessionState</a></td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.object-hierarchy"></a><h2>Object Hierarchy</h2> +<pre class="screen"> <a href="/home/cgarcia/gnome/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a> + <span class="lineart">├──</span> WebKitJavascriptResult + <span class="lineart">├──</span> WebKitScriptDialog + <span class="lineart">╰──</span> WebKitWebViewSessionState + <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> + <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> + <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a> + <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a> + <span class="lineart">╰──</span> WebKitWebViewBase + <span class="lineart">╰──</span> WebKitWebView +</pre> +</div> +<div class="refsect1"> +<a name="WebKitWebView.implemented-interfaces"></a><h2>Implemented Interfaces</h2> +<p> +WebKitWebView implements + AtkImplementorIface and <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>.</p> +</div> +<div class="refsect1"> +<a name="WebKitWebView.description"></a><h2>Description</h2> +<p><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is the central class of the WebKit2GTK+ API. It is +responsible for managing the drawing of the content and forwarding +of events. You can load any URI into the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> or a data +string. With <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> you can control various aspects of the +rendering and loading of the content.</p> +<p>Note that <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is scrollable by itself, so you don't need +to embed it in a <a href="../gtk3/GtkScrolledWindow.html#GtkScrolledWindow-struct"><span class="type">GtkScrolledWindow</span></a>.</p> +</div> +<div class="refsect1"> +<a name="WebKitWebView.functions_details"></a><h2>Functions</h2> +<div class="refsect2"> +<a name="webkit-web-view-new"></a><h3>webkit_web_view_new ()</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +webkit_web_view_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> with the default <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> and +no <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> associated with it. +See also <a class="link" href="WebKitWebView.html#webkit-web-view-new-with-context" title="webkit_web_view_new_with_context ()"><code class="function">webkit_web_view_new_with_context()</code></a>, +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-user-content-manager" title="webkit_web_view_new_with_user_content_manager ()"><code class="function">webkit_web_view_new_with_user_content_manager()</code></a>, and +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-settings" title="webkit_web_view_new_with_settings ()"><code class="function">webkit_web_view_new_with_settings()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-new.returns"></a><h4>Returns</h4> +<p> The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-new-with-context"></a><h3>webkit_web_view_new_with_context ()</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +webkit_web_view_new_with_context (<em class="parameter"><code><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *context</code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> with the given <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> and +no <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> associated with it. +See also <a class="link" href="WebKitWebView.html#webkit-web-view-new-with-user-content-manager" title="webkit_web_view_new_with_user_content_manager ()"><code class="function">webkit_web_view_new_with_user_content_manager()</code></a> and +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-settings" title="webkit_web_view_new_with_settings ()"><code class="function">webkit_web_view_new_with_settings()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-new-with-context.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> to be used by the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-new-with-context.returns"></a><h4>Returns</h4> +<p> The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-new-with-related-view"></a><h3>webkit_web_view_new_with_related_view ()</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +webkit_web_view_new_with_related_view (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> sharing the same web process with <em class="parameter"><code>web_view</code></em> +. +This method doesn't have any effect when <a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-SHARED-SECONDARY-PROCESS:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_SHARED_SECONDARY_PROCESS</code></a> +process model is used, because a single web process is shared for all the web views in the +same <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>. When using <a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-MULTIPLE-SECONDARY-PROCESSES:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES</code></a> process model, +this method should always be used when creating the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> in the <a class="link" href="WebKitWebView.html#WebKitWebView-create" title="The “create” signal"><span class="type">“create”</span></a> signal. +You can also use this method to implement other process models based on <a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-MULTIPLE-SECONDARY-PROCESSES:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES</code></a>, +like for example, sharing the same web process for all the views in the same security domain.</p> +<p>The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> will also have the same <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> +and <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> as <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-new-with-related-view.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>web_view</p></td> +<td class="parameter_description"><p>the related <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-new-with-related-view.returns"></a><h4>Returns</h4> +<p> The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget. </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-4.html#api-index-2.4">2.4</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-new-with-settings"></a><h3>webkit_web_view_new_with_settings ()</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +webkit_web_view_new_with_settings (<em class="parameter"><code><a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> *settings</code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> with the given <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a>. +See also <a class="link" href="WebKitWebView.html#webkit-web-view-new-with-context" title="webkit_web_view_new_with_context ()"><code class="function">webkit_web_view_new_with_context()</code></a>, and +<a class="link" href="WebKitWebView.html#webkit-web-view-new-with-user-content-manager" title="webkit_web_view_new_with_user_content_manager ()"><code class="function">webkit_web_view_new_with_user_content_manager()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-new-with-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>settings</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-new-with-settings.returns"></a><h4>Returns</h4> +<p> The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget</p> +</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-view-new-with-user-content-manager"></a><h3>webkit_web_view_new_with_user_content_manager ()</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> * +webkit_web_view_new_with_user_content_manager + (<em class="parameter"><code><a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> *user_content_manager</code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> with the given <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a>. +The content loaded in the view may be affected by the content injected +in the view by the user content manager.</p> +<div class="refsect3"> +<a name="webkit-web-view-new-with-user-content-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>user_content_manager</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a>.</p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-new-with-user-content-manager.returns"></a><h4>Returns</h4> +<p> The newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget</p> +</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-view-is-ephemeral"></a><h3>webkit_web_view_is_ephemeral ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_is_ephemeral (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get whether a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is ephemeral. To create an ephemeral <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> you need to +use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a> and pass is-ephemeral propery with <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> value. See +<a class="link" href="WebKitWebView.html#WebKitWebView--is-ephemeral" title="The “is-ephemeral” property"><span class="type">“is-ephemeral”</span></a> for more details. +If <em class="parameter"><code>web_view</code></em> + was created with a ephemeral <a class="link" href="WebKitWebView.html#WebKitWebView--related-view" title="The “related-view” property"><span class="type">“related-view”</span></a> or an +ephemeral <a class="link" href="WebKitWebView.html#WebKitWebView--web-context" title="The “web-context” property"><span class="type">“web-context”</span></a> it will also be ephemeral.</p> +<div class="refsect3"> +<a name="webkit-web-view-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-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>web_view</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-view-get-context"></a><h3>webkit_web_view_get_context ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="returnvalue">WebKitWebContext</span></a> * +webkit_web_view_get_context (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the web context of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-context.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-context.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> of the view. </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-view-get-user-content-manager"></a><h3>webkit_web_view_get_user_content_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="returnvalue">WebKitUserContentManager</span></a> * +webkit_web_view_get_user_content_manager + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the user content manager associated to <em class="parameter"><code>web_view</code></em> +, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the +view does not have an user content manager.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-user-content-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-user-content-manager.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> associated with the view. </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-6.html#api-index-2.6">2.6</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-website-data-manager"></a><h3>webkit_web_view_get_website_data_manager ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="returnvalue">WebKitWebsiteDataManager</span></a> * +webkit_web_view_get_website_data_manager + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> associated to <em class="parameter"><code>web_view</code></em> +. If <em class="parameter"><code>web_view</code></em> + is not ephemeral, +the returned <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> will be the same as the <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> +of <em class="parameter"><code>web_view</code></em> +'s <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-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-16.html#api-index-2.16">2.16</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-try-close"></a><h3>webkit_web_view_try_close ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_try_close (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Tries to close the <em class="parameter"><code>web_view</code></em> +. This will fire the onbeforeunload event +to ask the user for confirmation to close the page. If there isn't an +onbeforeunload event handler or the user confirms to close the page, +the <a class="link" href="WebKitWebView.html#WebKitWebView-close" title="The “close” signal"><span class="type">“close”</span></a> signal is emitted, otherwise nothing happens.</p> +<div class="refsect3"> +<a name="webkit-web-view-try-close.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-uri"></a><h3>webkit_web_view_load_uri ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_uri (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 loading of the specified URI string. +You can monitor the load operation by connecting to +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>uri</p></td> +<td class="parameter_description"><p>an URI string</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-html"></a><h3>webkit_web_view_load_html ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_html (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *content</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *base_uri</code></em>);</pre> +<p>Load the given <em class="parameter"><code>content</code></em> + string with the specified <em class="parameter"><code>base_uri</code></em> +. +If <em class="parameter"><code>base_uri</code></em> + is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, relative URLs in the <em class="parameter"><code>content</code></em> + will be +resolved against <em class="parameter"><code>base_uri</code></em> + and absolute local paths must be children of the <em class="parameter"><code>base_uri</code></em> +. +For security reasons absolute local paths that are not children of <em class="parameter"><code>base_uri</code></em> + +will cause the web process to terminate. +If you need to include URLs in <em class="parameter"><code>content</code></em> + that are local paths in a different +directory than <em class="parameter"><code>base_uri</code></em> + you can build a data URI for them. When <em class="parameter"><code>base_uri</code></em> + is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, +it defaults to "about:blank". The mime type of the document will be "text/html". +You can monitor the load operation by connecting to <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-html.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>content</p></td> +<td class="parameter_description"><p>The HTML string to load</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>base_uri</p></td> +<td class="parameter_description"><p> The base URI for relative locations 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> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-alternate-html"></a><h3>webkit_web_view_load_alternate_html ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_alternate_html (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *content</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *content_uri</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *base_uri</code></em>);</pre> +<p>Load the given <em class="parameter"><code>content</code></em> + string for the URI <em class="parameter"><code>content_uri</code></em> +. +This allows clients to display page-loading errors in the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> itself. +When this method is called from <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal"><span class="type">“load-failed”</span></a> signal to show an +error page, the the back-forward list is maintained appropriately. +For everything else this method works the same way as <a class="link" href="WebKitWebView.html#webkit-web-view-load-html" title="webkit_web_view_load_html ()"><code class="function">webkit_web_view_load_html()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-alternate-html.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>content</p></td> +<td class="parameter_description"><p>the new content to display as the main page of the <em class="parameter"><code>web_view</code></em> +</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>content_uri</p></td> +<td class="parameter_description"><p>the URI for the alternate page content</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>base_uri</p></td> +<td class="parameter_description"><p> the base URI for relative locations 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> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-plain-text"></a><h3>webkit_web_view_load_plain_text ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_plain_text (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *plain_text</code></em>);</pre> +<p>Load the specified <em class="parameter"><code>plain_text</code></em> + string into <em class="parameter"><code>web_view</code></em> +. The mime type of +document will be "text/plain". You can monitor the load +operation by connecting to <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-plain-text.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>plain_text</p></td> +<td class="parameter_description"><p>The plain text to load</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-bytes"></a><h3>webkit_web_view_load_bytes ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_bytes (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *bytes</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mime_type</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *encoding</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *base_uri</code></em>);</pre> +<p>Load the specified <em class="parameter"><code>bytes</code></em> + into <em class="parameter"><code>web_view</code></em> + using the given <em class="parameter"><code>mime_type</code></em> + and <em class="parameter"><code>encoding</code></em> +. +When <em class="parameter"><code>mime_type</code></em> + is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it defaults to "text/html". +When <em class="parameter"><code>encoding</code></em> + is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it defaults to "UTF-8". +When <em class="parameter"><code>base_uri</code></em> + is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it defaults to "about:blank". +You can monitor the load operation by connecting to <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-bytes.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>bytes</p></td> +<td class="parameter_description"><p>input data to load</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>mime_type</p></td> +<td class="parameter_description"><p> the MIME type of <em class="parameter"><code>bytes</code></em> +, 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> +<tr> +<td class="parameter_name"><p>encoding</p></td> +<td class="parameter_description"><p> the character encoding of <em class="parameter"><code>bytes</code></em> +, 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> +<tr> +<td class="parameter_name"><p>base_uri</p></td> +<td class="parameter_description"><p> the base URI for relative locations 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-6.html#api-index-2.6">2.6</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-load-request"></a><h3>webkit_web_view_load_request ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_load_request (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</span></a> *request</code></em>);</pre> +<p>Requests loading of the specified <a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</span></a>. +You can monitor the load operation by connecting to +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-load-request.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</span></a> to load</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-can-go-back"></a><h3>webkit_web_view_can_go_back ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_can_go_back (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Determines whether <em class="parameter"><code>web_view</code></em> + has a previous history item.</p> +<div class="refsect3"> +<a name="webkit-web-view-can-go-back.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-can-go-back.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if able to move back 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-view-go-back"></a><h3>webkit_web_view_go_back ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_go_back (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Loads the previous history item. +You can monitor the load operation by connecting to +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-go-back.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-can-go-forward"></a><h3>webkit_web_view_can_go_forward ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_can_go_forward (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Determines whether <em class="parameter"><code>web_view</code></em> + has a next history item.</p> +<div class="refsect3"> +<a name="webkit-web-view-can-go-forward.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-can-go-forward.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if able to move forward 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-view-go-forward"></a><h3>webkit_web_view_go_forward ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_go_forward (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Loads the next history item. +You can monitor the load operation by connecting to +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-go-forward.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-title"></a><h3>webkit_web_view_get_title ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_web_view_get_title (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the value of the <a class="link" href="WebKitWebView.html#WebKitWebView--title" title="The “title” property"><span class="type">“title”</span></a> property. +You can connect to notify::title signal of <em class="parameter"><code>web_view</code></em> + to +be notified when the title has been received.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-title.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-title.returns"></a><h4>Returns</h4> +<p> The main frame document title of <em class="parameter"><code>web_view</code></em> +.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-page-id"></a><h3>webkit_web_view_get_page_id ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint64"><span class="returnvalue">guint64</span></a> +webkit_web_view_get_page_id (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the identifier of the <a class="link" href="WebKitWebPage.html" title="WebKitWebPage"><span class="type">WebKitWebPage</span></a> corresponding to +the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p> +<div class="refsect3"> +<a name="webkit-web-view-get-page-id.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-page-id.returns"></a><h4>Returns</h4> +<p> the page ID of <em class="parameter"><code>web_view</code></em> +.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-reload"></a><h3>webkit_web_view_reload ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_reload (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Reloads the current contents of <em class="parameter"><code>web_view</code></em> +. +See also <a class="link" href="WebKitWebView.html#webkit-web-view-reload-bypass-cache" title="webkit_web_view_reload_bypass_cache ()"><code class="function">webkit_web_view_reload_bypass_cache()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-reload.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-reload-bypass-cache"></a><h3>webkit_web_view_reload_bypass_cache ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_reload_bypass_cache (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Reloads the current contents of <em class="parameter"><code>web_view</code></em> + without +using any cached data.</p> +<div class="refsect3"> +<a name="webkit-web-view-reload-bypass-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-stop-loading"></a><h3>webkit_web_view_stop_loading ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_stop_loading (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Stops any ongoing loading operation in <em class="parameter"><code>web_view</code></em> +. +This method does nothing if no content is being loaded. +If there is a loading operation in progress, it will be cancelled and +<a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal"><span class="type">“load-failed”</span></a> signal will be emitted with +<a class="link" href="webkit2gtk-4.0-WebKitError.html#WEBKIT-NETWORK-ERROR-CANCELLED:CAPS"><code class="literal">WEBKIT_NETWORK_ERROR_CANCELLED</code></a> error.</p> +<div class="refsect3"> +<a name="webkit-web-view-stop-loading.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-is-loading"></a><h3>webkit_web_view_is_loading ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_is_loading (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the value of the <a class="link" href="WebKitWebView.html#WebKitWebView--is-loading" title="The “is-loading” property"><span class="type">“is-loading”</span></a> property. +You can monitor when a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is loading a page by connecting to +notify::is-loading signal of <em class="parameter"><code>web_view</code></em> +. This is useful when you are +interesting in knowing when the view is loding something but not in the +details about the status of the load operation, for example to start a spinner +when the view is loading a page and stop it when it finishes.</p> +<div class="refsect3"> +<a name="webkit-web-view-is-loading.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-is-loading.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>web_view</code></em> +is loading a page 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-view-is-playing-audio"></a><h3>webkit_web_view_is_playing_audio ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_is_playing_audio (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the value of the <a class="link" href="WebKitWebView.html#WebKitWebView--is-playing-audio" title="The “is-playing-audio” property"><span class="type">“is-playing-audio”</span></a> property. +You can monitor when a page in a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is playing audio by +connecting to the notify::is-playing-audio signal of <em class="parameter"><code>web_view</code></em> +. This +is useful when the application wants to provide visual feedback when a +page is producing sound.</p> +<div class="refsect3"> +<a name="webkit-web-view-is-playing-audio.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-is-playing-audio.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a page in <em class="parameter"><code>web_view</code></em> +is playing audio 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-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-estimated-load-progress"></a><h3>webkit_web_view_get_estimated_load_progress ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> +webkit_web_view_get_estimated_load_progress + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the value of the <a class="link" href="WebKitWebView.html#WebKitWebView--estimated-load-progress" title="The “estimated-load-progress” property"><span class="type">“estimated-load-progress”</span></a> property. +You can monitor the estimated progress of a load operation by +connecting to the notify::estimated-load-progress signal of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-estimated-load-progress.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-estimated-load-progress.returns"></a><h4>Returns</h4> +<p> an estimate of the of the percent complete for a document +load as a range from 0.0 to 1.0.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-custom-charset"></a><h3>webkit_web_view_get_custom_charset ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_web_view_get_custom_charset (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Returns the current custom character encoding name of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-custom-charset.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-custom-charset.returns"></a><h4>Returns</h4> +<p> the current custom character encoding name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no +custom character encoding has been set.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-set-custom-charset"></a><h3>webkit_web_view_set_custom_charset ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_set_custom_charset (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *charset</code></em>);</pre> +<p>Sets the current custom character encoding override of <em class="parameter"><code>web_view</code></em> +. The custom +character encoding will override any text encoding detected via HTTP headers or +META tags. Calling this method will stop any current load operation and reload the +current page. Setting the custom character encoding to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> removes the character +encoding override.</p> +<div class="refsect3"> +<a name="webkit-web-view-set-custom-charset.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>charset</p></td> +<td class="parameter_description"><p> a character encoding name 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> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-back-forward-list"></a><h3>webkit_web_view_get_back_forward_list ()</h3> +<pre class="programlisting"><a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="returnvalue">WebKitBackForwardList</span></a> * +webkit_web_view_get_back_forward_list (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Obtains the <a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="type">WebKitBackForwardList</span></a> associated with the given <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. The +<a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="type">WebKitBackForwardList</span></a> is owned by the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-back-forward-list.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-back-forward-list.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="type">WebKitBackForwardList</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-view-go-to-back-forward-list-item"></a><h3>webkit_web_view_go_to_back_forward_list_item ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_go_to_back_forward_list_item + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitBackForwardListItem.html" title="WebKitBackForwardListItem"><span class="type">WebKitBackForwardListItem</span></a> *list_item</code></em>);</pre> +<p>Loads the specific history item <em class="parameter"><code>list_item</code></em> +. +You can monitor the load operation by connecting to +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal.</p> +<div class="refsect3"> +<a name="webkit-web-view-go-to-back-forward-list-item.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>list_item</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitBackForwardListItem.html" title="WebKitBackForwardListItem"><span class="type">WebKitBackForwardListItem</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-uri"></a><h3>webkit_web_view_get_uri ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_web_view_get_uri (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Returns the current active URI of <em class="parameter"><code>web_view</code></em> +. The active URI might change during +a load operation:</p> +<div class="orderedlist"><ol class="orderedlist" type="1"> +<li class="listitem"><p> + When nothing has been loaded yet on <em class="parameter"><code>web_view</code></em> the active URI is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +</p></li> +<li class="listitem"> +<p> + When a new load operation starts the active URI is the requested URI: + </p> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> +<li class="listitem"><p> + If the load operation was started by <a class="link" href="WebKitWebView.html#webkit-web-view-load-uri" title="webkit_web_view_load_uri ()"><code class="function">webkit_web_view_load_uri()</code></a>, + the requested URI is the given one. + </p></li> +<li class="listitem"><p> + If the load operation was started by <a class="link" href="WebKitWebView.html#webkit-web-view-load-html" title="webkit_web_view_load_html ()"><code class="function">webkit_web_view_load_html()</code></a>, + the requested URI is "about:blank". + </p></li> +<li class="listitem"><p> + If the load operation was started by <a class="link" href="WebKitWebView.html#webkit-web-view-load-alternate-html" title="webkit_web_view_load_alternate_html ()"><code class="function">webkit_web_view_load_alternate_html()</code></a>, + the requested URI is content URI provided. + </p></li> +<li class="listitem"><p> + If the load operation was started by <a class="link" href="WebKitWebView.html#webkit-web-view-go-back" title="webkit_web_view_go_back ()"><code class="function">webkit_web_view_go_back()</code></a> or + <a class="link" href="WebKitWebView.html#webkit-web-view-go-forward" title="webkit_web_view_go_forward ()"><code class="function">webkit_web_view_go_forward()</code></a>, the requested URI is the original URI + of the previous/next item in the <a class="link" href="WebKitBackForwardList.html" title="WebKitBackForwardList"><span class="type">WebKitBackForwardList</span></a> of <em class="parameter"><code>web_view</code></em>. + </p></li> +<li class="listitem"><p> + If the load operation was started by + <a class="link" href="WebKitWebView.html#webkit-web-view-go-to-back-forward-list-item" title="webkit_web_view_go_to_back_forward_list_item ()"><code class="function">webkit_web_view_go_to_back_forward_list_item()</code></a>, the requested URI + is the opriginal URI of the given <a class="link" href="WebKitBackForwardListItem.html" title="WebKitBackForwardListItem"><span class="type">WebKitBackForwardListItem</span></a>. + </p></li> +</ul></div> +<p> +</p> +</li> +<li class="listitem"><p> + If there is a server redirection during the load operation, + the active URI is the redirected URI. When the signal + <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> is emitted with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-REDIRECTED:CAPS"><code class="literal">WEBKIT_LOAD_REDIRECTED</code></a> + event, the active URI is already updated to the redirected URI. +</p></li> +<li class="listitem"><p> + When the signal <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> is emitted + with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-COMMITTED:CAPS"><code class="literal">WEBKIT_LOAD_COMMITTED</code></a> event, the active URI is the final + one and it will not change unless a new load operation is started + or a navigation action within the same page is performed. +</p></li> +</ol></div> +<p>You can monitor the active URI by connecting to the notify::uri +signal of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-uri.returns"></a><h4>Returns</h4> +<p> the current active URI of <em class="parameter"><code>web_view</code></em> +or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +if nothing has been loaded yet.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-favicon"></a><h3>webkit_web_view_get_favicon ()</h3> +<pre class="programlisting"><span class="returnvalue">cairo_surface_t</span> * +webkit_web_view_get_favicon (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Returns favicon currently associated to <em class="parameter"><code>web_view</code></em> +, if any. You can +connect to notify::favicon signal of <em class="parameter"><code>web_view</code></em> + to be notified when +the favicon is available.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-favicon.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-favicon.returns"></a><h4>Returns</h4> +<p> a pointer to a <span class="type">cairo_surface_t</span> with the +favicon or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there's no icon associated with <em class="parameter"><code>web_view</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-view-set-settings"></a><h3>webkit_web_view_set_settings ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_set_settings (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> *settings</code></em>);</pre> +<p>Sets the <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> to be applied to <em class="parameter"><code>web_view</code></em> +. The +existing <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> of <em class="parameter"><code>web_view</code></em> + will be replaced by +<em class="parameter"><code>settings</code></em> +. New settings are applied immediately on <em class="parameter"><code>web_view</code></em> +. +The same <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> object can be shared +by multiple <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s.</p> +<div class="refsect3"> +<a name="webkit-web-view-set-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>settings</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-settings"></a><h3>webkit_web_view_get_settings ()</h3> +<pre class="programlisting"><a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="returnvalue">WebKitSettings</span></a> * +webkit_web_view_get_settings (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> currently applied to <em class="parameter"><code>web_view</code></em> +. +If no other <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> have been explicitly applied to +<em class="parameter"><code>web_view</code></em> + with <a class="link" href="WebKitWebView.html#webkit-web-view-set-settings" title="webkit_web_view_set_settings ()"><code class="function">webkit_web_view_set_settings()</code></a>, the default +<a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> will be returned. This method always returns +a valid <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> object. +To modify any of the <em class="parameter"><code>web_view</code></em> + settings, you can either create +a new <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> object with <a class="link" href="WebKitSettings.html#webkit-settings-new" title="webkit_settings_new ()"><code class="function">webkit_settings_new()</code></a>, setting +the desired preferences, and then replace the existing <em class="parameter"><code>web_view</code></em> + +settings with <a class="link" href="WebKitWebView.html#webkit-web-view-set-settings" title="webkit_web_view_set_settings ()"><code class="function">webkit_web_view_set_settings()</code></a> or get the existing +<em class="parameter"><code>web_view</code></em> + settings and update it directly. <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> objects +can be shared by multiple <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s, so modifying +the settings of a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> would affect other +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s using the same <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-settings.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> attached to <em class="parameter"><code>web_view</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-view-get-window-properties"></a><h3>webkit_web_view_get_window_properties ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWindowProperties.html" title="WebKitWindowProperties"><span class="returnvalue">WebKitWindowProperties</span></a> * +webkit_web_view_get_window_properties (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the <a class="link" href="WebKitWindowProperties.html" title="WebKitWindowProperties"><span class="type">WebKitWindowProperties</span></a> object containing the properties +that the window containing <em class="parameter"><code>web_view</code></em> + should have.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-window-properties.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-window-properties.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitWindowProperties.html" title="WebKitWindowProperties"><span class="type">WebKitWindowProperties</span></a> of <em class="parameter"><code>web_view</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-view-set-zoom-level"></a><h3>webkit_web_view_set_zoom_level ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_set_zoom_level (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> zoom_level</code></em>);</pre> +<p>Set the zoom level of <em class="parameter"><code>web_view</code></em> +, i.e. the factor by which the +view contents are scaled with respect to their original size.</p> +<div class="refsect3"> +<a name="webkit-web-view-set-zoom-level.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>zoom_level</p></td> +<td class="parameter_description"><p>the zoom level</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-zoom-level"></a><h3>webkit_web_view_get_zoom_level ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> +webkit_web_view_get_zoom_level (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the zoom level of <em class="parameter"><code>web_view</code></em> +, i.e. the factor by which the +view contents are scaled with respect to their original size.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-zoom-level.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-zoom-level.returns"></a><h4>Returns</h4> +<p> the current zoom level of <em class="parameter"><code>web_view</code></em> +</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-can-execute-editing-command"></a><h3>webkit_web_view_can_execute_editing_command ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_can_execute_editing_command + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *command</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 check if it is possible to execute the given editing command.</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="WebKitWebView.html#webkit-web-view-can-execute-editing-command-finish" title="webkit_web_view_can_execute_editing_command_finish ()"><code class="function">webkit_web_view_can_execute_editing_command_finish()</code></a> to get the result of the operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-can-execute-editing-command.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>command</p></td> +<td class="parameter_description"><p>the command to check</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-view-can-execute-editing-command-finish"></a><h3>webkit_web_view_can_execute_editing_command_finish ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_can_execute_editing_command_finish + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 <a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-can-execute-editing-command-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-can-execute-editing-command-finish.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the editing command can be executed 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-view-execute-editing-command"></a><h3>webkit_web_view_execute_editing_command ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_execute_editing_command + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *command</code></em>);</pre> +<p>Request to execute the given <em class="parameter"><code>command</code></em> + for <em class="parameter"><code>web_view</code></em> +. You can use +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a> to check whether +it's possible to execute the command.</p> +<div class="refsect3"> +<a name="webkit-web-view-execute-editing-command.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>command</p></td> +<td class="parameter_description"><p>the command to execute</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-execute-editing-command-with-argument"></a><h3>webkit_web_view_execute_editing_command_with_argument ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_execute_editing_command_with_argument + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *command</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *argument</code></em>);</pre> +<p>Request to execute the given <em class="parameter"><code>command</code></em> + with <em class="parameter"><code>argument</code></em> + for <em class="parameter"><code>web_view</code></em> +. You can use +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a> to check whether +it's possible to execute the command.</p> +<div class="refsect3"> +<a name="webkit-web-view-execute-editing-command-with-argument.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>command</p></td> +<td class="parameter_description"><p>the command to execute</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>argument</p></td> +<td class="parameter_description"><p>the command argument</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-view-get-find-controller"></a><h3>webkit_web_view_get_find_controller ()</h3> +<pre class="programlisting"><a class="link" href="WebKitFindController.html" title="WebKitFindController"><span class="returnvalue">WebKitFindController</span></a> * +webkit_web_view_get_find_controller (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the <a class="link" href="WebKitFindController.html" title="WebKitFindController"><span class="type">WebKitFindController</span></a> that will allow the caller to query +the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> for the text to look for.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-find-controller.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-find-controller.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitFindController.html" title="WebKitFindController"><span class="type">WebKitFindController</span></a> associated to +this particular <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-get-inspector"></a><h3>webkit_web_view_get_inspector ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebInspector.html" title="WebKitWebInspector"><span class="returnvalue">WebKitWebInspector</span></a> * +webkit_web_view_get_inspector (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the <a class="link" href="WebKitWebInspector.html" title="WebKitWebInspector"><span class="type">WebKitWebInspector</span></a> associated to <em class="parameter"><code>web_view</code></em> +</p> +<div class="refsect3"> +<a name="webkit-web-view-get-inspector.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-inspector.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitWebInspector.html" title="WebKitWebInspector"><span class="type">WebKitWebInspector</span></a> of <em class="parameter"><code>web_view</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-view-get-javascript-global-context"></a><h3>webkit_web_view_get_javascript_global_context ()</h3> +<pre class="programlisting"><span class="returnvalue">JSGlobalContextRef</span> +webkit_web_view_get_javascript_global_context + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Get the global JavaScript context used by <em class="parameter"><code>web_view</code></em> + to deserialize the +result values of scripts executed with <a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript" title="webkit_web_view_run_javascript ()"><code class="function">webkit_web_view_run_javascript()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-javascript-global-context.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-javascript-global-context.returns"></a><h4>Returns</h4> +<p> the <code class="function">JSGlobalContextRef</code> used by <em class="parameter"><code>web_view</code></em> +to deserialize +the result values of scripts.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-run-javascript"></a><h3>webkit_web_view_run_javascript ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_run_javascript (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *script</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 run <em class="parameter"><code>script</code></em> + in the context of the current page in <em class="parameter"><code>web_view</code></em> +. If +WebKitSettings:enable-javascript is FALSE, this method will do nothing.</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="WebKitWebView.html#webkit-web-view-run-javascript-finish" title="webkit_web_view_run_javascript_finish ()"><code class="function">webkit_web_view_run_javascript_finish()</code></a> to get the result of the operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-run-javascript.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>script</p></td> +<td class="parameter_description"><p>the script to run</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 script finished. </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-view-run-javascript-finish"></a><h3>webkit_web_view_run_javascript_finish ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +webkit_web_view_run_javascript_finish (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 <a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript" title="webkit_web_view_run_javascript ()"><code class="function">webkit_web_view_run_javascript()</code></a>.</p> +<p>This is an example of using <a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript" title="webkit_web_view_run_javascript ()"><code class="function">webkit_web_view_run_javascript()</code></a> with a script returning +a string:</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 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span> +web_view_javascript_finished (GObject *object, + GAsyncResult *result, + gpointer user_data) +{ + WebKitJavascriptResult *js_result; + JSValueRef value; + JSGlobalContextRef context; + GError *error = <span class="number">NULL</span>; + + js_result = webkit_web_view_run_javascript_finish (WEBKIT_WEB_VIEW (object), result, &error); + <span class="keyword">if</span> (!js_result) { + g_warning (<span class="number">"Error running javascript: </span><span class="symbol">%s</span><span class="number">"</span>, error->message); + g_error_free (error); + <span class="keyword">return</span>; + } + + context = webkit_javascript_result_get_global_context (js_result); + value = webkit_javascript_result_get_value (js_result); + <span class="keyword">if</span> (JSValueIsString (context, value)) { + JSStringRef js_str_value; + gchar *str_value; + gsize str_length; + + js_str_value = JSValueToStringCopy (context, value, <span class="number">NULL</span>); + str_length = JSStringGetMaximumUTF8CStringSize (js_str_value); + str_value = (gchar *)g_malloc (str_length); + JSStringGetUTF8CString (js_str_value, str_value, str_length); + JSStringRelease (js_str_value); + g_print (<span class="number">"Script result: </span><span class="symbol">%s</span><span class="symbol">\n</span><span class="number">"</span>, str_value); + g_free (str_value); + } <span class="keyword">else</span> { + g_warning (<span class="number">"Error running javascript: unexpected return value"</span>); + } + webkit_javascript_result_unref (js_result); +} + +<span class="type">static</span> <span class="type">void</span> +web_view_get_link_url (WebKitWebView *web_view, + <span class="type">const</span> gchar *link_id) +{ + gchar *script; + + script = g_strdup_printf (<span class="number">"window.document.getElementById('</span><span class="symbol">%s</span><span class="number">').href;"</span>, link_id); + webkit_web_view_run_javascript (web_view, script, <span class="number">NULL</span>, web_view_javascript_finished, <span class="number">NULL</span>); + g_free (script); +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<div class="refsect3"> +<a name="webkit-web-view-run-javascript-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-run-javascript-finish.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> with the result of the last executed statement in <em class="parameter"><code>script</code></em> +or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of error. </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-view-run-javascript-from-gresource"></a><h3>webkit_web_view_run_javascript_from_gresource ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_run_javascript_from_gresource + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource</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 run the script from <em class="parameter"><code>resource</code></em> + in the context of the +current page in <em class="parameter"><code>web_view</code></em> +.</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="WebKitWebView.html#webkit-web-view-run-javascript-from-gresource-finish" title="webkit_web_view_run_javascript_from_gresource_finish ()"><code class="function">webkit_web_view_run_javascript_from_gresource_finish()</code></a> to get the result +of the operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-run-javascript-from-gresource.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>resource</p></td> +<td class="parameter_description"><p>the location of the resource to load</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 script finished. </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-view-run-javascript-from-gresource-finish"></a><h3>webkit_web_view_run_javascript_from_gresource_finish ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +webkit_web_view_run_javascript_from_gresource_finish + (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 <a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript-from-gresource" title="webkit_web_view_run_javascript_from_gresource ()"><code class="function">webkit_web_view_run_javascript_from_gresource()</code></a>.</p> +<p>Check <a class="link" href="WebKitWebView.html#webkit-web-view-run-javascript-finish" title="webkit_web_view_run_javascript_finish ()"><code class="function">webkit_web_view_run_javascript_finish()</code></a> for a usage example.</p> +<div class="refsect3"> +<a name="webkit-web-view-run-javascript-from-gresource-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-run-javascript-from-gresource-finish.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> with the result of the last executed statement in <em class="parameter"><code>script</code></em> +or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of error. </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-view-can-show-mime-type"></a><h3>webkit_web_view_can_show_mime_type ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_can_show_mime_type (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mime_type</code></em>);</pre> +<p>Whether or not a MIME type can be displayed in <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-can-show-mime-type.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>mime_type</p></td> +<td class="parameter_description"><p>a MIME type</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-can-show-mime-type.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the MIME type <em class="parameter"><code>mime_type</code></em> +can be displayed 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-view-save"></a><h3>webkit_web_view_save ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_save (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitSaveMode" title="enum WebKitSaveMode"><span class="type">WebKitSaveMode</span></a> save_mode</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 save the current web page associated to the +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> into a self-contained format using the mode +specified in <em class="parameter"><code>save_mode</code></em> +.</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="WebKitWebView.html#webkit-web-view-save-finish" title="webkit_web_view_save_finish ()"><code class="function">webkit_web_view_save_finish()</code></a> to get the result of the +operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-save.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>save_mode</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitSaveMode" title="enum WebKitSaveMode"><span class="type">WebKitSaveMode</span></a> specifying how the web page should be saved.</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-view-save-finish"></a><h3>webkit_web_view_save_finish ()</h3> +<pre class="programlisting"><a href="../gio/GInputStream.html#GInputStream-struct"><span class="returnvalue">GInputStream</span></a> * +webkit_web_view_save_finish (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 <a class="link" href="WebKitWebView.html#webkit-web-view-save" title="webkit_web_view_save ()"><code class="function">webkit_web_view_save()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-save-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-save-finish.returns"></a><h4>Returns</h4> +<p> a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> with the result of saving +the current web page or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of error. </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-view-save-to-file"></a><h3>webkit_web_view_save_to_file ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_save_to_file (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitSaveMode" title="enum WebKitSaveMode"><span class="type">WebKitSaveMode</span></a> save_mode</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 save the current web page associated to the +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> into a self-contained format using the mode +specified in <em class="parameter"><code>save_mode</code></em> + and writing it to <em class="parameter"><code>file</code></em> +.</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="WebKitWebView.html#webkit-web-view-save-to-file-finish" title="webkit_web_view_save_to_file_finish ()"><code class="function">webkit_web_view_save_to_file_finish()</code></a> to get the result of the +operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-save-to-file.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>file</p></td> +<td class="parameter_description"><p>the <a href="../gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> where the current web page should be saved to.</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>save_mode</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitSaveMode" title="enum WebKitSaveMode"><span class="type">WebKitSaveMode</span></a> specifying how the web page should be saved.</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-view-save-to-file-finish"></a><h3>webkit_web_view_save_to_file_finish ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_save_to_file_finish (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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 <a class="link" href="WebKitWebView.html#webkit-web-view-save-to-file" title="webkit_web_view_save_to_file ()"><code class="function">webkit_web_view_save_to_file()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-save-to-file-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-save-to-file-finish.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the web page was successfully saved to a file 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-view-download-uri"></a><h3>webkit_web_view_download_uri ()</h3> +<pre class="programlisting"><a class="link" href="WebKitDownload.html" title="WebKitDownload"><span class="returnvalue">WebKitDownload</span></a> * +webkit_web_view_download_uri (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre> +<p>Requests downloading of the specified URI string for <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-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-view-get-tls-info"></a><h3>webkit_web_view_get_tls_info ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_get_tls_info (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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><a href="../gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> *errors</code></em>);</pre> +<p>Retrieves the <a href="../gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a> associated with the main resource of <em class="parameter"><code>web_view</code></em> +, +and the <a href="../gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> showing what problems, if any, have been found +with that certificate. +If the connection is not HTTPS, this function returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. +This function should be called after a response has been received from the +server, so you can connect to <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> and call this function +when it's emitted with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-COMMITTED:CAPS"><code class="literal">WEBKIT_LOAD_COMMITTED</code></a> event.</p> +<p>Note that this function provides no information about the security of the web +page if the current <a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="type">WebKitTLSErrorsPolicy</span></a> is <em class="parameter"><code>WEBKIT_TLS_ERRORS_POLICY_IGNORE</code></em> +, +as subresources of the page may be controlled by an attacker. This function +may safely be used to determine the security status of the current page only +if the current <a class="link" href="WebKitWebContext.html#WebKitTLSErrorsPolicy" title="enum WebKitTLSErrorsPolicy"><span class="type">WebKitTLSErrorsPolicy</span></a> is <em class="parameter"><code>WEBKIT_TLS_ERRORS_POLICY_FAIL</code></em> +, in +which case subresources that fail certificate verification will be blocked.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-tls-info.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>certificate</p></td> +<td class="parameter_description"><p> return location for a <a href="../gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a>. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>errors</p></td> +<td class="parameter_description"><p> return location for a <a href="../gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> the verification status of <em class="parameter"><code>certificate</code></em> +. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-tls-info.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>web_view</code></em> +connection uses HTTPS and a response has been received +from the server, 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-view-get-snapshot"></a><h3>webkit_web_view_get_snapshot ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_get_snapshot (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitSnapshotRegion" title="enum WebKitSnapshotRegion"><span class="type">WebKitSnapshotRegion</span></a> region</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitSnapshotOptions" title="enum WebKitSnapshotOptions"><span class="type">WebKitSnapshotOptions</span></a> options</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 retrieves a snapshot of <em class="parameter"><code>web_view</code></em> + for <em class="parameter"><code>region</code></em> +. +<em class="parameter"><code>options</code></em> + specifies how the snapshot should be rendered.</p> +<p>When the operation is finished, <em class="parameter"><code>callback</code></em> + will be called. You must +call <a class="link" href="WebKitWebView.html#webkit-web-view-get-snapshot-finish" title="webkit_web_view_get_snapshot_finish ()"><code class="function">webkit_web_view_get_snapshot_finish()</code></a> to get the result of the +operation.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-snapshot.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>region</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitSnapshotRegion" title="enum WebKitSnapshotRegion"><span class="type">WebKitSnapshotRegion</span></a> for this snapshot</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>options</p></td> +<td class="parameter_description"><p><a class="link" href="WebKitWebView.html#WebKitSnapshotOptions" title="enum WebKitSnapshotOptions"><span class="type">WebKitSnapshotOptions</span></a> for the snapshot</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>. </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>. </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> user data. </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-view-get-snapshot-finish"></a><h3>webkit_web_view_get_snapshot_finish ()</h3> +<pre class="programlisting"><span class="returnvalue">cairo_surface_t</span> * +webkit_web_view_get_snapshot_finish (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</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>Finishes an asynchronous operation started with <a class="link" href="WebKitWebView.html#webkit-web-view-get-snapshot" title="webkit_web_view_get_snapshot ()"><code class="function">webkit_web_view_get_snapshot()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-snapshot-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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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-view-get-snapshot-finish.returns"></a><h4>Returns</h4> +<p> a <span class="type">cairo_surface_t</span> with the retrieved snapshot or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in error. </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-view-set-background-color"></a><h3>webkit_web_view_set_background_color ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_set_background_color (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code>const <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre> +<p>Sets the color that will be used to draw the <em class="parameter"><code>web_view</code></em> + background before +the actual contents are rendered. Note that if the web page loaded in <em class="parameter"><code>web_view</code></em> + +specifies a background color, it will take precedence over the <em class="parameter"><code>rgba</code></em> + color. +By default the <em class="parameter"><code>web_view</code></em> + background color is opaque white. +Note that the parent window must have a RGBA visual and +<a href="../gtk3/GtkWidget.html#GtkWidget--app-paintable"><span class="type">“app-paintable”</span></a> property set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for backgrounds colors to work.</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</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span> browser_window_set_background_color (BrowserWindow *window, + <span class="type">const</span> GdkRGBA *rgba) +{ + WebKitWebView *web_view; + GdkScreen *screen = gtk_window_get_screen (GTK_WINDOW (window)); + GdkVisual *rgba_visual = gdk_screen_get_rgba_visual (screen); + + <span class="keyword">if</span> (!rgba_visual) + <span class="keyword">return</span>; + + gtk_widget_set_visual (GTK_WIDGET (window), rgba_visual); + gtk_widget_set_app_paintable (GTK_WIDGET (window), TRUE); + + web_view = browser_window_get_web_view (window); + webkit_web_view_set_background_color (web_view, rgba); +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<div class="refsect3"> +<a name="webkit-web-view-set-background-color.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>rgba</p></td> +<td class="parameter_description"><p>a <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</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-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-background-color"></a><h3>webkit_web_view_get_background_color ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_get_background_color (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre> +<p>Gets the color that is used to draw the <em class="parameter"><code>web_view</code></em> + background before +the actual contents are rendered. +For more information see also <a class="link" href="WebKitWebView.html#webkit-web-view-set-background-color" title="webkit_web_view_set_background_color ()"><code class="function">webkit_web_view_set_background_color()</code></a></p> +<div class="refsect3"> +<a name="webkit-web-view-get-background-color.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>rgba</p></td> +<td class="parameter_description"><p> a <a href="../gdk3/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to fill in with the background color. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> +</tr> +</tbody> +</table></div> +</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-view-set-editable"></a><h3>webkit_web_view_set_editable ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_set_editable (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> editable</code></em>);</pre> +<p>Sets whether the user is allowed to edit the HTML document.</p> +<p>If <em class="parameter"><code>editable</code></em> + is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <em class="parameter"><code>web_view</code></em> + allows the user to edit the HTML document. If +<em class="parameter"><code>editable</code></em> + is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, an element in <em class="parameter"><code>web_view</code></em> +'s document can only be edited if the +CONTENTEDITABLE attribute has been set on the element or one of its parent +elements. By default a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is not editable.</p> +<p>Normally, a HTML document is not editable unless the elements within the +document are editable. This function provides a way to make the contents +of a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> editable without altering the document or DOM structure.</p> +<div class="refsect3"> +<a name="webkit-web-view-set-editable.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>editable</p></td> +<td class="parameter_description"><p>a <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> indicating the editable state</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</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-view-is-editable"></a><h3>webkit_web_view_is_editable ()</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +webkit_web_view_is_editable (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-editor-state"></a><h3>webkit_web_view_get_editor_state ()</h3> +<pre class="programlisting"><a class="link" href="WebKitEditorState.html" title="WebKitEditorState"><span class="returnvalue">WebKitEditorState</span></a> * +webkit_web_view_get_editor_state (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the web editor state of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-editor-state.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-editor-state.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitEditorState.html" title="WebKitEditorState"><span class="type">WebKitEditorState</span></a> of the view. </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-view-get-session-state"></a><h3>webkit_web_view_get_session_state ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +webkit_web_view_get_session_state (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Gets the current session state of <em class="parameter"><code>web_view</code></em> +</p> +<div class="refsect3"> +<a name="webkit-web-view-get-session-state.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-session-state.returns"></a><h4>Returns</h4> +<p> a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</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-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-restore-session-state"></a><h3>webkit_web_view_restore_session_state ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_restore_session_state (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>, + <em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> *state</code></em>);</pre> +<p>Restore the <em class="parameter"><code>web_view</code></em> + session state from <em class="parameter"><code>state</code></em> +</p> +<div class="refsect3"> +<a name="webkit-web-view-restore-session-state.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>state</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</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-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-javascript-result-ref"></a><h3>webkit_javascript_result_ref ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="returnvalue">WebKitJavascriptResult</span></a> * +webkit_javascript_result_ref (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> *js_result</code></em>);</pre> +<p>Atomically increments the reference count of <em class="parameter"><code>js_result</code></em> + by one. This +function is MT-safe and may be called from any thread.</p> +<div class="refsect3"> +<a name="webkit-javascript-result-ref.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>js_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-javascript-result-ref.returns"></a><h4>Returns</h4> +<p> The passed in <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-javascript-result-unref"></a><h3>webkit_javascript_result_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_javascript_result_unref (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> *js_result</code></em>);</pre> +<p>Atomically decrements the reference count of <em class="parameter"><code>js_result</code></em> + by one. If the +reference count drops to 0, all memory allocated by the <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> is +released. This function is MT-safe and may be called from any +thread.</p> +<div class="refsect3"> +<a name="webkit-javascript-result-unref.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>js_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-javascript-result-get-global-context"></a><h3>webkit_javascript_result_get_global_context ()</h3> +<pre class="programlisting"><span class="returnvalue">JSGlobalContextRef</span> +webkit_javascript_result_get_global_context + (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> *js_result</code></em>);</pre> +<p>Get the global Javascript context that should be used with the +<code class="function">JSValueRef</code> returned by <a class="link" href="WebKitWebView.html#webkit-javascript-result-get-value" title="webkit_javascript_result_get_value ()"><code class="function">webkit_javascript_result_get_value()</code></a>.</p> +<div class="refsect3"> +<a name="webkit-javascript-result-get-global-context.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>js_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-javascript-result-get-global-context.returns"></a><h4>Returns</h4> +<p> the <code class="function">JSGlobalContextRef</code> for the <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-javascript-result-get-value"></a><h3>webkit_javascript_result_get_value ()</h3> +<pre class="programlisting"><span class="returnvalue">JSValueRef</span> +webkit_javascript_result_get_value (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a> *js_result</code></em>);</pre> +<p>Get the value of <em class="parameter"><code>js_result</code></em> +. You should use the <code class="function">JSGlobalContextRef</code> +returned by <a class="link" href="WebKitWebView.html#webkit-javascript-result-get-global-context" title="webkit_javascript_result_get_global_context ()"><code class="function">webkit_javascript_result_get_global_context()</code></a> to use the <code class="function">JSValueRef</code>.</p> +<div class="refsect3"> +<a name="webkit-javascript-result-get-value.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>js_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-javascript-result-get-value.returns"></a><h4>Returns</h4> +<p> the <code class="function">JSValueRef</code> of the <a class="link" href="WebKitWebView.html#WebKitJavascriptResult"><span class="type">WebKitJavascriptResult</span></a></p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-script-dialog-get-dialog-type"></a><h3>webkit_script_dialog_get_dialog_type ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitScriptDialogType" title="enum WebKitScriptDialogType"><span class="returnvalue">WebKitScriptDialogType</span></a> +webkit_script_dialog_get_dialog_type (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog</code></em>);</pre> +<p>Get the dialog type of a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a>.</p> +<div class="refsect3"> +<a name="webkit-script-dialog-get-dialog-type.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>dialog</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-script-dialog-get-dialog-type.returns"></a><h4>Returns</h4> +<p> the <a class="link" href="WebKitWebView.html#WebKitScriptDialogType" title="enum WebKitScriptDialogType"><span class="type">WebKitScriptDialogType</span></a> of <em class="parameter"><code>dialog</code></em> +</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-script-dialog-get-message"></a><h3>webkit_script_dialog_get_message ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_script_dialog_get_message (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog</code></em>);</pre> +<p>Get the message of a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a>.</p> +<div class="refsect3"> +<a name="webkit-script-dialog-get-message.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>dialog</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-script-dialog-get-message.returns"></a><h4>Returns</h4> +<p> the message of <em class="parameter"><code>dialog</code></em> +.</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-script-dialog-confirm-set-confirmed"></a><h3>webkit_script_dialog_confirm_set_confirmed ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_script_dialog_confirm_set_confirmed + (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog</code></em>, + <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> confirmed</code></em>);</pre> +<p>This method is used for <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_CONFIRM</code></a> and <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-BEFORE-UNLOAD-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONFIRM</code></a> dialogs when +<a class="link" href="WebKitWebView.html#WebKitWebView-script-dialog" title="The “script-dialog” signal"><span class="type">“script-dialog”</span></a> signal is emitted to set whether the user +confirmed the dialog or not. The default implementation of <a class="link" href="WebKitWebView.html#WebKitWebView-script-dialog" title="The “script-dialog” signal"><span class="type">“script-dialog”</span></a> +signal sets <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the OK or Stay buttons are clicked and <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise. +It's an error to use this method with a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> that is not of type +<a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_CONFIRM</code></a> or <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-BEFORE-UNLOAD-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONFIRM</code></a></p> +<div class="refsect3"> +<a name="webkit-script-dialog-confirm-set-confirmed.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>dialog</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>confirmed</p></td> +<td class="parameter_description"><p>whether user confirmed the dialog</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-script-dialog-prompt-get-default-text"></a><h3>webkit_script_dialog_prompt_get_default_text ()</h3> +<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * +webkit_script_dialog_prompt_get_default_text + (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog</code></em>);</pre> +<p>Get the default text of a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> of type <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_PROMPT</code></a>. +It's an error to use this method with a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> that is not of type +<a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_PROMPT</code></a>.</p> +<div class="refsect3"> +<a name="webkit-script-dialog-prompt-get-default-text.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>dialog</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-script-dialog-prompt-get-default-text.returns"></a><h4>Returns</h4> +<p> the default text of <em class="parameter"><code>dialog</code></em> +</p> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-script-dialog-prompt-set-text"></a><h3>webkit_script_dialog_prompt_set_text ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_script_dialog_prompt_set_text (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog</code></em>, + <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre> +<p>This method is used for <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_PROMPT</code></a> dialogs when +<a class="link" href="WebKitWebView.html#WebKitWebView-script-dialog" title="The “script-dialog” signal"><span class="type">“script-dialog”</span></a> signal is emitted to set the text +entered by the user. The default implementation of <a class="link" href="WebKitWebView.html#WebKitWebView-script-dialog" title="The “script-dialog” signal"><span class="type">“script-dialog”</span></a> +signal sets the text of the entry form when OK button is clicked, otherwise <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is set. +It's an error to use this method with a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> that is not of type +<a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_PROMPT</code></a>.</p> +<div class="refsect3"> +<a name="webkit-script-dialog-prompt-set-text.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>dialog</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>text</p></td> +<td class="parameter_description"><p>the text to set</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-get-main-resource"></a><h3>webkit_web_view_get_main_resource ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebResource.html" title="WebKitWebResource"><span class="returnvalue">WebKitWebResource</span></a> * +webkit_web_view_get_main_resource (<em class="parameter"><code><a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view</code></em>);</pre> +<p>Return the main resource of <em class="parameter"><code>web_view</code></em> +.</p> +<div class="refsect3"> +<a name="webkit-web-view-get-main-resource.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>web_view</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-get-main-resource.returns"></a><h4>Returns</h4> +<p> the main <a class="link" href="WebKitWebResource.html" title="WebKitWebResource"><span class="type">WebKitWebResource</span></a> of the view +or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if nothing has been loaded. </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-view-session-state-new"></a><h3>webkit_web_view_session_state_new ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +webkit_web_view_session_state_new (<em class="parameter"><code><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> *data</code></em>);</pre> +<p>Creates a new <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> from serialized data.</p> +<div class="refsect3"> +<a name="webkit-web-view-session-state-new.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>data</p></td> +<td class="parameter_description"><p>a <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-session-state-new.returns"></a><h4>Returns</h4> +<p> a new <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>data</code></em> +doesn't contain a +valid serialized <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</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-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-session-state-ref"></a><h3>webkit_web_view_session_state_ref ()</h3> +<pre class="programlisting"><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="returnvalue">WebKitWebViewSessionState</span></a> * +webkit_web_view_session_state_ref (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> *state</code></em>);</pre> +<p>Atomically increments the reference count of <em class="parameter"><code>state</code></em> + by one. This +function is MT-safe and may be called from any thread.</p> +<div class="refsect3"> +<a name="webkit-web-view-session-state-ref.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>state</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-session-state-ref.returns"></a><h4>Returns</h4> +<p> The passed in <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a></p> +</div> +<p class="since">Since: <a class="link" href="api-index-2-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-session-state-unref"></a><h3>webkit_web_view_session_state_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +webkit_web_view_session_state_unref (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> *state</code></em>);</pre> +<p>Atomically decrements the reference count of <em class="parameter"><code>state</code></em> + by one. If the +reference count drops to 0, all memory allocated by the <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> is +released. This function is MT-safe and may be called from any thread.</p> +<div class="refsect3"> +<a name="webkit-web-view-session-state-unref.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>state</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</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-12.html#api-index-2.12">2.12</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="webkit-web-view-session-state-serialize"></a><h3>webkit_web_view_session_state_serialize ()</h3> +<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="returnvalue">GBytes</span></a> * +webkit_web_view_session_state_serialize + (<em class="parameter"><code><a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a> *state</code></em>);</pre> +<p>Serializes a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a>.</p> +<div class="refsect3"> +<a name="webkit-web-view-session-state-serialize.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>state</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitWebViewSessionState"><span class="type">WebKitWebViewSessionState</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="webkit-web-view-session-state-serialize.returns"></a><h4>Returns</h4> +<p> a <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> containing the <em class="parameter"><code>state</code></em> +serialized. </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-12.html#api-index-2.12">2.12</a></p> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.other_details"></a><h2>Types and Values</h2> +<div class="refsect2"> +<a name="WebKitWebView-struct"></a><h3>WebKitWebView</h3> +<pre class="programlisting">typedef struct _WebKitWebView WebKitWebView;</pre> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitLoadEvent"></a><h3>enum WebKitLoadEvent</h3> +<p>Enum values used to denote the different events that happen during a +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> load operation.</p> +<div class="refsect3"> +<a name="WebKitLoadEvent.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-LOAD-STARTED:CAPS"></a>WEBKIT_LOAD_STARTED</p></td> +<td class="enum_member_description"> +<p>A new load request has been made. +No data has been received yet, empty structures have +been allocated to perform the load; the load may still +fail due to transport issues such as not being able to +resolve a name, or connect to a port.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-LOAD-REDIRECTED:CAPS"></a>WEBKIT_LOAD_REDIRECTED</p></td> +<td class="enum_member_description"> +<p>A provisional data source received +a server redirect.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-LOAD-COMMITTED:CAPS"></a>WEBKIT_LOAD_COMMITTED</p></td> +<td class="enum_member_description"> +<p>The content started arriving for a page load. +The necessary transport requirements are stabilished, and the +load is being performed.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-LOAD-FINISHED:CAPS"></a>WEBKIT_LOAD_FINISHED</p></td> +<td class="enum_member_description"> +<p>Load completed. All resources are done loading +or there was an error during the load operation.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitPolicyDecisionType"></a><h3>enum WebKitPolicyDecisionType</h3> +<p>Enum values used for determining the type of a policy decision during +<a class="link" href="WebKitWebView.html#WebKitWebView-decide-policy" title="The “decide-policy” signal"><span class="type">“decide-policy”</span></a>.</p> +<div class="refsect3"> +<a name="WebKitPolicyDecisionType.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-POLICY-DECISION-TYPE-NAVIGATION-ACTION:CAPS"></a>WEBKIT_POLICY_DECISION_TYPE_NAVIGATION_ACTION</p></td> +<td class="enum_member_description"> +<p>This type of policy decision + is requested when WebKit is about to navigate to a new page in either the + main frame or a subframe. Acceptable policy decisions are either + <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-use" title="webkit_policy_decision_use ()"><code class="function">webkit_policy_decision_use()</code></a> or <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-ignore" title="webkit_policy_decision_ignore ()"><code class="function">webkit_policy_decision_ignore()</code></a>. This + type of policy decision is always a <a class="link" href="WebKitNavigationPolicyDecision.html" title="WebKitNavigationPolicyDecision"><span class="type">WebKitNavigationPolicyDecision</span></a>.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-POLICY-DECISION-TYPE-NEW-WINDOW-ACTION:CAPS"></a>WEBKIT_POLICY_DECISION_TYPE_NEW_WINDOW_ACTION</p></td> +<td class="enum_member_description"> +<p>This type of policy decision + is requested when WebKit is about to create a new window. Acceptable policy + decisions are either <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-use" title="webkit_policy_decision_use ()"><code class="function">webkit_policy_decision_use()</code></a> or + <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-ignore" title="webkit_policy_decision_ignore ()"><code class="function">webkit_policy_decision_ignore()</code></a>. This type of policy decision is always + a <a class="link" href="WebKitNavigationPolicyDecision.html" title="WebKitNavigationPolicyDecision"><span class="type">WebKitNavigationPolicyDecision</span></a>. These decisions are useful for implementing + special actions for new windows, such as forcing the new window to open + in a tab when a keyboard modifier is active or handling a special + target attribute on <a> elements.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-POLICY-DECISION-TYPE-RESPONSE:CAPS"></a>WEBKIT_POLICY_DECISION_TYPE_RESPONSE</p></td> +<td class="enum_member_description"> +<p>This type of decision is used when WebKit has + received a response for a network resource and is about to start the load. + Note that these resources include all subresources of a page such as images + and stylesheets as well as main documents. Appropriate policy responses to + this decision are <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-use" title="webkit_policy_decision_use ()"><code class="function">webkit_policy_decision_use()</code></a>, <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-ignore" title="webkit_policy_decision_ignore ()"><code class="function">webkit_policy_decision_ignore()</code></a>, + or <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-download" title="webkit_policy_decision_download ()"><code class="function">webkit_policy_decision_download()</code></a>. This type of policy decision is always + a <a class="link" href="WebKitResponsePolicyDecision.html" title="WebKitResponsePolicyDecision"><span class="type">WebKitResponsePolicyDecision</span></a>. This decision is useful for forcing + some types of resources to be downloaded rather than rendered in the WebView + or to block the transfer of resources entirely.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitSaveMode"></a><h3>enum WebKitSaveMode</h3> +<p>Enum values to specify the different ways in which a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> +can save its current web page into a self-contained file.</p> +<div class="refsect3"> +<a name="WebKitSaveMode.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-SAVE-MODE-MHTML:CAPS"></a>WEBKIT_SAVE_MODE_MHTML</p></td> +<td class="enum_member_description"> +<p>Save the current page using the MHTML format.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr></tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitInsecureContentEvent"></a><h3>enum WebKitInsecureContentEvent</h3> +<p>Enum values used to denote the different events which can trigger +the detection of insecure content.</p> +<div class="refsect3"> +<a name="WebKitInsecureContentEvent.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-INSECURE-CONTENT-RUN:CAPS"></a>WEBKIT_INSECURE_CONTENT_RUN</p></td> +<td class="enum_member_description"> +<p>Insecure content has been detected by +trying to execute any kind of logic (e.g. a script) from an +untrusted source.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-INSECURE-CONTENT-DISPLAYED:CAPS"></a>WEBKIT_INSECURE_CONTENT_DISPLAYED</p></td> +<td class="enum_member_description"> +<p>Insecure content has been +detected by trying to display any kind of resource (e.g. an image) +from an untrusted source.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitSnapshotOptions"></a><h3>enum WebKitSnapshotOptions</h3> +<p>Enum values used to specify options when taking a snapshot +from a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>.</p> +<div class="refsect3"> +<a name="WebKitSnapshotOptions.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-SNAPSHOT-OPTIONS-NONE:CAPS"></a>WEBKIT_SNAPSHOT_OPTIONS_NONE</p></td> +<td class="enum_member_description"> +<p>Do not include any special options.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SNAPSHOT-OPTIONS-INCLUDE-SELECTION-HIGHLIGHTING:CAPS"></a>WEBKIT_SNAPSHOT_OPTIONS_INCLUDE_SELECTION_HIGHLIGHTING</p></td> +<td class="enum_member_description"> +<p>Whether to include in the +snapshot the highlight of the selected content.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SNAPSHOT-OPTIONS-TRANSPARENT-BACKGROUND:CAPS"></a>WEBKIT_SNAPSHOT_OPTIONS_TRANSPARENT_BACKGROUND</p></td> +<td class="enum_member_description"> +<p>Do not fill the background with white before +rendering the snapshot. Since 2.8</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitSnapshotRegion"></a><h3>enum WebKitSnapshotRegion</h3> +<p>Enum values used to specify the region from which to get a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> +snapshot</p> +<div class="refsect3"> +<a name="WebKitSnapshotRegion.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-SNAPSHOT-REGION-VISIBLE:CAPS"></a>WEBKIT_SNAPSHOT_REGION_VISIBLE</p></td> +<td class="enum_member_description"> +<p>Specifies a snapshot only for the area that is +visible in the webview</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SNAPSHOT-REGION-FULL-DOCUMENT:CAPS"></a>WEBKIT_SNAPSHOT_REGION_FULL_DOCUMENT</p></td> +<td class="enum_member_description"> +<p>A snapshot of the entire document.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-CUT:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_CUT</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_CUT "Cut" +</pre> +<p>The cut clipboard command. Copies the current selection inside +a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> to the clipboard and deletes the selected content. +You can check whether it's possible to execute the command with +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>. In general it's +possible to cut to the clipboard when the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> content is +editable and there is an active selection.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-COPY:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_COPY</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_COPY "Copy" +</pre> +<p>The copy clipboard command. Copies the current selection inside +a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> to the clipboard. +You can check whether it's possible to execute the command with +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>. In general it's +possible to copy to the clipboard when there is an active selection +inside the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-PASTE:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_PASTE</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_PASTE "Paste" +</pre> +<p>The paste clipboard command. Pastes the contents of the clipboard to +a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +You can check whether it's possible to execute the command with +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>. In general it's possible +to paste from the clipboard when the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> content is editable +and clipboard is not empty.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-SELECT-ALL:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_SELECT_ALL</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_SELECT_ALL "SelectAll" +</pre> +<p>The select all command. Selects all the content of the current text field in +a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +It is always possible to select all text, no matter whether the +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> content is editable or not. You can still check it +with <a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-UNDO:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_UNDO</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_UNDO "Undo" +</pre> +<p>The undo command. Undoes the last editing command in a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +You can check whether it's possible to execute the command with +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>. It's only possible +to undo a command after a previously executed editing operation.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-REDO:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_REDO</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_REDO "Redo" +</pre> +<p>The redo command. Redoes a previously undone editing command in +a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +You can check whether it's possible to execute the command with +<a class="link" href="WebKitWebView.html#webkit-web-view-can-execute-editing-command" title="webkit_web_view_can_execute_editing_command ()"><code class="function">webkit_web_view_can_execute_editing_command()</code></a>. It's only possible +to redo a command when it has been previously undone.</p> +</div> +<hr> +<div class="refsect2"> +<a name="WEBKIT-EDITING-COMMAND-INSERT-IMAGE:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_INSERT_IMAGE</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_INSERT_IMAGE "InsertImage" +</pre> +<p>The insert image command. Creates an image element that is inserted at +the current cursor position. It receives an URI as argument, +that is used as the image source. This command should be executed with +<a class="link" href="WebKitWebView.html#webkit-web-view-execute-editing-command-with-argument" title="webkit_web_view_execute_editing_command_with_argument ()"><code class="function">webkit_web_view_execute_editing_command_with_argument()</code></a>.</p> +<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-EDITING-COMMAND-CREATE-LINK:CAPS"></a><h3>WEBKIT_EDITING_COMMAND_CREATE_LINK</h3> +<pre class="programlisting">#define WEBKIT_EDITING_COMMAND_CREATE_LINK "CreateLink" +</pre> +<p>The create link command. Creates a link element that is inserted at +the current cursor position. If there's a selection, the selected text +will be used as the link text, otherwise the URL itself will be used. +It receives the link URL as argument. This command should be executed +with <a class="link" href="WebKitWebView.html#webkit-web-view-execute-editing-command-with-argument" title="webkit_web_view_execute_editing_command_with_argument ()"><code class="function">webkit_web_view_execute_editing_command_with_argument()</code></a></p> +<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="WebKitJavascriptResult-struct"></a><h3>WebKitJavascriptResult</h3> +<pre class="programlisting">typedef struct _WebKitJavascriptResult WebKitJavascriptResult;</pre> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitScriptDialog-struct"></a><h3>WebKitScriptDialog</h3> +<pre class="programlisting">typedef struct _WebKitScriptDialog WebKitScriptDialog;</pre> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitScriptDialogType"></a><h3>enum WebKitScriptDialogType</h3> +<p>Enum values used for determining the type of <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a></p> +<div class="refsect3"> +<a name="WebKitScriptDialogType.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-SCRIPT-DIALOG-ALERT:CAPS"></a>WEBKIT_SCRIPT_DIALOG_ALERT</p></td> +<td class="enum_member_description"> +<p>Alert script dialog, used to show a +message to the user.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SCRIPT-DIALOG-CONFIRM:CAPS"></a>WEBKIT_SCRIPT_DIALOG_CONFIRM</p></td> +<td class="enum_member_description"> +<p>Confirm script dialog, used to ask +confirmation to the user.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"></a>WEBKIT_SCRIPT_DIALOG_PROMPT</p></td> +<td class="enum_member_description"> +<p>Prompt script dialog, used to ask +information to the user.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="WEBKIT-SCRIPT-DIALOG-BEFORE-UNLOAD-CONFIRM:CAPS"></a>WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONFIRM</p></td> +<td class="enum_member_description"> +<p>Before unload confirm dialog, +used to ask confirmation to leave the current page to the user. Since 2.12</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebViewSessionState-struct"></a><h3>WebKitWebViewSessionState</h3> +<pre class="programlisting">typedef struct _WebKitWebViewSessionState WebKitWebViewSessionState;</pre> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.property-details"></a><h2>Property Details</h2> +<div class="refsect2"> +<a name="WebKitWebView--editable"></a><h3>The <code class="literal">“editable”</code> property</h3> +<pre class="programlisting"> “editable” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> +<p>Whether the pages loaded inside <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> are editable. For more +information see <a class="link" href="WebKitWebView.html#webkit-web-view-set-editable" title="webkit_web_view_set_editable ()"><code class="function">webkit_web_view_set_editable()</code></a>.</p> +<p>Flags: Read / Write</p> +<p>Default value: FALSE</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="WebKitWebView--estimated-load-progress"></a><h3>The <code class="literal">“estimated-load-progress”</code> property</h3> +<pre class="programlisting"> “estimated-load-progress” <a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></pre> +<p>An estimate of the percent completion for the current loading operation. +This value will range from 0.0 to 1.0 and, once a load completes, +will remain at 1.0 until a new load starts, at which point it +will be reset to 0.0. +The value is an estimate based on the total number of bytes expected +to be received for a document, including all its possible subresources +and child documents.</p> +<p>Flags: Read</p> +<p>Allowed values: [0,1]</p> +<p>Default value: 0</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--favicon"></a><h3>The <code class="literal">“favicon”</code> property</h3> +<pre class="programlisting"> “favicon” <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></pre> +<p>The favicon currently associated to the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +See <a class="link" href="WebKitWebView.html#webkit-web-view-get-favicon" title="webkit_web_view_get_favicon ()"><code class="function">webkit_web_view_get_favicon()</code></a> for more details.</p> +<p>Flags: Read</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--is-ephemeral"></a><h3>The <code class="literal">“is-ephemeral”</code> property</h3> +<pre class="programlisting"> “is-ephemeral” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> +<p>Whether the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is ephemeral. An ephemeral web view never writes +website data to the client storage, no matter what <a class="link" href="WebKitWebsiteDataManager.html" title="WebKitWebsiteDataManager"><span class="type">WebKitWebsiteDataManager</span></a> +its context is using. This is normally used to implement private browsing mode. +This is a <a href="../gobject/gobject-GParamSpec.html#G-PARAM-CONSTRUCT-ONLY:CAPS"><code class="literal">G_PARAM_CONSTRUCT_ONLY</code></a> property, so you have to create a ephemeral +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> and it can't be changed. Note that all <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>s +created with an ephemeral <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> will be ephemeral automatically. +See also <a class="link" href="WebKitWebContext.html#webkit-web-context-new-ephemeral" title="webkit_web_context_new_ephemeral ()"><code class="function">webkit_web_context_new_ephemeral()</code></a>.</p> +<p>Flags: Read / Write / Construct Only</p> +<p>Default value: FALSE</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="WebKitWebView--is-loading"></a><h3>The <code class="literal">“is-loading”</code> property</h3> +<pre class="programlisting"> “is-loading” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> +<p>Whether the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is currently loading a page. This property becomes +<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> as soon as a new load operation is requested and before the +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> signal is emitted with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-STARTED:CAPS"><code class="literal">WEBKIT_LOAD_STARTED</code></a> and +at that point the active URI is the requested one. +When the load operation finishes the property is set to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> before +<a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> is emitted with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-FINISHED:CAPS"><code class="literal">WEBKIT_LOAD_FINISHED</code></a>.</p> +<p>Flags: Read</p> +<p>Default value: FALSE</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--is-playing-audio"></a><h3>The <code class="literal">“is-playing-audio”</code> property</h3> +<pre class="programlisting"> “is-playing-audio” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> +<p>Whether the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is currently playing audio from a page. +This property becomes <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> as soon as web content starts playing any +kind of audio. When a page is no longer playing any kind of sound, +the property is set back to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> +<p>Flags: Read</p> +<p>Default value: FALSE</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="WebKitWebView--related-view"></a><h3>The <code class="literal">“related-view”</code> property</h3> +<pre class="programlisting"> “related-view” <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *</pre> +<p>The related <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> used when creating the view to share the +same web process. This property is not readable because the related +web view is only valid during the object construction.</p> +<p>Flags: Write / Construct Only</p> +<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="WebKitWebView--settings"></a><h3>The <code class="literal">“settings”</code> property</h3> +<pre class="programlisting"> “settings” <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> *</pre> +<p>The <a class="link" href="WebKitSettings.html" title="WebKitSettings"><span class="type">WebKitSettings</span></a> of the view.</p> +<p>Flags: Write / Construct</p> +<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="WebKitWebView--title"></a><h3>The <code class="literal">“title”</code> property</h3> +<pre class="programlisting"> “title” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<p>The main frame document title of this <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. If +the title has not been received yet, it will be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> +<p>Flags: Read</p> +<p>Default value: NULL</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--uri"></a><h3>The <code class="literal">“uri”</code> property</h3> +<pre class="programlisting"> “uri” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> +<p>The current active URI of the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>. +See <a class="link" href="WebKitWebView.html#webkit-web-view-get-uri" title="webkit_web_view_get_uri ()"><code class="function">webkit_web_view_get_uri()</code></a> for more details.</p> +<p>Flags: Read</p> +<p>Default value: NULL</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--user-content-manager"></a><h3>The <code class="literal">“user-content-manager”</code> property</h3> +<pre class="programlisting"> “user-content-manager” <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> *</pre> +<p>The <a class="link" href="WebKitUserContentManager.html" title="WebKitUserContentManager"><span class="type">WebKitUserContentManager</span></a> of the view.</p> +<p>Flags: Read / Write / Construct Only</p> +<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="WebKitWebView--web-context"></a><h3>The <code class="literal">“web-context”</code> property</h3> +<pre class="programlisting"> “web-context” <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> *</pre> +<p>The <a class="link" href="WebKitWebContext.html" title="WebKitWebContext"><span class="type">WebKitWebContext</span></a> of the view.</p> +<p>Flags: Read / Write / Construct Only</p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView--zoom-level"></a><h3>The <code class="literal">“zoom-level”</code> property</h3> +<pre class="programlisting"> “zoom-level” <a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></pre> +<p>The zoom level of the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> content. +See <a class="link" href="WebKitWebView.html#webkit-web-view-set-zoom-level" title="webkit_web_view_set_zoom_level ()"><code class="function">webkit_web_view_set_zoom_level()</code></a> for more details.</p> +<p>Flags: Read / Write</p> +<p>Allowed values: >= 0</p> +<p>Default value: 1</p> +</div> +</div> +<div class="refsect1"> +<a name="WebKitWebView.signal-details"></a><h2>Signal Details</h2> +<div class="refsect2"> +<a name="WebKitWebView-authenticate"></a><h3>The <code class="literal">“authenticate”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitAuthenticationRequest.html" title="WebKitAuthenticationRequest"><span class="type">WebKitAuthenticationRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when the user is challenged with HTTP +authentication. To let the application access or supply +the credentials as well as to allow the client application +to either cancel the request or perform the authentication, +the signal will pass an instance of the +<a class="link" href="WebKitAuthenticationRequest.html" title="WebKitAuthenticationRequest"><span class="type">WebKitAuthenticationRequest</span></a> in the <em class="parameter"><code>request</code></em> + argument. +To handle this signal asynchronously you should keep a ref +of the request and return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. To disable HTTP authentication +entirely, connect to this signal and simply return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p> +<p>The default signal handler will run a default authentication +dialog asynchronously for the user to interact with.</p> +<div class="refsect3"> +<a name="WebKitWebView-authenticate.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitAuthenticationRequest.html" title="WebKitAuthenticationRequest"><span class="type">WebKitAuthenticationRequest</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> +<div class="refsect3"> +<a name="WebKitWebView-authenticate.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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-2.html#api-index-2.2">2.2</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-close"></a><h3>The <code class="literal">“close”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when closing a <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is requested. This occurs when a +call is made from JavaScript's <code class="function">window.close</code> function or +after trying to close the <em class="parameter"><code>web_view</code></em> + with <a class="link" href="WebKitWebView.html#webkit-web-view-try-close" title="webkit_web_view_try_close ()"><code class="function">webkit_web_view_try_close()</code></a>. +It is the owner's responsibility to handle this signal to hide or +destroy the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>, if necessary.</p> +<div class="refsect3"> +<a name="WebKitWebView-close.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</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="WebKitWebView-context-menu"></a><h3>The <code class="literal">“context-menu”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitContextMenu.html" title="WebKitContextMenu"><span class="type">WebKitContextMenu</span></a> *context_menu, + <a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event, + <a class="link" href="WebKitHitTestResult.html" title="WebKitHitTestResult"><span class="type">WebKitHitTestResult</span></a> *hit_test_result, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when a context menu is about to be displayed to give the application +a chance to customize the proposed menu, prevent the menu from being displayed, +or build its own context menu.</p> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> +<li class="listitem"><p> + To customize the proposed menu you can use <a class="link" href="WebKitContextMenu.html#webkit-context-menu-prepend" title="webkit_context_menu_prepend ()"><code class="function">webkit_context_menu_prepend()</code></a>, + <a class="link" href="WebKitContextMenu.html#webkit-context-menu-append" title="webkit_context_menu_append ()"><code class="function">webkit_context_menu_append()</code></a> or <a class="link" href="WebKitContextMenu.html#webkit-context-menu-insert" title="webkit_context_menu_insert ()"><code class="function">webkit_context_menu_insert()</code></a> to add new + <a class="link" href="WebKitContextMenuItem.html" title="WebKitContextMenuItem"><span class="type">WebKitContextMenuItem</span></a>s to <em class="parameter"><code>context_menu</code></em>, <a class="link" href="WebKitContextMenu.html#webkit-context-menu-move-item" title="webkit_context_menu_move_item ()"><code class="function">webkit_context_menu_move_item()</code></a> + to reorder existing items, or <a class="link" href="WebKitContextMenu.html#webkit-context-menu-remove" title="webkit_context_menu_remove ()"><code class="function">webkit_context_menu_remove()</code></a> to remove an + existing item. The signal handler should return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, and the menu represented + by <em class="parameter"><code>context_menu</code></em> will be shown. +</p></li> +<li class="listitem"><p> + To prevent the menu from being displayed you can just connect to this signal + and return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> so that the proposed menu will not be shown. +</p></li> +<li class="listitem"><p> + To build your own menu, you can remove all items from the proposed menu with + <a class="link" href="WebKitContextMenu.html#webkit-context-menu-remove-all" title="webkit_context_menu_remove_all ()"><code class="function">webkit_context_menu_remove_all()</code></a>, add your own items and return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> so + that the menu will be shown. You can also ignore the proposed <a class="link" href="WebKitContextMenu.html" title="WebKitContextMenu"><span class="type">WebKitContextMenu</span></a>, + build your own <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> and return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to prevent the proposed menu from being shown. +</p></li> +<li class="listitem"><p> + If you just want the default menu to be shown always, simply don't connect to this + signal because showing the proposed context menu is the default behaviour. +</p></li> +</ul></div> +<p>The <em class="parameter"><code>event</code></em> + is expected to be one of the following types:</p> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> +<li class="listitem"><p> +a <a href="../gdk3/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> of type <a href="../gdk3/gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> when the context menu +was triggered with mouse. +</p></li> +<li class="listitem"><p> +a <a href="../gdk3/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> of type <a href="../gdk3/gdk3-Events.html#GDK-KEY-PRESS:CAPS"><code class="literal">GDK_KEY_PRESS</code></a> if the keyboard was used to show +the menu. +</p></li> +<li class="listitem"><p> +a generic <a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> of type <a href="../gdk3/gdk3-Events.html#GDK-NOTHING:CAPS"><code class="literal">GDK_NOTHING</code></a> when the <span class="type">“popup-menu”</span> +signal was used to show the context menu. +</p></li> +</ul></div> +<p>If the signal handler returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> the context menu represented by <em class="parameter"><code>context_menu</code></em> + +will be shown, if it return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the context menu will not be shown.</p> +<p>The proposed <a class="link" href="WebKitContextMenu.html" title="WebKitContextMenu"><span class="type">WebKitContextMenu</span></a> passed in <em class="parameter"><code>context_menu</code></em> + argument is only valid +during the signal emission.</p> +<div class="refsect3"> +<a name="WebKitWebView-context-menu.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>context_menu</p></td> +<td class="parameter_description"><p>the proposed <a class="link" href="WebKitContextMenu.html" title="WebKitContextMenu"><span class="type">WebKitContextMenu</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>event</p></td> +<td class="parameter_description"><p>the <a href="../gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that triggered the context menu</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>hit_test_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitHitTestResult.html" title="WebKitHitTestResult"><span class="type">WebKitHitTestResult</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> +<div class="refsect3"> +<a name="WebKitWebView-context-menu.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-context-menu-dismissed"></a><h3>The <code class="literal">“context-menu-dismissed”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted after <a class="link" href="WebKitWebView.html#WebKitWebView-context-menu" title="The “context-menu” signal"><span class="type">“context-menu”</span></a> signal, if the context menu is shown, +to notify that the context menu is dismissed.</p> +<div class="refsect3"> +<a name="WebKitWebView-context-menu-dismissed.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</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="WebKitWebView-create"></a><h3>The <code class="literal">“create”</code> signal</h3> +<pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a>* +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitNavigationAction.html" title="WebKitNavigationAction"><span class="type">WebKitNavigationAction</span></a> *navigation_action, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when the creation of a new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is requested. +If this signal is handled the signal handler should return the +newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a>.</p> +<p>The <a class="link" href="WebKitNavigationAction.html" title="WebKitNavigationAction"><span class="type">WebKitNavigationAction</span></a> parameter contains information about the +navigation action that triggered this signal.</p> +<p>When using <a class="link" href="WebKitWebContext.html#WEBKIT-PROCESS-MODEL-MULTIPLE-SECONDARY-PROCESSES:CAPS"><code class="literal">WEBKIT_PROCESS_MODEL_MULTIPLE_SECONDARY_PROCESSES</code></a> +process model, the new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> should be related to +<em class="parameter"><code>web_view</code></em> + to share the same web process, see <a class="link" href="WebKitWebView.html#webkit-web-view-new-with-related-view" title="webkit_web_view_new_with_related_view ()"><code class="function">webkit_web_view_new_with_related_view()</code></a> +for more details.</p> +<p>The new <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> should not be displayed to the user +until the <a class="link" href="WebKitWebView.html#WebKitWebView-ready-to-show" title="The “ready-to-show” signal"><span class="type">“ready-to-show”</span></a> signal is emitted.</p> +<div class="refsect3"> +<a name="WebKitWebView-create.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>navigation_action</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitNavigationAction.html" title="WebKitNavigationAction"><span class="type">WebKitNavigationAction</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> +<div class="refsect3"> +<a name="WebKitWebView-create.returns"></a><h4>Returns</h4> +<p> a newly allocated <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> widget +or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to propagate the event further. </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>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-decide-policy"></a><h3>The <code class="literal">“decide-policy”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitPolicyDecision.html" title="WebKitPolicyDecision"><span class="type">WebKitPolicyDecision</span></a> *decision, + <a class="link" href="WebKitWebView.html#WebKitPolicyDecisionType" title="enum WebKitPolicyDecisionType"><span class="type">WebKitPolicyDecisionType</span></a> decision_type, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when WebKit is requesting the client to decide a policy +decision, such as whether to navigate to a page, open a new window or whether or +not to download a resource. The <a class="link" href="WebKitNavigationPolicyDecision.html" title="WebKitNavigationPolicyDecision"><span class="type">WebKitNavigationPolicyDecision</span></a> passed in the +<em class="parameter"><code>decision</code></em> + argument is a generic type, but should be casted to a more +specific type when making the decision. For example:</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</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> gboolean +decide_policy_cb (WebKitWebView *web_view, + WebKitPolicyDecision *decision, + WebKitPolicyDecisionType type) +{ + <span class="keyword">switch</span> (type) { + <span class="keyword">case</span> WEBKIT_POLICY_DECISION_TYPE_NAVIGATION_ACTION: + WebKitNavigationPolicyDecision *navigation_decision = WEBKIT_NAVIGATION_POLICY_DECISION (decision); + <span class="comment">/*</span><span class="comment"> Make a policy decision here. </span><span class="comment">*/</span> + <span class="keyword">break</span>; + <span class="keyword">case</span> WEBKIT_POLICY_DECISION_TYPE_NEW_WINDOW_ACTION: + WebKitNavigationPolicyDecision *navigation_decision = WEBKIT_NAVIGATION_POLICY_DECISION (decision); + <span class="comment">/*</span><span class="comment"> Make a policy decision here. </span><span class="comment">*/</span> + <span class="keyword">break</span>; + <span class="keyword">case</span> WEBKIT_POLICY_DECISION_TYPE_RESPONSE: + WebKitResponsePolicyDecision *response = WEBKIT_RESPONSE_POLICY_DECISION (decision); + <span class="comment">/*</span><span class="comment"> Make a policy decision here. </span><span class="comment">*/</span> + <span class="keyword">break</span>; + <span class="keyword">default</span>: + <span class="comment">/*</span><span class="comment"> Making no decision results in webkit_policy_decision_use(). </span><span class="comment">*/</span> + <span class="keyword">return</span> FALSE; + } + <span class="keyword">return</span> TRUE; +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<p>It is possible to make policy decision asynchronously, by simply calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> +on the <em class="parameter"><code>decision</code></em> + argument and returning <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to block the default signal handler. +If the last reference is removed on a <a class="link" href="WebKitPolicyDecision.html" title="WebKitPolicyDecision"><span class="type">WebKitPolicyDecision</span></a> and no decision has been +made explicitly, <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-use" title="webkit_policy_decision_use ()"><code class="function">webkit_policy_decision_use()</code></a> will be the default policy decision. The +default signal handler will simply call <a class="link" href="WebKitPolicyDecision.html#webkit-policy-decision-use" title="webkit_policy_decision_use ()"><code class="function">webkit_policy_decision_use()</code></a>. Only the first +policy decision chosen for a given <a class="link" href="WebKitPolicyDecision.html" title="WebKitPolicyDecision"><span class="type">WebKitPolicyDecision</span></a> will have any affect.</p> +<div class="refsect3"> +<a name="WebKitWebView-decide-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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>decision</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitPolicyDecision.html" title="WebKitPolicyDecision"><span class="type">WebKitPolicyDecision</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>decision_type</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebView.html#WebKitPolicyDecisionType" title="enum WebKitPolicyDecisionType"><span class="type">WebKitPolicyDecisionType</span></a> denoting the type of <em class="parameter"><code>decision</code></em> +</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> +<div class="refsect3"> +<a name="WebKitWebView-decide-policy.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-enter-fullscreen"></a><h3>The <code class="literal">“enter-fullscreen”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when JavaScript code calls +<code class="function">element.webkitRequestFullScreen</code>. If the +signal is not handled the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> will proceed to full screen +its top level window. This signal can be used by client code to +request permission to the user prior doing the full screen +transition and eventually prepare the top-level window +(e.g. hide some widgets that would otherwise be part of the +full screen window).</p> +<div class="refsect3"> +<a name="WebKitWebView-enter-fullscreen.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted.</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> +<div class="refsect3"> +<a name="WebKitWebView-enter-fullscreen.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to continue emission of the event.</p> +</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="WebKitWebView-insecure-content-detected"></a><h3>The <code class="literal">“insecure-content-detected”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitWebView.html#WebKitInsecureContentEvent" title="enum WebKitInsecureContentEvent"><span class="type">WebKitInsecureContentEvent</span></a> event, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when insecure content has been detected +in a page loaded through a secure connection. This typically +means that a external resource from an unstrusted source has +been run or displayed, resulting in a mix of HTTPS and +non-HTTPS content.</p> +<p>You can check the <em class="parameter"><code>event</code></em> + parameter to know exactly which kind +of event has been detected (see <a class="link" href="WebKitWebView.html#WebKitInsecureContentEvent" title="enum WebKitInsecureContentEvent"><span class="type">WebKitInsecureContentEvent</span></a>).</p> +<div class="refsect3"> +<a name="WebKitWebView-insecure-content-detected.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>event</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitInsecureContentEvent" title="enum WebKitInsecureContentEvent"><span class="type">WebKitInsecureContentEvent</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> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-leave-fullscreen"></a><h3>The <code class="literal">“leave-fullscreen”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> is about to restore its top level +window out of its full screen state. This signal can be used by +client code to restore widgets hidden during the +<a class="link" href="WebKitWebView.html#WebKitWebView-enter-fullscreen" title="The “enter-fullscreen” signal"><span class="type">“enter-fullscreen”</span></a> stage for instance.</p> +<div class="refsect3"> +<a name="WebKitWebView-leave-fullscreen.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted.</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> +<div class="refsect3"> +<a name="WebKitWebView-leave-fullscreen.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to continue emission of the event.</p> +</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="WebKitWebView-load-changed"></a><h3>The <code class="literal">“load-changed”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitWebView.html#WebKitLoadEvent" title="enum WebKitLoadEvent"><span class="type">WebKitLoadEvent</span></a> load_event, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when the a load operation in <em class="parameter"><code>web_view</code></em> + changes. +The signal is always emitted with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-STARTED:CAPS"><code class="literal">WEBKIT_LOAD_STARTED</code></a> when a +new load request is made and <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-FINISHED:CAPS"><code class="literal">WEBKIT_LOAD_FINISHED</code></a> when the load +finishes successfully or due to an error. When the ongoing load +operation fails <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal"><span class="type">“load-failed”</span></a> signal is emitted +before <a class="link" href="WebKitWebView.html#WebKitWebView-load-changed" title="The “load-changed” signal"><span class="type">“load-changed”</span></a> is emitted with +<a class="link" href="WebKitWebView.html#WEBKIT-LOAD-FINISHED:CAPS"><code class="literal">WEBKIT_LOAD_FINISHED</code></a>. +If a redirection is received from the server, this signal is emitted +with <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-REDIRECTED:CAPS"><code class="literal">WEBKIT_LOAD_REDIRECTED</code></a> after the initial emission with +<a class="link" href="WebKitWebView.html#WEBKIT-LOAD-STARTED:CAPS"><code class="literal">WEBKIT_LOAD_STARTED</code></a> and before <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-COMMITTED:CAPS"><code class="literal">WEBKIT_LOAD_COMMITTED</code></a>. +When the page content starts arriving the signal is emitted with +<a class="link" href="WebKitWebView.html#WEBKIT-LOAD-COMMITTED:CAPS"><code class="literal">WEBKIT_LOAD_COMMITTED</code></a> event.</p> +<p>You can handle this signal and use a switch to track any ongoing +load operation.</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</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span> web_view_load_changed (WebKitWebView *web_view, + WebKitLoadEvent load_event, + gpointer user_data) +{ + <span class="keyword">switch</span> (load_event) { + <span class="keyword">case</span> WEBKIT_LOAD_STARTED: + <span class="comment">/*</span><span class="comment"> New load, we have now a provisional URI </span><span class="comment">*/</span> + provisional_uri = webkit_web_view_get_uri (web_view); + <span class="comment">/*</span><span class="comment"> Here we could start a spinner or update the</span> +<span class="comment"> * location bar with the provisional URI </span><span class="comment">*/</span> + <span class="keyword">break</span>; + <span class="keyword">case</span> WEBKIT_LOAD_REDIRECTED: + redirected_uri = webkit_web_view_get_uri (web_view); + <span class="keyword">break</span>; + <span class="keyword">case</span> WEBKIT_LOAD_COMMITTED: + <span class="comment">/*</span><span class="comment"> The load is being performed. Current URI is</span> +<span class="comment"> * the final one and it won't change unless a new</span> +<span class="comment"> * load is requested or a navigation within the</span> +<span class="comment"> * same page is performed </span><span class="comment">*/</span> + uri = webkit_web_view_get_uri (web_view); + <span class="keyword">break</span>; + <span class="keyword">case</span> WEBKIT_LOAD_FINISHED: + <span class="comment">/*</span><span class="comment"> Load finished, we can now stop the spinner </span><span class="comment">*/</span> + <span class="keyword">break</span>; + } +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<div class="refsect3"> +<a name="WebKitWebView-load-changed.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>load_event</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitLoadEvent" title="enum WebKitLoadEvent"><span class="type">WebKitLoadEvent</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> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-load-failed"></a><h3>The <code class="literal">“load-failed”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitWebView.html#WebKitLoadEvent" title="enum WebKitLoadEvent"><span class="type">WebKitLoadEvent</span></a> load_event, + <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *failing_uri, + <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when an error occurs during a load operation. +If the error happened when starting to load data for a page +<em class="parameter"><code>load_event</code></em> + will be <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-STARTED:CAPS"><code class="literal">WEBKIT_LOAD_STARTED</code></a>. If it happened while +loading a committed data source <em class="parameter"><code>load_event</code></em> + will be <a class="link" href="WebKitWebView.html#WEBKIT-LOAD-COMMITTED:CAPS"><code class="literal">WEBKIT_LOAD_COMMITTED</code></a>. +Since a load error causes the load operation to finish, the signal +WebKitWebView::load-changed will always be emitted with +<a class="link" href="WebKitWebView.html#WEBKIT-LOAD-FINISHED:CAPS"><code class="literal">WEBKIT_LOAD_FINISHED</code></a> event right after this one.</p> +<p>By default, if the signal is not handled, a stock error page will be displayed. +You need to handle the signal if you want to provide your own error page.</p> +<div class="refsect3"> +<a name="WebKitWebView-load-failed.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>load_event</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitLoadEvent" title="enum WebKitLoadEvent"><span class="type">WebKitLoadEvent</span></a> of the load operation</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>failing_uri</p></td> +<td class="parameter_description"><p>the URI that failed to load</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>error</p></td> +<td class="parameter_description"><p>the <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that was triggered</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> +<div class="refsect3"> +<a name="WebKitWebView-load-failed.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-load-failed-with-tls-errors"></a><h3>The <code class="literal">“load-failed-with-tls-errors”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *failing_uri, + <a href="../gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a> *certificate, + <a href="../gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> errors, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when a TLS error occurs during a load operation. +To allow an exception for this <em class="parameter"><code>certificate</code></em> + +and the host of <em class="parameter"><code>failing_uri</code></em> + use <a class="link" href="WebKitWebContext.html#webkit-web-context-allow-tls-certificate-for-host" title="webkit_web_context_allow_tls_certificate_for_host ()"><code class="function">webkit_web_context_allow_tls_certificate_for_host()</code></a>.</p> +<p>To handle this signal asynchronously you should call <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on <em class="parameter"><code>certificate</code></em> + +and return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p> +<p>If <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, <a class="link" href="WebKitWebView.html#WebKitWebView-load-failed" title="The “load-failed” signal"><span class="type">“load-failed”</span></a> will be emitted. The load +will finish regardless of the returned value.</p> +<div class="refsect3"> +<a name="WebKitWebView-load-failed-with-tls-errors.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>failing_uri</p></td> +<td class="parameter_description"><p>the URI that failed to load</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>errors</p></td> +<td class="parameter_description"><p>a <a href="../gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> with the verification status of <em class="parameter"><code>certificate</code></em> +</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> +<div class="refsect3"> +<a name="WebKitWebView-load-failed-with-tls-errors.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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-6.html#api-index-2.6">2.6</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-mouse-target-changed"></a><h3>The <code class="literal">“mouse-target-changed”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitHitTestResult.html" title="WebKitHitTestResult"><span class="type">WebKitHitTestResult</span></a> *hit_test_result, + <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> modifiers, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when the mouse cursor moves over an +element such as a link, image or a media element. To determine +what type of element the mouse cursor is over, a Hit Test is performed +on the current mouse coordinates and the result is passed in the +<em class="parameter"><code>hit_test_result</code></em> + argument. The <em class="parameter"><code>modifiers</code></em> + argument is a bitmask of +<a href="../gdk3/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> flags indicating the state of modifier keys. +The signal is emitted again when the mouse is moved out of the +current element with a new <em class="parameter"><code>hit_test_result</code></em> +.</p> +<div class="refsect3"> +<a name="WebKitWebView-mouse-target-changed.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>hit_test_result</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitHitTestResult.html" title="WebKitHitTestResult"><span class="type">WebKitHitTestResult</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>modifiers</p></td> +<td class="parameter_description"><p>a bitmask of <a href="../gdk3/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</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> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-permission-request"></a><h3>The <code class="literal">“permission-request”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitPermissionRequest.html" title="WebKitPermissionRequest"><span class="type">WebKitPermissionRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when WebKit is requesting the client to +decide about a permission request, such as allowing the browser +to switch to fullscreen mode, sharing its location or similar +operations.</p> +<p>A possible way to use this signal could be through a dialog +allowing the user decide what to do with the request:</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</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">static</span> gboolean permission_request_cb (WebKitWebView *web_view, + WebKitPermissionRequest *request, + GtkWindow *parent_window) +{ + GtkWidget *dialog = gtk_message_dialog_new (parent_window, + GTK_DIALOG_MODAL, + GTK_MESSAGE_QUESTION, + GTK_BUTTONS_YES_NO, + <span class="number">"Allow Permission Request?"</span>); + gtk_widget_show (dialog); + gint result = gtk_dialog_run (GTK_DIALOG (dialog)); + + <span class="keyword">switch</span> (result) { + <span class="keyword">case</span> GTK_RESPONSE_YES: + webkit_permission_request_allow (request); + <span class="keyword">break</span>; + <span class="keyword">default</span>: + webkit_permission_request_deny (request); + <span class="keyword">break</span>; + } + gtk_widget_destroy (dialog); + + <span class="keyword">return</span> TRUE; +}</pre></td> + </tr> + </tbody> + </table> +</div> + +<p>It is possible to handle permission requests asynchronously, by +simply calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on the <em class="parameter"><code>request</code></em> + argument and +returning <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to block the default signal handler. If the +last reference is removed on a <a class="link" href="WebKitPermissionRequest.html" title="WebKitPermissionRequest"><span class="type">WebKitPermissionRequest</span></a> and the +request has not been handled, <a class="link" href="WebKitPermissionRequest.html#webkit-permission-request-deny" title="webkit_permission_request_deny ()"><code class="function">webkit_permission_request_deny()</code></a> +will be the default action.</p> +<p>If the signal is not handled, the <em class="parameter"><code>request</code></em> + will be completed automatically +by the specific <a class="link" href="WebKitPermissionRequest.html" title="WebKitPermissionRequest"><span class="type">WebKitPermissionRequest</span></a> that could allow or deny it. Check the +documentation of classes implementing <a class="link" href="WebKitPermissionRequest.html" title="WebKitPermissionRequest"><span class="type">WebKitPermissionRequest</span></a> interface to know +their default action.</p> +<div class="refsect3"> +<a name="WebKitWebView-permission-request.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitPermissionRequest.html" title="WebKitPermissionRequest"><span class="type">WebKitPermissionRequest</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> +<div class="refsect3"> +<a name="WebKitWebView-permission-request.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-print"></a><h3>The <code class="literal">“print”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitPrintOperation.html" title="WebKitPrintOperation"><span class="type">WebKitPrintOperation</span></a> *print_operation, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when printing is requested on <em class="parameter"><code>web_view</code></em> +, usually by a javascript call, +before the print dialog is shown. This signal can be used to set the initial +print settings and page setup of <em class="parameter"><code>print_operation</code></em> + to be used as default values in +the print dialog. You can call <a class="link" href="WebKitPrintOperation.html#webkit-print-operation-set-print-settings" title="webkit_print_operation_set_print_settings ()"><code class="function">webkit_print_operation_set_print_settings()</code></a> and +<a class="link" href="WebKitPrintOperation.html#webkit-print-operation-set-page-setup" title="webkit_print_operation_set_page_setup ()"><code class="function">webkit_print_operation_set_page_setup()</code></a> and then return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the +event so that the print dialog is shown.</p> +<p>You can connect to this signal and return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to cancel the print operation +or implement your own print dialog.</p> +<div class="refsect3"> +<a name="WebKitWebView-print.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>print_operation</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitPrintOperation.html" title="WebKitPrintOperation"><span class="type">WebKitPrintOperation</span></a> that will handle the print request</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> +<div class="refsect3"> +<a name="WebKitWebView-print.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-ready-to-show"></a><h3>The <code class="literal">“ready-to-show”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted after <a class="link" href="WebKitWebView.html#WebKitWebView-create" title="The “create” signal"><span class="type">“create”</span></a> on the newly created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> +when it should be displayed to the user. When this signal is emitted +all the information about how the window should look, including +size, position, whether the location, status and scrollbars +should be displayed, is already set on the <a class="link" href="WebKitWindowProperties.html" title="WebKitWindowProperties"><span class="type">WebKitWindowProperties</span></a> +of <em class="parameter"><code>web_view</code></em> +. See also <a class="link" href="WebKitWebView.html#webkit-web-view-get-window-properties" title="webkit_web_view_get_window_properties ()"><code class="function">webkit_web_view_get_window_properties()</code></a>.</p> +<div class="refsect3"> +<a name="WebKitWebView-ready-to-show.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</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="WebKitWebView-resource-load-started"></a><h3>The <code class="literal">“resource-load-started”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitWebResource.html" title="WebKitWebResource"><span class="type">WebKitWebResource</span></a> *resource, + <a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when a new resource is going to be loaded. The <em class="parameter"><code>request</code></em> + parameter +contains the <a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</span></a> that will be sent to the server. +You can monitor the load operation by connecting to the different signals +of <em class="parameter"><code>resource</code></em> +.</p> +<div class="refsect3"> +<a name="WebKitWebView-resource-load-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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>resource</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitWebResource.html" title="WebKitWebResource"><span class="type">WebKitWebResource</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitURIRequest.html" title="WebKitURIRequest"><span class="type">WebKitURIRequest</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> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-run-as-modal"></a><h3>The <code class="literal">“run-as-modal”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted after <a class="link" href="WebKitWebView.html#WebKitWebView-ready-to-show" title="The “ready-to-show” signal"><span class="type">“ready-to-show”</span></a> on the newly +created <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> when JavaScript code calls +<code class="function">window.showModalDialog</code>. The purpose of +this signal is to allow the client application to prepare the +new view to behave as modal. Once the signal is emitted a new +mainloop will be run to block user interaction in the parent +<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> until the new dialog is closed.</p> +<div class="refsect3"> +<a name="WebKitWebView-run-as-modal.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</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="WebKitWebView-run-color-chooser"></a><h3>The <code class="literal">“run-color-chooser”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitColorChooserRequest.html" title="WebKitColorChooserRequest"><span class="type">WebKitColorChooserRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when the user interacts with a <input +type='color' /> HTML element, requesting from WebKit to show +a dialog to select a color. To let the application know the details of +the color chooser, as well as to allow the client application to either +cancel the request or perform an actual color selection, the signal will +pass an instance of the <a class="link" href="WebKitColorChooserRequest.html" title="WebKitColorChooserRequest"><span class="type">WebKitColorChooserRequest</span></a> in the <em class="parameter"><code>request</code></em> + +argument.</p> +<p>It is possible to handle this request asynchronously by increasing the +reference count of the request.</p> +<p>The default signal handler will asynchronously run a regular +<a href="../gtk3/GtkColorChooser.html#GtkColorChooser-struct"><span class="type">GtkColorChooser</span></a> for the user to interact with.</p> +<div class="refsect3"> +<a name="WebKitWebView-run-color-chooser.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitColorChooserRequest.html" title="WebKitColorChooserRequest"><span class="type">WebKitColorChooserRequest</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> +<div class="refsect3"> +<a name="WebKitWebView-run-color-chooser.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-run-file-chooser"></a><h3>The <code class="literal">“run-file-chooser”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitFileChooserRequest.html" title="WebKitFileChooserRequest"><span class="type">WebKitFileChooserRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when the user interacts with a <input +type='file' /> HTML element, requesting from WebKit to show +a dialog to select one or more files to be uploaded. To let the +application know the details of the file chooser, as well as to +allow the client application to either cancel the request or +perform an actual selection of files, the signal will pass an +instance of the <a class="link" href="WebKitFileChooserRequest.html" title="WebKitFileChooserRequest"><span class="type">WebKitFileChooserRequest</span></a> in the <em class="parameter"><code>request</code></em> + +argument.</p> +<p>The default signal handler will asynchronously run a regular +<a href="../gtk3/GtkFileChooserDialog.html#GtkFileChooserDialog-struct"><span class="type">GtkFileChooserDialog</span></a> for the user to interact with.</p> +<div class="refsect3"> +<a name="WebKitWebView-run-file-chooser.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitFileChooserRequest.html" title="WebKitFileChooserRequest"><span class="type">WebKitFileChooserRequest</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> +<div class="refsect3"> +<a name="WebKitWebView-run-file-chooser.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-script-dialog"></a><h3>The <code class="literal">“script-dialog”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> *dialog, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>Emitted when JavaScript code calls <code class="function">window.alert</code>, +<code class="function">window.confirm</code> or <code class="function">window.prompt</code>, +or when <code class="function">onbeforeunload</code> event is fired. +The <em class="parameter"><code>dialog</code></em> + parameter should be used to build the dialog. +If the signal is not handled a different dialog will be built and shown depending +on the dialog type:</p> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> +<li class="listitem"><p> + <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-ALERT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_ALERT</code></a>: message dialog with a single Close button. +</p></li> +<li class="listitem"><p> + <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_CONFIRM</code></a>: message dialog with OK and Cancel buttons. +</p></li> +<li class="listitem"><p> + <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-PROMPT:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_PROMPT</code></a>: message dialog with OK and Cancel buttons and + a text entry with the default text. +</p></li> +<li class="listitem"><p> + <a class="link" href="WebKitWebView.html#WEBKIT-SCRIPT-DIALOG-BEFORE-UNLOAD-CONFIRM:CAPS"><code class="literal">WEBKIT_SCRIPT_DIALOG_BEFORE_UNLOAD_CONFIRM</code></a>: message dialog with Stay and Leave buttons. +</p></li> +</ul></div> +<div class="refsect3"> +<a name="WebKitWebView-script-dialog.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>dialog</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html#WebKitScriptDialog"><span class="type">WebKitScriptDialog</span></a> to show</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> +<div class="refsect3"> +<a name="WebKitWebView-script-dialog.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</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="WebKitWebView-show-notification"></a><h3>The <code class="literal">“show-notification”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitNotification.html" title="WebKitNotification"><span class="type">WebKitNotification</span></a> *notification, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when a notification should be presented to the +user. The <em class="parameter"><code>notification</code></em> + is kept alive until either: 1) the web page cancels it +or 2) a navigation happens.</p> +<p>The default handler will emit a notification using libnotify, if built with +support for it.</p> +<div class="refsect3"> +<a name="WebKitWebView-show-notification.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>notification</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitNotification.html" title="WebKitNotification"><span class="type">WebKitNotification</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> +<div class="refsect3"> +<a name="WebKitWebView-show-notification.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p> +</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-8.html#api-index-2.8">2.8</a></p> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-submit-form"></a><h3>The <code class="literal">“submit-form”</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a class="link" href="WebKitFormSubmissionRequest.html" title="WebKitFormSubmissionRequest"><span class="type">WebKitFormSubmissionRequest</span></a> *request, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when a form is about to be submitted. The <em class="parameter"><code>request</code></em> + +argument passed contains information about the text fields of the form. This +is typically used to store login information that can be used later to +pre-fill the form. +The form will not be submitted until <a class="link" href="WebKitFormSubmissionRequest.html#webkit-form-submission-request-submit" title="webkit_form_submission_request_submit ()"><code class="function">webkit_form_submission_request_submit()</code></a> is called.</p> +<p>It is possible to handle the form submission request asynchronously, by +simply calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on the <em class="parameter"><code>request</code></em> + argument and calling +<a class="link" href="WebKitFormSubmissionRequest.html#webkit-form-submission-request-submit" title="webkit_form_submission_request_submit ()"><code class="function">webkit_form_submission_request_submit()</code></a> when done to continue with the form submission. +If the last reference is removed on a <a class="link" href="WebKitFormSubmissionRequest.html" title="WebKitFormSubmissionRequest"><span class="type">WebKitFormSubmissionRequest</span></a> and the +form has not been submitted, <a class="link" href="WebKitFormSubmissionRequest.html#webkit-form-submission-request-submit" title="webkit_form_submission_request_submit ()"><code class="function">webkit_form_submission_request_submit()</code></a> will be called.</p> +<div class="refsect3"> +<a name="WebKitWebView-submit-form.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> on which the signal is emitted</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>request</p></td> +<td class="parameter_description"><p>a <a class="link" href="WebKitFormSubmissionRequest.html" title="WebKitFormSubmissionRequest"><span class="type">WebKitFormSubmissionRequest</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> +</div> +<hr> +<div class="refsect2"> +<a name="WebKitWebView-web-process-crashed"></a><h3>The <code class="literal">“web-process-crashed”</code> signal</h3> +<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +user_function (<a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</span></a> *web_view, + <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre> +<p>This signal is emitted when the web process crashes.</p> +<div class="refsect3"> +<a name="WebKitWebView-web-process-crashed.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>web_view</p></td> +<td class="parameter_description"><p>the <a class="link" href="WebKitWebView.html" title="WebKitWebView"><span class="type">WebKitWebView</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> +<div class="refsect3"> +<a name="WebKitWebView-web-process-crashed.returns"></a><h4>Returns</h4> +<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event. +<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p> +</div> +<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</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 |