webkit_web_view_can_copy_clipboard ()

gboolean
webkit_web_view_can_copy_clipboard (WebKitWebView *web_view);

Determines whether or not it is currently possible to copy to the clipboard.

webkit_web_view_can_cut_clipboard ()

gboolean
webkit_web_view_can_cut_clipboard (WebKitWebView *web_view);

Determines whether or not it is currently possible to cut to the clipboard.

webkit_web_view_can_go_back ()

gboolean
webkit_web_view_can_go_back (WebKitWebView *web_view);

Determines whether web_view has a previous history item.

webkit_web_view_can_go_back_or_forward ()

gboolean
webkit_web_view_can_go_back_or_forward
                               (WebKitWebView *web_view,
                                gint steps);

Determines whether web_view has a history item of steps . Negative values represent steps backward while positive values represent steps forward.

webkit_web_view_can_go_forward ()

gboolean
webkit_web_view_can_go_forward (WebKitWebView *web_view);

Determines whether web_view has a next history item.

webkit_web_view_can_paste_clipboard ()

gboolean
webkit_web_view_can_paste_clipboard (WebKitWebView *web_view);

Determines whether or not it is currently possible to paste from the clipboard.

webkit_web_view_can_redo ()

gboolean
webkit_web_view_can_redo (WebKitWebView *web_view);

Determines whether or not it is currently possible to redo the last editing command in the view.

Since: 1.1.14

webkit_web_view_can_show_mime_type ()

gboolean
webkit_web_view_can_show_mime_type (WebKitWebView *web_view,
                                    const gchar *mime_type);

This functions returns whether or not a MIME type can be displayed using this view.

Since: 1.0.3

webkit_web_view_can_undo ()

gboolean
webkit_web_view_can_undo (WebKitWebView *web_view);

Determines whether or not it is currently possible to undo the last editing command in the view.

Since: 1.1.14

webkit_web_view_copy_clipboard ()

void
webkit_web_view_copy_clipboard (WebKitWebView *web_view);

Copies the current selection inside the web_view to the clipboard.

webkit_web_view_cut_clipboard ()

void
webkit_web_view_cut_clipboard (WebKitWebView *web_view);

Cuts the current selection inside the web_view to the clipboard.

webkit_web_view_delete_selection ()

void
webkit_web_view_delete_selection (WebKitWebView *web_view);

Deletes the current selection inside the web_view .

webkit_web_view_execute_script ()

void
webkit_web_view_execute_script (WebKitWebView *web_view,
                                const gchar *script);

webkit_web_view_get_back_forward_list ()

WebKitWebBackForwardList *
webkit_web_view_get_back_forward_list (WebKitWebView *web_view);

Obtains the WebKitWebBackForwardList associated with the given WebKitWebView. The WebKitWebBackForwardList is owned by the WebKitWebView.

webkit_web_view_get_copy_target_list ()

GtkTargetList *
webkit_web_view_get_copy_target_list (WebKitWebView *web_view);

This function returns the list of targets this WebKitWebView can provide for clipboard copying and as DND source. The targets in the list are added with values from the WebKitWebViewTargetInfo enum, using gtk_target_list_add() and gtk_target_list_add_text_targets().

webkit_web_view_get_custom_encoding ()

const char *
webkit_web_view_get_custom_encoding (WebKitWebView *web_view);

Returns the current encoding of the WebKitWebView, not the default-encoding of WebKitWebSettings.

Since: 1.1.1

webkit_web_view_get_dom_document ()

WebKitDOMDocument *
webkit_web_view_get_dom_document (WebKitWebView *web_view);

Since: 1.3.1

webkit_web_view_get_editable ()

gboolean
webkit_web_view_get_editable (WebKitWebView *web_view);

Returns whether the user is allowed to edit the document.

Returns TRUE if web_view allows the user to edit the HTML document, FALSE if it doesn't. You can change web_view 's document programmatically regardless of this setting.

webkit_web_view_get_encoding ()

const gchar *
webkit_web_view_get_encoding (WebKitWebView *web_view);

Returns the default encoding of the WebKitWebView.

Since: 1.1.1

webkit_web_view_get_focused_frame ()

WebKitWebFrame *
webkit_web_view_get_focused_frame (WebKitWebView *web_view);

Returns the frame that has focus or an active text selection.

webkit_web_view_get_full_content_zoom ()

gboolean
webkit_web_view_get_full_content_zoom (WebKitWebView *web_view);

Returns whether the zoom level affects only text or all elements.

Since: 1.0.1

webkit_web_view_get_hit_test_result ()

WebKitHitTestResult *
webkit_web_view_get_hit_test_result (WebKitWebView *web_view,
                                     GdkEventButton *event);

Does a 'hit test' in the coordinates specified by event to figure out context information about that position in the web_view .

Since: 1.1.15

webkit_web_view_get_icon_pixbuf ()

GdkPixbuf *
webkit_web_view_get_icon_pixbuf (WebKitWebView *web_view);

Obtains a GdkPixbuf of the favicon for the given WebKitWebView, or a default icon if there is no icon for the given page. Use webkit_web_view_get_icon_uri() if you need to distinguish these cases. Usually you want to connect to WebKitWebView::icon-loaded and call this method in the callback.

The pixbuf will have the largest size provided by the server and should be resized before it is displayed. See also webkit_icon_database_get_icon_pixbuf().

Since: 1.3.13

webkit_web_view_get_icon_uri ()

const gchar *
webkit_web_view_get_icon_uri (WebKitWebView *web_view);

Obtains the URI for the favicon for the given WebKitWebView, or NULL if there is none.

Since: 1.1.18

webkit_web_view_get_inspector ()

WebKitWebInspector *
webkit_web_view_get_inspector (WebKitWebView *web_view);

Obtains the WebKitWebInspector associated with the WebKitWebView. Every WebKitWebView object has a WebKitWebInspector object attached to it as soon as it is created, so this function will only return NULL if the argument is not a valid WebKitWebView.

Since: 1.0.3

webkit_web_view_get_load_status ()

WebKitLoadStatus
webkit_web_view_get_load_status (WebKitWebView *web_view);

Determines the current status of the load.

Since: 1.1.7

webkit_web_view_get_main_frame ()

WebKitWebFrame *
webkit_web_view_get_main_frame (WebKitWebView *web_view);

Returns the main frame for the web_view .

webkit_web_view_get_paste_target_list ()

GtkTargetList *
webkit_web_view_get_paste_target_list (WebKitWebView *web_view);

This function returns the list of targets this WebKitWebView can provide for clipboard pasting and as DND destination. The targets in the list are added with values from the WebKitWebViewTargetInfo enum, using gtk_target_list_add() and gtk_target_list_add_text_targets().

webkit_web_view_get_progress ()

gdouble
webkit_web_view_get_progress (WebKitWebView *web_view);

Determines the current progress of the load.

Since: 1.1.7

webkit_web_view_get_settings ()

WebKitWebSettings *
webkit_web_view_get_settings (WebKitWebView *web_view);

Obtains the WebKitWebSettings associated with the WebKitWebView. The WebKitWebView always has an associated instance of WebKitWebSettings. The reference that is returned by this call is owned by the WebKitWebView. You may need to increase its reference count if you intend to keep it alive for longer than the WebKitWebView.

webkit_web_view_get_title ()

const gchar *
webkit_web_view_get_title (WebKitWebView *web_view);

Returns the web_view 's document title

Since: 1.1.4

webkit_web_view_get_transparent ()

gboolean
webkit_web_view_get_transparent (WebKitWebView *web_view);

Returns whether the WebKitWebView has a transparent background.

webkit_web_view_get_uri ()

const gchar *
webkit_web_view_get_uri (WebKitWebView *web_view);

Returns the current URI of the contents displayed by the web_view

Since: 1.1.4

webkit_web_view_get_view_mode ()

WebKitWebViewViewMode
webkit_web_view_get_view_mode (WebKitWebView *web_view);

Gets the value of the view-mode property of the WebKitWebView. Check the property's documentation for more information.

Since: 1.3.4

webkit_web_view_get_view_source_mode ()

gboolean
webkit_web_view_get_view_source_mode (WebKitWebView *web_view);

Since: 1.1.14

webkit_web_view_get_viewport_attributes ()

WebKitViewportAttributes *
webkit_web_view_get_viewport_attributes
                               (WebKitWebView *web_view);

Obtains the WebKitViewportAttributes associated with the WebKitWebView. Every WebKitWebView object has a WebKitViewportAttributes object attached to it as soon as it is created, so this function will only return NULL if the argument is not a valid WebKitWebView. Do note however that the viewport attributes object only contains valid information when the current page has a viewport meta tag. You can check whether the data should be used by checking the “valid” property.

Since: 1.3.8

webkit_web_view_get_zoom_level ()

gfloat
webkit_web_view_get_zoom_level (WebKitWebView *web_view);

Returns the zoom level of web_view , i.e. the factor by which elements in the page are scaled with respect to their original size. If the "full-content-zoom" property is set to FALSE (the default) the zoom level changes the text size, or if TRUE, scales all elements in the page.

Since: 1.0.1

webkit_web_view_go_back ()

void
webkit_web_view_go_back (WebKitWebView *web_view);

Loads the previous history item.

webkit_web_view_go_back_or_forward ()

void
webkit_web_view_go_back_or_forward (WebKitWebView *web_view,
                                    gint steps);

Loads the history item that is the number of steps away from the current item. Negative values represent steps backward while positive values represent steps forward.

webkit_web_view_go_forward ()

void
webkit_web_view_go_forward (WebKitWebView *web_view);

Loads the next history item.

webkit_web_view_go_to_back_forward_item ()

gboolean
webkit_web_view_go_to_back_forward_item
                               (WebKitWebView *web_view,
                                WebKitWebHistoryItem *item);

Go to the specified WebKitWebHistoryItem

webkit_web_view_has_selection ()

gboolean
webkit_web_view_has_selection (WebKitWebView *web_view);

Determines whether text was selected.

webkit_web_view_load_html_string ()

void
webkit_web_view_load_html_string (WebKitWebView *web_view,
                                  const gchar *content,
                                  const gchar *base_uri);

Requests loading of the given content with the specified base_uri .

webkit_web_view_load_request ()

void
webkit_web_view_load_request (WebKitWebView *web_view,
                              WebKitNetworkRequest *request);

Requests loading of the specified asynchronous client request.

Creates a provisional data source that will transition to a committed data source once any data has been received. Use webkit_web_view_stop_loading() to stop the load.

Since: 1.1.1

webkit_web_view_load_string ()

void
webkit_web_view_load_string (WebKitWebView *web_view,
                             const gchar *content,
                             const gchar *mime_type,
                             const gchar *encoding,
                             const gchar *base_uri);

Requests loading of the given content with the specified mime_type , encoding and base_uri .

If mime_type is NULL, "text/html" is assumed.

If encoding is NULL, "UTF-8" is assumed.

webkit_web_view_load_uri ()

void
webkit_web_view_load_uri (WebKitWebView *web_view,
                          const gchar *uri);

Requests loading of the specified URI string.

Since: 1.1.1

webkit_web_view_mark_text_matches ()

guint
webkit_web_view_mark_text_matches (WebKitWebView *web_view,
                                   const gchar *string,
                                   gboolean case_sensitive,
                                   guint limit);

Attempts to highlight all occurances of string inside web_view.

webkit_web_view_move_cursor ()

void
webkit_web_view_move_cursor (WebKitWebView *web_view,
                             GtkMovementStep step,
                             gint count);

Move the cursor in view as described by step and count .

Since: 1.1.4

webkit_web_view_new ()

GtkWidget *
webkit_web_view_new (void);

webkit_web_view_open ()

void
webkit_web_view_open (WebKitWebView *web_view,
                      const gchar *uri);

Requests loading of the specified URI string.

webkit_web_view_paste_clipboard ()

void
webkit_web_view_paste_clipboard (WebKitWebView *web_view);

Pastes the current contents of the clipboard to the web_view .

webkit_web_view_redo ()

void
webkit_web_view_redo (WebKitWebView *web_view);

Redoes the last editing command in the view, if possible.

Since: 1.1.14

webkit_web_view_reload ()

void
webkit_web_view_reload (WebKitWebView *web_view);

webkit_web_view_reload_bypass_cache ()

void
webkit_web_view_reload_bypass_cache (WebKitWebView *web_view);

Reloads the web_view without using any cached data.

Since: 1.0.3

webkit_web_view_search_text ()

gboolean
webkit_web_view_search_text (WebKitWebView *web_view,
                             const gchar *text,
                             gboolean case_sensitive,
                             gboolean forward,
                             gboolean wrap);

Looks for a specified string inside web_view.

webkit_web_view_select_all ()

void
webkit_web_view_select_all (WebKitWebView *web_view);

Attempts to select everything inside the web_view .

webkit_web_view_set_custom_encoding ()

void
webkit_web_view_set_custom_encoding (WebKitWebView *web_view,
                                     const gchar *encoding);

Sets the current WebKitWebView encoding, without modifying the default one, and reloads the page.

Since: 1.1.1

webkit_web_view_set_editable ()

void
webkit_web_view_set_editable (WebKitWebView *web_view,
                              gboolean flag);

Sets whether web_view allows the user to edit its HTML document.

If flag is TRUE, web_view allows the user to edit the document. If flag is FALSE, an element in web_view 's document can only be edited if the CONTENTEDITABLE attribute has been set on the element or one of its parent elements. You can change web_view 's document programmatically regardless of this setting. By default a WebKitWebView is not editable.

Normally, an HTML document is not editable unless the elements within the document are editable. This function provides a low-level way to make the contents of a WebKitWebView editable without altering the document or DOM structure.

webkit_web_view_set_full_content_zoom ()

void
webkit_web_view_set_full_content_zoom (WebKitWebView *web_view,
                                       gboolean full_content_zoom);

Sets whether the zoom level affects only text or all elements.

Since: 1.0.1

webkit_web_view_set_highlight_text_matches ()

void
webkit_web_view_set_highlight_text_matches
                               (WebKitWebView *web_view,
                                gboolean highlight);

Highlights text matches previously marked by webkit_web_view_mark_text_matches.

webkit_web_view_set_maintains_back_forward_list ()

void
webkit_web_view_set_maintains_back_forward_list
                               (WebKitWebView *web_view,
                                gboolean flag);

Set the view to maintain a back or forward list of history items.

webkit_web_view_set_settings ()

void
webkit_web_view_set_settings (WebKitWebView *web_view,
                              WebKitWebSettings *settings);

Replaces the WebKitWebSettings instance that is currently attached to web_view with settings . The reference held by the web_view on the old WebKitWebSettings instance is dropped, and the reference count of settings is inscreased.

The settings are automatically applied to web_view .

webkit_web_view_set_transparent ()

void
webkit_web_view_set_transparent (WebKitWebView *web_view,
                                 gboolean flag);

Sets whether the WebKitWebView has a transparent background.

Pass FALSE to have the WebKitWebView draw a solid background (the default), otherwise TRUE.

webkit_web_view_set_view_mode ()

void
webkit_web_view_set_view_mode (WebKitWebView *web_view,
                               WebKitWebViewViewMode mode);

Sets the view-mode property of the WebKitWebView. Check the property's documentation for more information.

Since: 1.3.4

webkit_web_view_set_view_source_mode ()

void
webkit_web_view_set_view_source_mode (WebKitWebView *web_view,
                                      gboolean view_source_mode);

Set whether the view should be in view source mode. Setting this mode to TRUE before loading a URI will display the source of the web page in a nice and readable format.

Since: 1.1.14

webkit_web_view_set_zoom_level ()

void
webkit_web_view_set_zoom_level (WebKitWebView *web_view,
                                gfloat zoom_level);

Sets the zoom level of web_view , i.e. the factor by which elements in the page are scaled with respect to their original size. If the "full-content-zoom" property is set to FALSE (the default) the zoom level changes the text size, or if TRUE, scales all elements in the page.

Since: 1.0.1

webkit_web_view_stop_loading ()

void
webkit_web_view_stop_loading (WebKitWebView *web_view);

Stops any ongoing load in the web_view .

webkit_web_view_try_get_favicon_pixbuf ()

GdkPixbuf *
webkit_web_view_try_get_favicon_pixbuf
                               (WebKitWebView *web_view,
                                guint width,
                                guint height);

Obtains a GdkPixbuf of the favicon for the given WebKitWebView. This will return NULL is there is no icon for the current WebKitWebView or if the icon is in the database but not available at the moment of this call. Use webkit_web_view_get_icon_uri() if you need to distinguish these cases. Usually you want to connect to WebKitWebView::icon-loaded and call this method in the callback.

See also webkit_favicon_database_try_get_favicon_pixbuf(). Contrary to this function the icon database one returns the URL of the page containing the icon.

Since: 1.8

webkit_web_view_undo ()

void
webkit_web_view_undo (WebKitWebView *web_view);

Undoes the last editing command in the view, if possible.

Since: 1.1.14

webkit_web_view_unmark_text_matches ()

void
webkit_web_view_unmark_text_matches (WebKitWebView *web_view);

Removes highlighting previously set by webkit_web_view_mark_text_matches.

webkit_web_view_zoom_in ()

void
webkit_web_view_zoom_in (WebKitWebView *web_view);

Increases the zoom level of web_view . The current zoom level is incremented by the value of the "zoom-step" property of the WebKitWebSettings associated with web_view .

Since: 1.0.1

webkit_web_view_zoom_out ()

void
webkit_web_view_zoom_out (WebKitWebView *web_view);

Decreases the zoom level of web_view . The current zoom level is decremented by the value of the "zoom-step" property of the WebKitWebSettings associated with web_view .

Since: 1.0.1

webkit_web_view_get_window_features ()

WebKitWebWindowFeatures *
webkit_web_view_get_window_features (WebKitWebView *web_view);

Since: 1.0.3

webkit_web_view_get_snapshot ()

cairo_surface_t *
webkit_web_view_get_snapshot (WebKitWebView *web_view);

Retrieves a snapshot with the visible contents of webview .

Since: 1.10

enum WebKitNavigationResponse

Enum values used to denote the various responses to a navigation policy decision.

enum WebKitWebViewTargetInfo

Enum values used to denote the info value of various selection types. These can be used to interpret the data WebKitGTK+ publishes via GtkClipboard and drag-and-drop.

enum WebKitWebViewViewMode

Enum values used to denote the various types of view modes. See the “view-mode” property.

WebKitWebView

typedef struct _WebKitWebView WebKitWebView;

The “copy-target-list” property

  “copy-target-list”         GtkTargetList *

The list of targets this web view supports for clipboard copying.

Flags: Read

Since: 1.0.2

The “custom-encoding” property

  “custom-encoding”          gchar *

The custom encoding of the web view.

Flags: Read / Write

Default value: NULL

Since: 1.1.2

The “editable” property

  “editable”                 gboolean

Whether content can be modified by the user.

Flags: Read / Write

Default value: FALSE

The “encoding” property

  “encoding”                 gchar *

The default encoding of the web view.

Flags: Read

Default value: NULL

Since: 1.1.2

The “full-content-zoom” property

  “full-content-zoom”        gboolean

Whether the full content is scaled when zooming.

Flags: Read / Write

Default value: FALSE

Since: 1.0.1

The “icon-uri” property

  “icon-uri”                 gchar *

The URI for the favicon for the WebKitWebView.

Flags: Read

Default value: NULL

Since: 1.1.18

The “im-context” property

  “im-context”               GtkIMContext *

The GtkIMMulticontext for the WebKitWebView.

This is the input method context used for all text entry widgets inside the WebKitWebView. It can be used to generate context menu items for controlling the active input method.

Flags: Read

Since: 1.1.20

The “load-status” property

  “load-status”              WebKitLoadStatus

Determines the current status of the load.

Connect to "notify::load-status" to monitor loading.

Some versions of WebKitGTK+ emitted this signal for the default error page, while loading it. This behavior was considered bad, because it was essentially exposing an implementation detail. From 1.1.19 onwards this signal is no longer emitted for the default error pages, but keep in mind that if you override the error pages by using webkit_web_frame_load_alternate_string() the signals will be emitted.

Flags: Read

Default value: WEBKIT_LOAD_FINISHED

Since: 1.1.7

The “paste-target-list” property

  “paste-target-list”        GtkTargetList *

The list of targets this web view supports for clipboard pasting.

Flags: Read

Since: 1.0.2

The “progress” property

  “progress”                 gdouble

Determines the current progress of the load.

Flags: Read

Allowed values: [0,1]

Default value: 1

Since: 1.1.7

The “self-scrolling” property

  “self-scrolling”           gboolean

Whether or not this WebView draws its own scrollbars.

Flags: Read / Write / Construct Only

Default value: FALSE

The “settings” property

  “settings”                 WebKitWebSettings *

An associated WebKitWebSettings instance.

Flags: Read / Write

The “title” property

  “title”                    gchar *

Returns the @web_view's document title.

Flags: Read

Default value: NULL

Since: 1.1.4

The “transparent” property

  “transparent”              gboolean

Whether content has a transparent background.

Flags: Read / Write

Default value: FALSE

The “uri” property

  “uri”                      gchar *

Returns the current URI of the contents displayed by the @web_view.

Flags: Read

Default value: NULL

Since: 1.1.4

The “view-mode” property

  “view-mode”                WebKitWebViewViewMode

The "view-mode" media feature for the WebKitWebView.

The "view-mode" media feature is additional information for web applications about how the application is running, when it comes to user experience. Whether the application is running inside a regular browser window, in a dedicated window, fullscreen, for instance.

This property stores a WebKitWebViewViewMode value that matches the "view-mode" media feature the web application will see.

See http://www.w3.org/TR/view-mode/ for more information.

Flags: Read / Write

Default value: WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED

Since: 1.3.4

The “viewport-attributes” property

  “viewport-attributes”      WebKitViewportAttributes *

The associated WebKitViewportAttributes instance.

Flags: Read

Since: 1.3.8

The “web-inspector” property

  “web-inspector”            WebKitWebInspector *

The associated WebKitWebInspector instance.

Flags: Read

Since: 1.0.3

The “window-features” property

  “window-features”          WebKitWebWindowFeatures *

An associated WebKitWebWindowFeatures instance.

Flags: Read / Write

Since: 1.0.3

The “zoom-level” property

  “zoom-level”               gfloat

The level of zoom of the content.

Flags: Read / Write

Allowed values: >= G_MINFLOAT

Default value: 1

Since: 1.0.1

The “close-web-view” signal

gboolean
user_function (WebKitWebView *web_view,
               gpointer       user_data)

Emitted when closing a WebKitWebView is requested. This occurs when a call is made from JavaScript's window.close function. The default signal handler does not do anything. It is the owner's responsibility to hide or delete the web view, if necessary.

Flags: Run Last

Since: 1.1.11

The “console-message” signal

gboolean
user_function (WebKitWebView *web_view,
               gchar         *message,
               gint           line,
               gchar         *source_id,
               gpointer       user_data)

A JavaScript console message was created.

Flags: Run Last

The “context-menu” signal

gboolean
user_function (WebKitWebView       *web_view,
               GtkWidget           *default_menu,
               WebKitHitTestResult *hit_test_result,
               gboolean             triggered_with_keyboard,
               gpointer             user_data)

Emmited when a context menu is about to be displayed to give the application a chance to create and handle its own context menu. If you only want to add custom options to the default context menu you can simply modify the given default_menu .

When triggered_with_keyboard is TRUE the coordinates of the given hit_test_result should be used to position the popup menu. When the context menu has been triggered by a mouse event you could either use the hit_test_result coordinates or pass NULL to the GtkMenuPositionFunc parameter of gtk_menu_popup() function. Note that coordinates of hit_test_result are relative to web_view window.

If your application will create and display its own popup menu, TRUE should be returned. Note that when the context menu is handled by the application, the “enable-default-context-menu” setting will be ignored and the “populate-popup” signal won't be emitted. If you don't want any context menu to be shown, you can simply connect to this signal and return TRUE without doing anything else.

Flags: Run Last

Since: 1.10

The “copy-clipboard” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “copy-clipboard” signal is a keybinding signal which gets emitted to copy the selection to the clipboard.

The default bindings for this signal are Ctrl-c and Ctrl-Insert.

Flags: Action

The “create-plugin-widget” signal

GtkWidget*
user_function (WebKitWebView *web_view,
               gchar         *mime_type,
               gchar         *uri,
               GHashTable    *param,
               gpointer       user_data)

The “create-plugin-widget” signal will be emitted to create a plugin widget for embed or object HTML tags. This allows to embed a GtkWidget as a plugin into HTML content. In case of a textual selection of the GtkWidget WebCore will attempt to set the property value of "webkit-widget-is-selected". This can be used to draw a visual indicator of the selection.

Flags: Action

Since: 1.1.8

The “create-web-view” signal

WebKitWebView*
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

Emitted when the creation of a new window is requested. If this signal is handled the signal handler should return the newly created WebKitWebView.

The new WebKitWebView should not be displayed to the user until the “web-view-ready” signal is emitted.

The signal handlers should not try to deal with the reference count for the new WebKitWebView. The widget to which the widget is added will handle that.

Flags: Run Last

Since: 1.0.3

The “cut-clipboard” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “cut-clipboard” signal is a keybinding signal which gets emitted to cut the selection to the clipboard.

The default bindings for this signal are Ctrl-x and Shift-Delete.

Flags: Action

The “database-quota-exceeded” signal

void
user_function (WebKitWebView *web_view,
               GObject       *frame,
               GObject       *database,
               gpointer       user_data)

The “database-quota-exceeded” signal will be emitted when a Web Database exceeds the quota of its security origin. This signal may be used to increase the size of the quota before the originating operation fails.

Flags: Action

Since: 1.1.14

The “document-load-finished” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *web_frame,
               gpointer        user_data)

Emitted when the DOM document object load is finished for the given frame.

Flags: Action

The “download-requested” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitDownload *download,
               gpointer        user_data)

A new Download is being requested. By default, if the signal is not handled, the download is cancelled. If you handle the download and call webkit_download_set_destination_uri(), it will be started for you. If you need to set the destination asynchronously you are responsible for starting or cancelling it yourself.

If you intend to handle downloads yourself rather than using the WebKitDownload helper object you must handle this signal, and return FALSE.

Also, keep in mind that the default policy for WebKitGTK+ is to ignore files with a MIME type that it does not know how to handle, which means this signal won't be emitted in the default setup. One way to trigger downloads is to connect to WebKitWebView::mime-type-policy-decision-requested and call webkit_web_policy_decision_download() on the WebKitWebPolicyDecision in the parameter list for the kind of files you want your application to download (a common solution is to download anything that WebKit can't handle, which you can figure out by using webkit_web_view_can_show_mime_type()).

Flags: Run Last

Since: 1.1.2

The “editing-began” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

Flags: Action

The “editing-ended” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

Flags: Action

The “entering-fullscreen” signal

gboolean
user_function (WebKitWebView        *web_view,
               WebKitDOMHTMLElement *element,
               gpointer              user_data)

Emitted when JavaScript code calls element.webkitRequestFullScreen. If the signal is not handled the WebView 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).

Flags: Run Last

Since: 1.9.0

The “frame-created” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *web_frame,
               gpointer        user_data)

Emitted when a WebKitWebView has created a new frame. This signal will be emitted for all sub-frames created during page load. It will not be emitted for the main frame, which originates in the WebKitWebView constructor and may be accessed at any time using webkit_web_view_get_main_frame.

Flags: Action

Since: 1.3.4

The “geolocation-policy-decision-cancelled” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

When a frame wants to cancel geolocation permission it had requested before.

Flags: Run Last

Since: 1.1.23

The “geolocation-policy-decision-requested” signal

gboolean
user_function (WebKitWebView                   *web_view,
               WebKitWebFrame                  *frame,
               WebKitGeolocationPolicyDecision *policy_decision,
               gpointer                         user_data)

This signal is emitted when a frame wants to obtain the user's location. The decision can be made asynchronously, but you must call g_object_ref() the policy_decision , and return TRUE if you are going to handle the request. To actually make the decision you need to call webkit_geolocation_policy_allow() or webkit_geolocation_policy_deny() on policy_decision .

Flags: Run Last

Since: 1.1.23

The “hovering-over-link” signal

void
user_function (WebKitWebView *web_view,
               gchar         *title,
               gchar         *uri,
               gpointer       user_data)

When the cursor is over a link, this signal is emitted.

Flags: Run Last

The “icon-loaded” signal

void
user_function (WebKitWebView *web_view,
               gchar         *icon_uri,
               gpointer       user_data)

This signal is emitted when the main frame has got a favicon. See WebKitIconDatabase::icon-loaded if you want to keep track of icons for child frames.

Flags: Run Last

Since: 1.1.18

The “leaving-fullscreen” signal

gboolean
user_function (WebKitWebView        *web_view,
               WebKitDOMHTMLElement *element,
               gpointer              user_data)

Emitted when the WebView 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 entering-fullscreen stage for instance.

Flags: Run Last

Since: 1.9.0

The “load-committed” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

When a WebKitWebFrame loaded the first data this signal is emitted.

Flags: Run Last

The “load-error” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *web_frame,
               gchar          *uri,
               GError         *web_error,
               gpointer        user_data)

An error occurred while loading. By default, if the signal is not handled, the web_view will display a stock error page. You need to handle the signal if you want to provide your own error page.

Flags: Run Last

Since: 1.1.6

The “load-finished” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

Flags: Run Last

The “load-progress-changed” signal

void
user_function (WebKitWebView *web_view,
               gint           progress,
               gpointer       user_data)

Flags: Run Last

The “load-started” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

When a WebKitWebFrame begins to load this signal is emitted.

Flags: Run Last

The “mime-type-policy-decision-requested” signal

gboolean
user_function (WebKitWebView           *web_view,
               WebKitWebFrame          *frame,
               WebKitNetworkRequest    *request,
               gchar                   *mimetype,
               WebKitWebPolicyDecision *policy_decision,
               gpointer                 user_data)

Decide whether or not to display the given MIME type. If this signal is not handled, the default behavior is to show the content of the requested URI if WebKit can show this MIME type and the content disposition is not a download; if WebKit is not able to show the MIME type nothing happens.

Notice that if you return TRUE, meaning that you handled the signal, you are expected to be aware of the "Content-Disposition" header. A value of "attachment" usually indicates a download regardless of the MIME type, see also soup_message_headers_get_content_disposition(). And you must call webkit_web_policy_decision_ignore(), webkit_web_policy_decision_use(), or webkit_web_policy_decision_download() on the policy_decision object.

Flags: Run Last

Since: 1.0.3

The “move-cursor” signal

gboolean
user_function (WebKitWebView  *web_view,
               GtkMovementStep step,
               gint            count,
               gpointer        user_data)

The “move-cursor” will be emitted to apply the cursor movement described by its parameters to the view .

Flags: Action

Since: 1.1.4

The “navigation-policy-decision-requested” signal

gboolean
user_function (WebKitWebView             *web_view,
               WebKitWebFrame            *frame,
               WebKitNetworkRequest      *request,
               WebKitWebNavigationAction *navigation_action,
               WebKitWebPolicyDecision   *policy_decision,
               gpointer                   user_data)

Emitted when frame requests a navigation to another page. If this signal is not handled, the default behavior is to allow the navigation.

Notice that if you return TRUE, meaning that you handled the signal, you are expected to have decided what to do, by calling webkit_web_policy_decision_ignore(), webkit_web_policy_decision_use(), or webkit_web_policy_decision_download() on the policy_decision object.

Flags: Run Last

Since: 1.0.3

The “navigation-requested” signal

WebKitNavigationResponse
user_function (WebKitWebView        *web_view,
               WebKitWebFrame       *frame,
               WebKitNetworkRequest *request,
               gpointer              user_data)

Emitted when frame requests a navigation to another page.

Flags: Run Last

The “new-window-policy-decision-requested” signal

gboolean
user_function (WebKitWebView             *web_view,
               WebKitWebFrame            *frame,
               WebKitNetworkRequest      *request,
               WebKitWebNavigationAction *navigation_action,
               WebKitWebPolicyDecision   *policy_decision,
               gpointer                   user_data)

Emitted when frame requests opening a new window. With this signal the browser can use the context of the request to decide about the new window. If the request is not handled the default behavior is to allow opening the new window to load the URI, which will cause a create-web-view signal emission where the browser handles the new window action but without information of the context that caused the navigation. The following navigation-policy-decision-requested emissions will load the page after the creation of the new window just with the information of this new navigation context, without any information about the action that made this new window to be opened.

Notice that if you return TRUE, meaning that you handled the signal, you are expected to have decided what to do, by calling webkit_web_policy_decision_ignore(), webkit_web_policy_decision_use(), or webkit_web_policy_decision_download() on the policy_decision object.

Flags: Run Last

Since: 1.1.4

The “onload-event” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gpointer        user_data)

When a WebKitWebFrame receives an onload event this signal is emitted.

Flags: Run Last

The “paste-clipboard” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “paste-clipboard” signal is a keybinding signal which gets emitted to paste the contents of the clipboard into the Web view.

The default bindings for this signal are Ctrl-v and Shift-Insert.

Flags: Action

The “populate-popup” signal

void
user_function (WebKitWebView *web_view,
               GtkMenu       *menu,
               gpointer       user_data)

When a context menu is about to be displayed this signal is emitted.

Add menu items to menu to extend the context menu.

Flags: Run Last

The “print-requested” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *web_frame,
               gpointer        user_data)

Emitted when printing is requested by the frame, usually because of a javascript call. When handling this signal you should call webkit_web_frame_print_full() or webkit_web_frame_print() to do the actual printing.

The default handler will present a print dialog and carry a print operation. Notice that this means that if you intend to ignore a print request you must connect to this signal, and return TRUE.

Flags: Run Last

Since: 1.1.5

The “redo” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “redo” signal is a keybinding signal which gets emitted to redo the last editing command.

The default binding for this signal is Ctrl-Shift-z

Flags: Action

Since: 1.1.14

The “resource-content-length-received” signal

void
user_function (WebKitWebView     *web_view,
               WebKitWebFrame    *web_frame,
               WebKitWebResource *web_resource,
               gint               length_received,
               gpointer           user_data)

Emitted when new resource data has been received. The length_received variable stores the amount of bytes received since the last time this signal was emitted. This is useful to provide progress information about the resource load operation.

Flags: Run Last

Since: 1.7.5

The “resource-load-failed” signal

void
user_function (WebKitWebView     *web_view,
               WebKitWebFrame    *web_frame,
               WebKitWebResource *web_resource,
               GError            *error,
               gpointer           user_data)

Invoked when a resource failed to load

Flags: Run Last

Since: 1.7.5

The “resource-load-finished” signal

void
user_function (WebKitWebView     *web_view,
               WebKitWebFrame    *web_frame,
               WebKitWebResource *web_resource,
               gpointer           user_data)

Emitted when all the data for the resource was loaded

Flags: Run Last

Since: 1.7.5

The “resource-request-starting” signal

void
user_function (WebKitWebView         *web_view,
               WebKitWebFrame        *web_frame,
               WebKitWebResource     *web_resource,
               WebKitNetworkRequest  *request,
               WebKitNetworkResponse *response,
               gpointer               user_data)

Emitted when a request is about to be sent. You can modify the request while handling this signal. You can set the URI in the WebKitNetworkRequest object itself, and add/remove/replace headers using the SoupMessage object it carries, if it is present. See webkit_network_request_get_message(). Setting the request URI to "about:blank" will effectively cause the request to load nothing, and can be used to disable the loading of specific resources.

Notice that information about an eventual redirect is available in response 's SoupMessage, not in the SoupMessage carried by the request . If response is NULL, then this is not a redirected request.

The WebKitWebResource object will be the same throughout all the lifetime of the resource, but the contents may change from inbetween signal emissions.

Flags: Action

Since: 1.1.14

The “resource-response-received” signal

void
user_function (WebKitWebView         *web_view,
               WebKitWebFrame        *web_frame,
               WebKitWebResource     *web_resource,
               WebKitNetworkResponse *response,
               gpointer               user_data)

Emitted when the first byte of data arrives

Flags: Run Last

Since: 1.7.5

The “run-file-chooser” signal

gboolean
user_function (WebKitWebView            *web_view,
               WebKitFileChooserRequest *request,
               gpointer                  user_data)

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 WebKitFileChooserRequest in the request argument.

The default signal handler will asynchronously run a regular GtkFileChooserDialog for the user to interact with.

If this signal is to be handled asynchronously, you must call g_object_ref() on the request , and return TRUE to indicate that the request is being handled. When you are ready to complete the request, call webkit_file_chooser_request_select_files().

Flags: Run Last

The “script-alert” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gchar          *message,
               gpointer        user_data)

A JavaScript alert dialog was created.

Flags: Run Last

The “script-confirm” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gchar          *message,
               gpointer        confirmed,
               gpointer        user_data)

A JavaScript confirm dialog was created, providing Yes and No buttons.

Flags: Run Last

The “script-prompt” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gchar          *message,
               gchar          *default,
               gpointer        text,
               gpointer        user_data)

A JavaScript prompt dialog was created, providing an entry to input text.

Flags: Run Last

The “select-all” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “select-all” signal is a keybinding signal which gets emitted to select the complete contents of the text view.

The default bindings for this signal is Ctrl-a.

Flags: Action

The “selection-changed” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

Flags: Action

The “should-apply-style” signal

gboolean
user_function (WebKitWebView                *web_view,
               WebKitDOMCSSStyleDeclaration *set,
               WebKitDOMRange               *range,
               gpointer                      user_data)

Flags: Action

The “should-begin-editing” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitDOMRange *range,
               gpointer        user_data)

Flags: Action

The “should-change-selected-range” signal

gboolean
user_function (WebKitWebView          *web_view,
               WebKitDOMRange         *fromRange,
               WebKitDOMRange         *toRange,
               WebKitSelectionAffinity affinity,
               gboolean                stillSelecting,
               gpointer                user_data)

Flags: Action

The “should-delete-range” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitDOMRange *range,
               gpointer        user_data)

Flags: Action

The “should-end-editing” signal

gboolean
user_function (WebKitWebView  *web_view,
               WebKitDOMRange *range,
               gpointer        user_data)

Flags: Action

The “should-insert-node” signal

gboolean
user_function (WebKitWebView     *web_view,
               WebKitDOMNode     *node,
               WebKitDOMRange    *range,
               WebKitInsertAction action,
               gpointer           user_data)

Flags: Action

The “should-insert-text” signal

gboolean
user_function (WebKitWebView     *web_view,
               gchar             *string,
               WebKitDOMRange    *range,
               WebKitInsertAction action,
               gpointer           user_data)

Flags: Action

The “should-show-delete-interface-for-element” signal

gboolean
user_function (WebKitWebView        *web_view,
               WebKitDOMHTMLElement *element,
               gpointer              user_data)

Flags: Action

The “status-bar-text-changed” signal

void
user_function (WebKitWebView *webkitwebview,
               gchar         *arg1,
               gpointer       user_data)

Flags: Run Last

The “title-changed” signal

void
user_function (WebKitWebView  *web_view,
               WebKitWebFrame *frame,
               gchar          *title,
               gpointer        user_data)

When a WebKitWebFrame changes the document title this signal is emitted.

Flags: Run Last

The “undo” signal

void
user_function (WebKitWebView *web_view,
               gpointer       user_data)

The “undo” signal is a keybinding signal which gets emitted to undo the last editing command.

The default binding for this signal is Ctrl-z

Flags: Action

Since: 1.1.14