WebKitGTK+ Reference Manual: WebKitWebView

## WebKitWebView WebKitWebView — The central class of the WebKitGTK+ API |

## Synopsis

    enum                WebKitNavigationResponse;
    enum                WebKitWebViewTargetInfo;
    enum                WebKitWebViewViewMode;
                        WebKitWebView;
    gboolean            webkit_web_view_can_copy_clipboard  (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_cut_clipboard   (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_go_back         (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_go_back_or_forward
                                                            (WebKitWebView *web_view,
                                                             gint steps);
    gboolean            webkit_web_view_can_go_forward      (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_paste_clipboard (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_redo            (WebKitWebView *web_view);
    gboolean            webkit_web_view_can_show_mime_type  (WebKitWebView *web_view,
                                                             const gchar *mime_type);
    gboolean            webkit_web_view_can_undo            (WebKitWebView *web_view);
    void                webkit_web_view_copy_clipboard      (WebKitWebView *web_view);
    void                webkit_web_view_cut_clipboard       (WebKitWebView *web_view);
    void                webkit_web_view_delete_selection    (WebKitWebView *web_view);
    void                webkit_web_view_execute_script      (WebKitWebView *web_view,
                                                             const gchar *script);
    WebKitWebBackForwardList * webkit_web_view_get_back_forward_list
                                                            (WebKitWebView *web_view);
    GtkTargetList *     webkit_web_view_get_copy_target_list
                                                            (WebKitWebView *web_view);
    const char *        webkit_web_view_get_custom_encoding (WebKitWebView *web_view);
    WebKitDOMDocument * webkit_web_view_get_dom_document    (WebKitWebView *web_view);
    gboolean            webkit_web_view_get_editable        (WebKitWebView *web_view);
    const gchar *       webkit_web_view_get_encoding        (WebKitWebView *web_view);
    WebKitWebFrame *    webkit_web_view_get_focused_frame   (WebKitWebView *web_view);
    gboolean            webkit_web_view_get_full_content_zoom
                                                            (WebKitWebView *web_view);
    WebKitHitTestResult * webkit_web_view_get_hit_test_result
                                                            (WebKitWebView *web_view,
                                                             GdkEventButton *event);
    GdkPixbuf *         webkit_web_view_get_icon_pixbuf     (WebKitWebView *web_view);
    const gchar *       webkit_web_view_get_icon_uri        (WebKitWebView *web_view);
    WebKitWebInspector * webkit_web_view_get_inspector      (WebKitWebView *web_view);
    WebKitLoadStatus    webkit_web_view_get_load_status     (WebKitWebView *web_view);
    WebKitWebFrame *    webkit_web_view_get_main_frame      (WebKitWebView *web_view);
    GtkTargetList *     webkit_web_view_get_paste_target_list
                                                            (WebKitWebView *web_view);
    gdouble             webkit_web_view_get_progress        (WebKitWebView *web_view);
    WebKitWebSettings * webkit_web_view_get_settings        (WebKitWebView *web_view);
    const gchar *       webkit_web_view_get_title           (WebKitWebView *web_view);
    gboolean            webkit_web_view_get_transparent     (WebKitWebView *web_view);
    const gchar *       webkit_web_view_get_uri             (WebKitWebView *web_view);
    WebKitWebViewViewMode webkit_web_view_get_view_mode     (WebKitWebView *web_view);
    gboolean            webkit_web_view_get_view_source_mode
                                                            (WebKitWebView *web_view);
    WebKitViewportAttributes * webkit_web_view_get_viewport_attributes
                                                            (WebKitWebView *web_view);
    gfloat              webkit_web_view_get_zoom_level      (WebKitWebView *web_view);
    void                webkit_web_view_go_back             (WebKitWebView *web_view);
    void                webkit_web_view_go_back_or_forward  (WebKitWebView *web_view,
                                                             gint steps);
    void                webkit_web_view_go_forward          (WebKitWebView *web_view);
    gboolean            webkit_web_view_go_to_back_forward_item
                                                            (WebKitWebView *web_view,
                                                             WebKitWebHistoryItem *item);
    gboolean            webkit_web_view_has_selection       (WebKitWebView *web_view);
    void                webkit_web_view_load_html_string    (WebKitWebView *web_view,
                                                             const gchar *content,
                                                             const gchar *base_uri);
    void                webkit_web_view_load_request        (WebKitWebView *web_view,
                                                             WebKitNetworkRequest *request);
    void                webkit_web_view_load_string         (WebKitWebView *web_view,
                                                             const gchar *content,
                                                             const gchar *mime_type,
                                                             const gchar *encoding,
                                                             const gchar *base_uri);
    void                webkit_web_view_load_uri            (WebKitWebView *web_view,
                                                             const gchar *uri);
    guint               webkit_web_view_mark_text_matches   (WebKitWebView *web_view,
                                                             const gchar *string,
                                                             gboolean case_sensitive,
                                                             guint limit);
    void                webkit_web_view_move_cursor         (WebKitWebView *web_view,
                                                             GtkMovementStep step,
                                                             gint count);
    GtkWidget *         webkit_web_view_new                 (void);
    void                webkit_web_view_open                (WebKitWebView *web_view,
                                                             const gchar *uri);
    void                webkit_web_view_paste_clipboard     (WebKitWebView *web_view);
    void                webkit_web_view_redo                (WebKitWebView *web_view);
    void                webkit_web_view_reload              (WebKitWebView *web_view);
    void                webkit_web_view_reload_bypass_cache (WebKitWebView *web_view);
    gboolean            webkit_web_view_search_text         (WebKitWebView *web_view,
                                                             const gchar *text,
                                                             gboolean case_sensitive,
                                                             gboolean forward,
                                                             gboolean wrap);
    void                webkit_web_view_select_all          (WebKitWebView *web_view);
    void                webkit_web_view_set_custom_encoding (WebKitWebView *web_view,
                                                             const gchar *encoding);
    void                webkit_web_view_set_editable        (WebKitWebView *web_view,
                                                             gboolean flag);
    void                webkit_web_view_set_full_content_zoom
                                                            (WebKitWebView *web_view,
                                                             gboolean full_content_zoom);
    void                webkit_web_view_set_highlight_text_matches
                                                            (WebKitWebView *web_view,
                                                             gboolean highlight);
    void                webkit_web_view_set_maintains_back_forward_list
                                                            (WebKitWebView *web_view,
                                                             gboolean flag);
    void                webkit_web_view_set_settings        (WebKitWebView *web_view,
                                                             WebKitWebSettings *settings);
    void                webkit_web_view_set_transparent     (WebKitWebView *web_view,
                                                             gboolean flag);
    void                webkit_web_view_set_view_mode       (WebKitWebView *web_view,
                                                             WebKitWebViewViewMode mode);
    void                webkit_web_view_set_view_source_mode
                                                            (WebKitWebView *web_view,
                                                             gboolean view_source_mode);
    void                webkit_web_view_set_zoom_level      (WebKitWebView *web_view,
                                                             gfloat zoom_level);
    void                webkit_web_view_stop_loading        (WebKitWebView *web_view);
    GdkPixbuf *         webkit_web_view_try_get_favicon_pixbuf
                                                            (WebKitWebView *web_view,
                                                             guint width,
                                                             guint height);
    void                webkit_web_view_undo                (WebKitWebView *web_view);
    void                webkit_web_view_unmark_text_matches (WebKitWebView *web_view);
    void                webkit_web_view_zoom_in             (WebKitWebView *web_view);
    void                webkit_web_view_zoom_out            (WebKitWebView *web_view);
    WebKitWebWindowFeatures * webkit_web_view_get_window_features
                                                            (WebKitWebView *web_view);
    cairo_surface_t *   webkit_web_view_get_snapshot        (WebKitWebView *web_view);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkContainer
                         +----WebKitWebView

## Implemented Interfaces

WebKitWebView implements AtkImplementorIface, GtkBuildable and GtkScrollable.

## Properties

      "copy-target-list"         GtkTargetList*        : Read
      "custom-encoding"          gchar*                : Read / Write
      "editable"                 gboolean              : Read / Write
      "encoding"                 gchar*                : Read
      "full-content-zoom"        gboolean              : Read / Write
      "icon-uri"                 gchar*                : Read
      "im-context"               GtkIMContext*         : Read
      "load-status"              WebKitLoadStatus      : Read
      "paste-target-list"        GtkTargetList*        : Read
      "progress"                 gdouble               : Read
      "self-scrolling"           gboolean              : Read / Write / Construct Only
      "settings"                 WebKitWebSettings*    : Read / Write
      "title"                    gchar*                : Read
      "transparent"              gboolean              : Read / Write
      "uri"                      gchar*                : Read
      "view-mode"                WebKitWebViewViewMode  : Read / Write
      "viewport-attributes"      WebKitViewportAttributes*  : Read
      "web-inspector"            WebKitWebInspector*   : Read
      "window-features"          WebKitWebWindowFeatures*  : Read / Write
      "zoom-level"               gfloat                : Read / Write

## Signals

      "close-web-view"                                 : Run Last
      "console-message"                                : Run Last
      "context-menu"                                   : Run Last
      "copy-clipboard"                                 : Action
      "create-plugin-widget"                           : Action
      "create-web-view"                                : Run Last
      "cut-clipboard"                                  : Action
      "database-quota-exceeded"                        : Action
      "document-load-finished"                         : Action
      "download-requested"                             : Run Last
      "editing-began"                                  : Action
      "editing-ended"                                  : Action
      "entering-fullscreen"                            : Run Last
      "frame-created"                                  : Action
      "geolocation-policy-decision-cancelled"          : Run Last
      "geolocation-policy-decision-requested"          : Run Last
      "hovering-over-link"                             : Run Last
      "icon-loaded"                                    : Run Last
      "leaving-fullscreen"                             : Run Last
      "load-committed"                                 : Run Last
      "load-error"                                     : Run Last
      "load-finished"                                  : Run Last
      "load-progress-changed"                          : Run Last
      "load-started"                                   : Run Last
      "mime-type-policy-decision-requested"            : Run Last
      "move-cursor"                                    : Action
      "navigation-policy-decision-requested"           : Run Last
      "navigation-requested"                           : Run Last
      "new-window-policy-decision-requested"           : Run Last
      "onload-event"                                   : Run Last
      "paste-clipboard"                                : Action
      "populate-popup"                                 : Run Last
      "print-requested"                                : Run Last
      "redo"                                           : Action
      "resource-content-length-received"               : Run Last
      "resource-load-failed"                           : Run Last
      "resource-load-finished"                         : Run Last
      "resource-request-starting"                      : Action
      "resource-response-received"                     : Run Last
      "run-file-chooser"                               : Run Last
      "script-alert"                                   : Run Last
      "script-confirm"                                 : Run Last
      "script-prompt"                                  : Run Last
      "select-all"                                     : Action
      "selection-changed"                              : Action
      "should-apply-style"                             : Action
      "should-begin-editing"                           : Action
      "should-change-selected-range"                   : Action
      "should-delete-range"                            : Action
      "should-end-editing"                             : Action
      "should-insert-node"                             : Action
      "should-insert-text"                             : Action
      "should-show-delete-interface-for-element"       : Action
      "status-bar-text-changed"                        : Run Last
      "title-changed"                                  : Run Last
      "undo"                                           : Action
      "user-changed-contents"                          : Action
      "viewport-attributes-changed"                    : Action
      "viewport-attributes-recompute-requested"        : Action
      "web-view-ready"                                 : Run Last
      "window-object-cleared"                          : Run Last

## Description

WebKitWebView is the central class of the WebKitGTK+ API. It is a GtkWidget implementing the scrolling interface which means you can embed in a GtkScrolledWindow. It is responsible for managing the drawing of the content, forwarding of events. You can load any URI into the WebKitWebView or any kind of data string. With WebKitWebSettings you can control various aspects of the rendering and loading of the content. Each WebKitWebView has exactly one WebKitWebFrame as main frame. A WebKitWebFrame can have n children.

    /* Create the widgets */
    GtkWidget *main_window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    GtkWidget *scrolled_window = gtk_scrolled_window_new (NULL, NULL);
    GtkWidget *web_view = webkit_web_view_new ();

    /* Place the WebKitWebView in the GtkScrolledWindow */
    gtk_container_add (GTK_CONTAINER (scrolled_window), web_view);
    gtk_container_add (GTK_CONTAINER (main_window), scrolled_window);

    /* Open a webpage */
    webkit_web_view_load_uri (WEBKIT_WEB_VIEW (web_view), "http://www.gnome.org");

    /* Show the result */
    gtk_window_set_default_size (GTK_WINDOW (main_window), 800, 600);
    gtk_widget_show_all (main_window);

## Details

### enum WebKitNavigationResponse

    typedef enum {
        WEBKIT_NAVIGATION_RESPONSE_ACCEPT,
        WEBKIT_NAVIGATION_RESPONSE_IGNORE,
        WEBKIT_NAVIGATION_RESPONSE_DOWNLOAD
    } WebKitNavigationResponse;

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

`WEBKIT_NAVIGATION_RESPONSE_ACCEPT` | Instruct WebKit to allow the navigation.
`WEBKIT_NAVIGATION_RESPONSE_IGNORE` | Instruct WebKit to ignore the navigation.
`WEBKIT_NAVIGATION_RESPONSE_DOWNLOAD` | Instruct WebKit to start a download of the destination instead.

### enum WebKitWebViewTargetInfo

    typedef enum {
        WEBKIT_WEB_VIEW_TARGET_INFO_HTML,
        WEBKIT_WEB_VIEW_TARGET_INFO_TEXT,
        WEBKIT_WEB_VIEW_TARGET_INFO_IMAGE,
        WEBKIT_WEB_VIEW_TARGET_INFO_URI_LIST,
        WEBKIT_WEB_VIEW_TARGET_INFO_NETSCAPE_URL
    } 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.

`WEBKIT_WEB_VIEW_TARGET_INFO_HTML` | Rich markup data
`WEBKIT_WEB_VIEW_TARGET_INFO_TEXT` | Text data
`WEBKIT_WEB_VIEW_TARGET_INFO_IMAGE` | Image data
`WEBKIT_WEB_VIEW_TARGET_INFO_URI_LIST` | URI list data
`WEBKIT_WEB_VIEW_TARGET_INFO_NETSCAPE_URL` | A single URL in the Netscape protocol

### enum WebKitWebViewViewMode

    typedef enum {
        WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED,
        WEBKIT_WEB_VIEW_VIEW_MODE_FLOATING,
        WEBKIT_WEB_VIEW_VIEW_MODE_FULLSCREEN,
        WEBKIT_WEB_VIEW_VIEW_MODE_MAXIMIZED,
        WEBKIT_WEB_VIEW_VIEW_MODE_MINIMIZED
    } WebKitWebViewViewMode;

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

`WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED` | Windowed view mode
`WEBKIT_WEB_VIEW_VIEW_MODE_FLOATING` | Floating view mode
`WEBKIT_WEB_VIEW_VIEW_MODE_FULLSCREEN` | Fullscreen view mode
`WEBKIT_WEB_VIEW_VIEW_MODE_MAXIMIZED` | Maximized view mode
`WEBKIT_WEB_VIEW_VIEW_MODE_MINIMIZED` | Minimized view mode

### WebKitWebView

    typedef struct _WebKitWebView WebKitWebView;

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if a selection can be copied, `FALSE` if not

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if a selection can be cut, `FALSE` if not

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if able to move back, `FALSE` otherwise

### 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.

`web_view` : | a WebKitWebView
`steps` : | the number of steps
Returns : | `TRUE` if able to move back or forward the given number of steps, `FALSE` otherwise

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if able to move forward, `FALSE` otherwise

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if a selection can be pasted, `FALSE` if not

### 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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if a redo can be done, `FALSE` if not

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.

`web_view` : | a WebKitWebView
`mime_type` : | a MIME type
Returns : | a gboolean indicating if the MIME type can be displayed

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.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if a undo can be done, `FALSE` if not

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.

`web_view` : | a WebKitWebView

### 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.

`web_view` : | a WebKitWebView

### webkit_web_view_delete_selection ()

    void                webkit_web_view_delete_selection    (WebKitWebView *web_view);

Deletes the current selection inside the `web_view`.

`web_view` : | a WebKitWebView

### 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.

`web_view` : | a WebKitWebView
Returns : | the WebKitWebBackForwardList. [transfer none]

### 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()`.

`web_view` : | a WebKitWebView
Returns : | the GtkTargetList

### 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.

`web_view` : | a WebKitWebView
Returns : | a string containing the current custom encoding for `web_view`, or `NULL` if there's none set.

Since 1.1.1

### webkit_web_view_get_dom_document ()

    WebKitDOMDocument * webkit_web_view_get_dom_document    (WebKitWebView *web_view);

`web_view` : | a WebKitWebView
Returns : | the WebKitDOMDocument currently loaded in the main frame of the `web_view` or `NULL` if no document is loaded. [transfer none]

Since 1.3.1

### webkit_web_view_get_editable ()

    gboolean            webkit_web_view_get_editable        (WebKitWebView *web_view);

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.

`web_view` : | a WebKitWebView
Returns : | a gboolean indicating the editable state

### webkit_web_view_get_encoding ()

    const gchar *       webkit_web_view_get_encoding        (WebKitWebView *web_view);

Returns the default encoding of the WebKitWebView.

`web_view` : | a WebKitWebView
Returns : | the default encoding

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.

`web_view` : | a WebKitWebView
Returns : | The focused WebKitWebFrame or `NULL` if no frame is focused. [transfer none]

### 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.

`web_view` : | a WebKitWebView
Returns : | `FALSE` if only text should be scaled (the default), `TRUE` if the full content of the view should be scaled.

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`.

`web_view` : | a WebKitWebView
`event` : | a GdkEventButton
Returns : | a newly created WebKitHitTestResult with the context of the specified position. [transfer full]

Since 1.1.15

### webkit_web_view_get_icon_pixbuf ()

    GdkPixbuf *         webkit_web_view_get_icon_pixbuf     (WebKitWebView *web_view);

### Warning

`webkit_web_view_get_icon_pixbuf` has been deprecated since version 1.8 and should not be used in newly-written code. Use `webkit_web_view_try_get_favicon_pixbuf()` instead.

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()`.

`web_view` : | the WebKitWebView object
Returns : | a new reference to a GdkPixbuf, or `NULL`. [transfer full]

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.

`web_view` : | the WebKitWebView object
Returns : | the URI for the favicon, or `NULL`

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.

`web_view` : | a WebKitWebView
Returns : | the WebKitWebInspector instance. [transfer none]

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.

`web_view` : | a WebKitWebView
Returns : | a WebKitLoadStatus specifying the status of the current 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`.

`web_view` : | a WebKitWebView
Returns : | the main WebKitWebFrame for `web_view`. [transfer none]

### 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()`.

`web_view` : | a WebKitWebView
Returns : | the GtkTargetList

### webkit_web_view_get_progress ()

    gdouble             webkit_web_view_get_progress        (WebKitWebView *web_view);

Determines the current progress of the load.

`web_view` : | a WebKitWebView
Returns : | a gdouble representing the status of the current load. This value will be in the range [0, 1].

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.

`web_view` : | a WebKitWebView
Returns : | the WebKitWebSettings instance. [transfer none]

### webkit_web_view_get_title ()

    const gchar *       webkit_web_view_get_title           (WebKitWebView *web_view);

Returns the `web_view`'s document title

`web_view` : | a WebKitWebView
Returns : | the title of `web_view`

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.

`web_view` : | a WebKitWebView
Returns : | `FALSE` when the WebKitWebView draws a solid background (the default), otherwise `TRUE`.

### 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`

`web_view` : | a WebKitWebView
Returns : | the URI of `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.

`web_view` : | the WebKitWebView to obtain the view mode from
Returns : | the `WebKitWebViewViewMode` currently set for the WebKitWebView.

Since 1.3.4

### webkit_web_view_get_view_source_mode ()

    gboolean            webkit_web_view_get_view_source_mode
                                                            (WebKitWebView *web_view);

`web_view` : | a WebKitWebView
Returns : | `TRUE` if `web_view` is in view source mode, `FALSE` otherwise.

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.

`web_view` : | a WebKitWebView
Returns : | the WebKitViewportAttributes instance. [transfer none]

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.

`web_view` : | a WebKitWebView
Returns : | the zoom level of `web_view`

Since 1.0.1

### webkit_web_view_go_back ()

    void                webkit_web_view_go_back             (WebKitWebView *web_view);

Loads the previous history item.

`web_view` : | a WebKitWebView

### 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.

`web_view` : | a WebKitWebView
`steps` : | the number of steps

### webkit_web_view_go_forward ()

    void                webkit_web_view_go_forward          (WebKitWebView *web_view);

Loads the next history item.

`web_view` : | a WebKitWebView

### 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

`web_view` : | a WebKitWebView
`item` : | a WebKitWebHistoryItem*
Returns : | `TRUE` if loading of item is successful, `FALSE` if not

### webkit_web_view_has_selection ()

    gboolean            webkit_web_view_has_selection       (WebKitWebView *web_view);

Determines whether text was selected.

`web_view` : | a WebKitWebView
Returns : | `TRUE` if there is selected text, `FALSE` if not

### webkit_web_view_load_html_string ()

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

### Warning

`webkit_web_view_load_html_string` has been deprecated since version 1.1.1 and should not be used in newly-written code. Use `webkit_web_view_load_string()` instead.

Requests loading of the given `content` with the specified `base_uri`.

`web_view` : | a WebKitWebView
`content` : | an URI string
`base_uri` : | the base URI for relative locations

### 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.

`web_view` : | a WebKitWebView
`request` : | a WebKitNetworkRequest

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.

`web_view` : | a WebKitWebView
`content` : | an URI string
`mime_type` : | the MIME type, or `NULL`
`encoding` : | the encoding, or `NULL`
`base_uri` : | the base URI for relative locations

### webkit_web_view_load_uri ()

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

Requests loading of the specified URI string.

`web_view` : | a WebKitWebView
`uri` : | an 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.

`web_view` : | a WebKitWebView
`string` : | a string to look for
`case_sensitive` : | whether to respect the case of text
`limit` : | the maximum number of strings to look for or 0 for all
Returns : | the number of strings highlighted

### 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`.

`web_view` : | a WebKitWebView
`step` : | a GtkMovementStep
`count` : | integer describing the direction of the movement. 1 for forward, -1 for backwards.

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);

### Warning

`webkit_web_view_open` has been deprecated since version 1.1.1 and should not be used in newly-written code. Use `webkit_web_view_load_uri()` instead.

Requests loading of the specified URI string.

`web_view` : | a WebKitWebView
`uri` : | an URI

### 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`.

`web_view` : | a WebKitWebView

### webkit_web_view_redo ()

    void                webkit_web_view_redo                (WebKitWebView *web_view);

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

`web_view` : | a WebKitWebView

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.

`web_view` : | a WebKitWebView

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.

`web_view` : | a WebKitWebView
`text` : | a string to look for
`case_sensitive` : | whether to respect the case of text
`forward` : | whether to find forward or not
`wrap` : | whether to continue looking at the beginning after reaching the end
Returns : | `TRUE` on success or `FALSE` on failure

### webkit_web_view_select_all ()

    void                webkit_web_view_select_all          (WebKitWebView *web_view);

Attempts to select everything inside the `web_view`.

`web_view` : | a WebKitWebView

### 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.

`web_view` : | a WebKitWebView
`encoding` : | the new encoding, or `NULL` to restore the default encoding

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.

`web_view` : | a WebKitWebView
`flag` : | a gboolean indicating the editable state

### 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.

`web_view` : | a WebKitWebView
`full_content_zoom` : | `FALSE` if only text should be scaled (the default), `TRUE` if the full content of the view should be scaled.

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.

`web_view` : | a WebKitWebView
`highlight` : | whether to highlight 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.

`web_view` : | a WebKitWebView
`flag` : | to tell the view to maintain a back or forward list

### 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`.

`web_view` : | a WebKitWebView
`settings` : | the WebKitWebSettings to be set. [transfer none]

### 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`.

`web_view` : | a WebKitWebView
`flag` : | whether or not `web_view` should be transparent

### 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.

`web_view` : | the WebKitWebView that will have its view mode set
`mode` : | the `WebKitWebViewViewMode` to be set

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.

`web_view` : | a WebKitWebView
`view_source_mode` : | the mode to turn on or off view source mode

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.

`web_view` : | a WebKitWebView
`zoom_level` : | the new zoom level

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`.

`web_view` : | a WebKitWebView

### 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.

`web_view` : | the WebKitWebView object
`width` : | the desired width for the icon
`height` : | the desired height for the icon
Returns : | a new reference to a GdkPixbuf, or `NULL`. [transfer full]

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.

`web_view` : | a WebKitWebView

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.

`web_view` : | a WebKitWebView

### 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`.

`web_view` : | a WebKitWebView

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`.

`web_view` : | a WebKitWebView

Since 1.0.1

### webkit_web_view_get_window_features ()

    WebKitWebWindowFeatures * webkit_web_view_get_window_features
                                                            (WebKitWebView *web_view);

`web_view` : | a WebKitWebView
Returns : | the instance of WebKitWebWindowFeatures held by the given WebKitWebView. [transfer none]

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`.

`web_view` : | a WebKitWebView
Returns : | a `cairo_surface_t`. [transfer full]

Since 1.10

## Property Details

### The `"copy-target-list"` property

      "copy-target-list"         GtkTargetList*        : Read

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

Since 1.0.2

### The `"custom-encoding"` property

      "custom-encoding"          gchar*                : Read / Write

The custom encoding of the web view.

Default value: NULL

Since 1.1.2

### The `"editable"` property

      "editable"                 gboolean              : Read / Write

Whether content can be modified by the user.

Default value: FALSE

### The `"encoding"` property

      "encoding"                 gchar*                : Read

The default encoding of the web view.

Default value: NULL

Since 1.1.2

### The `"full-content-zoom"` property

      "full-content-zoom"        gboolean              : Read / Write

Whether the full content is scaled when zooming.

Default value: FALSE

Since 1.0.1

### The `"icon-uri"` property

      "icon-uri"                 gchar*                : Read

The URI for the favicon for the WebKitWebView.

Default value: NULL

Since 1.1.18

### The `"im-context"` property

      "im-context"               GtkIMContext*         : Read

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.

Since 1.1.20

### The `"load-status"` property

      "load-status"              WebKitLoadStatus      : Read

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.

Default value: WEBKIT_LOAD_FINISHED

Since 1.1.7

### The `"paste-target-list"` property

      "paste-target-list"        GtkTargetList*        : Read

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

Since 1.0.2

### The `"progress"` property

      "progress"                 gdouble               : Read

Determines the current progress of the load.

Allowed values: [0,1]

Default value: 1

Since 1.1.7

### The `"self-scrolling"` property

      "self-scrolling"           gboolean              : Read / Write / Construct Only

Whether or not this WebView draws its own scrollbars.

Default value: FALSE

### The `"settings"` property

      "settings"                 WebKitWebSettings*    : Read / Write

An associated WebKitWebSettings instance.

### The `"title"` property

      "title"                    gchar*                : Read

Returns the @web_view's document title.

Default value: NULL

Since 1.1.4

### The `"transparent"` property

      "transparent"              gboolean              : Read / Write

Whether content has a transparent background.

Default value: FALSE

### The `"uri"` property

      "uri"                      gchar*                : Read

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

Default value: NULL

Since 1.1.4

### The `"view-mode"` property

      "view-mode"                WebKitWebViewViewMode  : Read / Write

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.

Default value: WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED

Since 1.3.4

### The `"viewport-attributes"` property

      "viewport-attributes"      WebKitViewportAttributes*  : Read

The associated WebKitViewportAttributes instance.

Since 1.3.8

### The `"web-inspector"` property

      "web-inspector"            WebKitWebInspector*   : Read

The associated WebKitWebInspector instance.

Since 1.0.3

### The `"window-features"` property

      "window-features"          WebKitWebWindowFeatures*  : Read / Write

An associated WebKitWebWindowFeatures instance.

Since 1.0.3

### The `"zoom-level"` property

      "zoom-level"               gfloat                : Read / Write

The level of zoom of the content.

Allowed values: >= G_MINFLOAT

Default value: 1

Since 1.0.1

## Signal Details

### The `"close-web-view"` signal

    gboolean            user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Run Last

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.

`web_view` : | the object on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop handlers from being invoked for the event or `FALSE` to propagate the event furter

Since 1.1.11

### The `"console-message"` signal

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

A JavaScript console message was created.

`web_view` : | the object on which the signal is emitted
`message` : | the message text
`line` : | the line where the error occured
`source_id` : | the source id
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

### The `"context-menu"` signal

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

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.

`web_view` : | the object which received the signal
`default_menu` : | the default context menu
`hit_test_result` : | a WebKitHitTestResult with the context of the current position.
`triggered_with_keyboard` : | `TRUE` if the context menu was triggered using the keyboard
`user_data` : | user data set when the signal handler was connected.

Since 1.10

### The `"copy-clipboard"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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.

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

### The `"create-plugin-widget"` signal

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

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.

`web_view` : | the object which received the signal
`mime_type` : | the mimetype of the requested object
`uri` : | the URI to load
`param` : | a GHashTable with additional attributes (strings)
`user_data` : | user data set when the signal handler was connected.
Returns : | a new GtkWidget, or `NULL`. [transfer full]

Since 1.1.8

### The `"create-web-view"` signal

    WebKitWebView*      user_function                      (WebKitWebView  *web_view,
                                                            WebKitWebFrame *frame,
                                                            gpointer        user_data)      : Run Last

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.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame
`user_data` : | user data set when the signal handler was connected.
Returns : | a newly allocated WebKitWebView, or `NULL`. [transfer full]

Since 1.0.3

### The `"cut-clipboard"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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.

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

### The `"database-quota-exceeded"` signal

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

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.

`web_view` : | the object which received the signal
`frame` : | the relevant frame
`database` : | the WebKitWebDatabase which exceeded the quota of its WebKitSecurityOrigin
`user_data` : | user data set when the signal handler was connected.

Since 1.1.14

### The `"document-load-finished"` signal

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

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

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame whose load dispatched this request
`user_data` : | user data set when the signal handler was connected.

### The `"download-requested"` signal

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

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()`).

`web_view` : | the object on which the signal is emitted
`download` : | a WebKitDownload object that lets you control the download process
`user_data` : | user data set when the signal handler was connected.
Returns : | TRUE if the download should be performed, `FALSE` to cancel it

Since 1.1.2

### The `"editing-began"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

`web_view` : | the WebKitWebView on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.

### The `"editing-ended"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

`web_view` : | the WebKitWebView on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.

### The `"entering-fullscreen"` signal

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

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).

`web_view` : | the WebKitWebView on which the signal is emitted.
`element` : | the WebKitDOMHTMLElement which has requested full screen display.
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to continue emission of the event.

Since 1.9.0

### The `"frame-created"` signal

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

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.

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame which was just created.
`user_data` : | user data set when the signal handler was connected.

Since 1.3.4

### The `"geolocation-policy-decision-cancelled"` signal

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

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

`web_view` : | the object on which the signal is emitted
`frame` : | the frame that cancels geolocation request.
`user_data` : | user data set when the signal handler was connected.

Since 1.1.23

### The `"geolocation-policy-decision-requested"` signal

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

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`.

`web_view` : | the object on which the signal is emitted
`frame` : | the frame that requests permission
`policy_decision` : | a WebKitGeolocationPolicyDecision
`user_data` : | user data set when the signal handler was connected.

Since 1.1.23

### The `"hovering-over-link"` signal

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

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

`web_view` : | the object on which the signal is emitted
`title` : | the link's title
`uri` : | the URI the link points to
`user_data` : | user data set when the signal handler was connected.

### The `"icon-loaded"` signal

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

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.

`web_view` : | the object on which the signal is emitted
`icon_uri` : | the URI for the icon
`user_data` : | user data set when the signal handler was connected.

Since 1.1.18

### The `"leaving-fullscreen"` signal

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

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.

`web_view` : | the WebKitWebView on which the signal is emitted.
`element` : | the WebKitDOMHTMLElement which is currently displayed full screen.
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to continue emission of the event.

Since 1.9.0

### The `"load-committed"` signal

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

### Warning

`WebKitWebView::load-committed` is deprecated and should not be used in newly-written code. Use the "load-status" property instead.

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

`web_view` : | the object on which the signal is emitted
`frame` : | the main frame that received the first data
`user_data` : | user data set when the signal handler was connected.

### The `"load-error"` signal

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

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.

`web_view` : | the object on which the signal is emitted
`web_frame` : | the WebKitWebFrame
`uri` : | the URI that triggered the error
`web_error` : | the GError that was triggered
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

Since 1.1.6

### The `"load-finished"` signal

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

### Warning

`WebKitWebView::load-finished` is deprecated and should not be used in newly-written code. Use the "load-status" property instead.

`web_view` : | the WebKitWebView
`frame` : | the WebKitWebFrame
`user_data` : | user data set when the signal handler was connected.

### The `"load-progress-changed"` signal

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

### Warning

`WebKitWebView::load-progress-changed` is deprecated and should not be used in newly-written code. Use the "progress" property instead.

`web_view` : | the WebKitWebView
`progress` : | the global progress
`user_data` : | user data set when the signal handler was connected.

### The `"load-started"` signal

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

### Warning

`WebKitWebView::load-started` is deprecated and should not be used in newly-written code. Use the "load-status" property instead.

When a WebKitWebFrame begins to load this signal is emitted.

`web_view` : | the object on which the signal is emitted
`frame` : | the frame going to do the load
`user_data` : | user data set when the signal handler was connected.

### 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)            : Run Last

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.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame that required the policy decision
`request` : | a WebKitNetworkRequest
`mimetype` : | the MIME type attempted to load
`policy_decision` : | a WebKitWebPolicyDecision
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` if a decision was made, `FALSE` to have the default behavior apply

Since 1.0.3

### The `"move-cursor"` signal

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

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

`web_view` : | the object which received the signal
`step` : | the type of movement, one of GtkMovementStep
`count` : | an integer indicating the subtype of movement. Currently the permitted values are '1' = forward, '-1' = backwards.
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` or `FALSE`

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)              : Run Last

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.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame that required the navigation
`request` : | a WebKitNetworkRequest
`navigation_action` : | a WebKitWebNavigationAction
`policy_decision` : | a WebKitWebPolicyDecision
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` if a decision was made, `FALSE` to have the default behavior apply

Since 1.0.3

### The `"navigation-requested"` signal

    WebKitNavigationResponseuser_function                      (WebKitWebView        *web_view,
                                                            WebKitWebFrame       *frame,
                                                            WebKitNetworkRequest *request,
                                                            gpointer              user_data)      : Run Last

### Warning

`WebKitWebView::navigation-requested` is deprecated and should not be used in newly-written code. Use WebKitWebView::navigation-policy-decision-requested instead

Emitted when `frame` requests a navigation to another page.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame that required the navigation
`request` : | a WebKitNetworkRequest
`user_data` : | user data set when the signal handler was connected.
Returns : | a WebKitNavigationResponse

### 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)              : Run Last

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.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame that required the navigation
`request` : | a WebKitNetworkRequest
`navigation_action` : | a WebKitWebNavigationAction
`policy_decision` : | a WebKitWebPolicyDecision
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` if a decision was made, `FALSE` to have the default behavior apply

Since 1.1.4

### The `"onload-event"` signal

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

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

`web_view` : | the object on which the signal is emitted
`frame` : | the frame
`user_data` : | user data set when the signal handler was connected.

### The `"paste-clipboard"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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.

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

### The `"populate-popup"` signal

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

### Warning

`WebKitWebView::populate-popup` has been deprecated since version 1.10 and should not be used in newly-written code. Use "context-menu" signal instead.

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

Add menu items to menu to extend the context menu.

`web_view` : | the object on which the signal is emitted
`menu` : | the context menu
`user_data` : | user data set when the signal handler was connected.

### The `"print-requested"` signal

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

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`.

`web_view` : | the object in which the signal is emitted
`web_frame` : | the frame that is requesting to be printed
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` if the print request has been handled, `FALSE` if the default handler should run

Since 1.1.5

### The `"redo"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

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)            : Run Last

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.

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame the response was received for
`web_resource` : | the WebKitWebResource that was loaded
`length_received` : | the amount of data received since the last signal emission
`user_data` : | user data set when the signal handler was connected.

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)         : Run Last

Invoked when a resource failed to load

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame the response was received for
`web_resource` : | the WebKitWebResource that was loaded
`error` : | the GError that was triggered
`user_data` : | user data set when the signal handler was connected.

Since 1.7.5

### The `"resource-load-finished"` signal

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

Emitted when all the data for the resource was loaded

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame the response was received for
`web_resource` : | the WebKitWebResource that was loaded
`user_data` : | user data set when the signal handler was connected.

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)         : Action

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.

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame whose load dispatched this request
`web_resource` : | an empty WebKitWebResource object
`request` : | the WebKitNetworkRequest that will be dispatched
`response` : | the WebKitNetworkResponse representing the redirect response, if any
`user_data` : | user data set when the signal handler was connected.

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)         : Run Last

Emitted when the first byte of data arrives

`web_view` : | the object which received the signal
`web_frame` : | the WebKitWebFrame the response was received for
`web_resource` : | the WebKitWebResource being loaded
`response` : | the WebKitNetworkResponse that was received
`user_data` : | user data set when the signal handler was connected.

Since 1.7.5

### The `"run-file-chooser"` signal

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

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()`.

`web_view` : | the WebKitWebView on which the signal is emitted
`request` : | a WebKitFileChooserRequest
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

### The `"script-alert"` signal

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

A JavaScript alert dialog was created.

`web_view` : | the object on which the signal is emitted
`frame` : | the relevant frame
`message` : | the message text
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

### The `"script-confirm"` signal

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

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

`web_view` : | the object on which the signal is emitted
`frame` : | the relevant frame
`message` : | the message text
`confirmed` : | a pointer to a gboolean where the callback should store whether the user confirmed the dialog, when handling this signal
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

### The `"script-prompt"` signal

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

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

`web_view` : | the object on which the signal is emitted
`frame` : | the relevant frame
`message` : | the message text
`default` : | the default value
`text` : | To be filled with the return value or NULL if the dialog was cancelled.
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop other handlers from being invoked for the event. `FALSE` to propagate the event further.

### The `"select-all"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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.

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

### The `"selection-changed"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

`web_view` : | the WebKitWebView on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.

### The `"should-apply-style"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`set` : | a WebKitDOMCSSStyleDeclaration
`range` : | a WebKitDOMRange
`user_data` : | user data set when the signal handler was connected.

### The `"should-begin-editing"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`range` : | a WebKitDOMRange
`user_data` : | user data set when the signal handler was connected.

### The `"should-change-selected-range"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`fromRange` : | a WebKitDOMRange
`toRange` : | a WebKitDOMRange
`affinity` : | a WebKitElectionAffinity
`stillSelecting` : | bool
`user_data` : | user data set when the signal handler was connected.

### The `"should-delete-range"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`range` : | a WebKitDOMRange
`user_data` : | user data set when the signal handler was connected.

### The `"should-end-editing"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`range` : | a WebKitDOMRange
`user_data` : | user data set when the signal handler was connected.

### The `"should-insert-node"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`node` : | a WebKitDOMNode
`range` : | a WebKitDOMRange
`action` : | a WebKitInsertAction
`user_data` : | user data set when the signal handler was connected.

### The `"should-insert-text"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`string` : | a string
`range` : | a WebKitDOMRange
`action` : | a WebKitInsertAction
`user_data` : | user data set when the signal handler was connected.

### The `"should-show-delete-interface-for-element"` signal

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

`web_view` : | the WebKitWebView on which the signal is emitted
`element` : | a WebKitDOMHtmlElement
`user_data` : | user data set when the signal handler was connected.

### The `"status-bar-text-changed"` signal

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

`webkitwebview` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"title-changed"` signal

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

### Warning

`WebKitWebView::title-changed` has been deprecated since version 1.1.4 and should not be used in newly-written code. Use "notify::title" instead.

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

`web_view` : | the object on which the signal is emitted
`frame` : | the main frame
`title` : | the new title
`user_data` : | user data set when the signal handler was connected.

### The `"undo"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

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

`web_view` : | the object which received the signal
`user_data` : | user data set when the signal handler was connected.

Since 1.1.14

### The `"user-changed-contents"` signal

    void                user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Action

`web_view` : | the WebKitWebView on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.

### The `"viewport-attributes-changed"` signal

    void                user_function                      (WebKitWebView            *webkitwebview,
                                                            WebKitViewportAttributes *arg1,
                                                            gpointer                  user_data)          : Action

`webkitwebview` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"viewport-attributes-recompute-requested"` signal

    void                user_function                      (WebKitWebView            *webkitwebview,
                                                            WebKitViewportAttributes *arg1,
                                                            gpointer                  user_data)          : Action

`webkitwebview` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"web-view-ready"` signal

    gboolean            user_function                      (WebKitWebView *web_view,
                                                            gpointer       user_data)      : Run Last

Emitted after "create-web-view" when the new WebKitWebView 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 scroll bars should be displayed, is already set on the WebKitWebWindowFeatures object contained by the WebKitWebView.

Notice that some of that information may change during the life time of the window, so you may want to connect to the ::notify signal of the WebKitWebWindowFeatures object to handle those.

`web_view` : | the object on which the signal is emitted
`user_data` : | user data set when the signal handler was connected.
Returns : | `TRUE` to stop handlers from being invoked for the event or `FALSE` to propagate the event furter

Since 1.0.3

### The `"window-object-cleared"` signal

    void                user_function                      (WebKitWebView  *web_view,
                                                            WebKitWebFrame *frame,
                                                            gpointer        context,
                                                            gpointer        window_object,
                                                            gpointer        user_data)          : Run Last

Emitted when the JavaScript window object in a WebKitWebFrame has been cleared in preparation for a new load. This is the preferred place to set custom properties on the window object using the JavaScriptCore API.

`web_view` : | the object on which the signal is emitted
`frame` : | the WebKitWebFrame to which `window_object` belongs
`context` : | the JSGlobalContextRef holding the global object and other execution state; equivalent to the return value of webkit_web_frame_get_global_context(`frame`)
`window_object` : | the JSObjectRef representing the frame's JavaScript window object
`user_data` : | user data set when the signal handler was connected.

## See Also

WebKitWebSettings, WebKitWebFrame