webkit_web_frame_find_frame ()

WebKitWebFrame *
webkit_web_frame_find_frame (WebKitWebFrame *frame,
                             const gchar *name);

For pre-defined names, returns frame if name is "_self" or "_current", returns frame 's parent frame if name is "_parent", and returns the main frame if name is "_top". Also returns frame if it is the main frame and name is either "_parent" or "_top". For other names, this function returns the first frame that matches name . This function searches frame and its descendents first, then frame 's parent and its children moving up the hierarchy until a match is found. If no match is found in frame 's hierarchy, this function will search for a matching frame in other main frame hierarchies. Returns NULL if no match is found.

webkit_web_frame_get_data_source ()

WebKitWebDataSource *
webkit_web_frame_get_data_source (WebKitWebFrame *frame);

Returns the committed data source.

Since: 1.1.14

webkit_web_frame_get_dom_document ()

WebKitDOMDocument *
webkit_web_frame_get_dom_document (WebKitWebFrame *frame);

Since: 1.10

webkit_web_frame_get_global_context ()

JSGlobalContextRef
webkit_web_frame_get_global_context (WebKitWebFrame *frame);

Gets the global JavaScript execution context. Use this function to bridge between the WebKit and JavaScriptCore APIs.

webkit_web_frame_get_horizontal_scrollbar_policy ()

GtkPolicyType
webkit_web_frame_get_horizontal_scrollbar_policy
                               (WebKitWebFrame *frame);

webkit_web_frame_get_load_status ()

WebKitLoadStatus
webkit_web_frame_get_load_status (WebKitWebFrame *frame);

Determines the current status of the load.

Since: 1.1.7

webkit_web_frame_get_name ()

const gchar *
webkit_web_frame_get_name (WebKitWebFrame *frame);

Returns the frame 's name

webkit_web_frame_get_network_response ()

WebKitNetworkResponse *
webkit_web_frame_get_network_response (WebKitWebFrame *frame);

Returns a WebKitNetworkResponse object representing the response that was given to the request for the given frame, or NULL if the frame was not created by a load. You must unref the object when you are done with it.

Since: 1.1.18

webkit_web_frame_get_parent ()

WebKitWebFrame *
webkit_web_frame_get_parent (WebKitWebFrame *frame);

Returns the frame 's parent frame, or NULL if it has none.

webkit_web_frame_get_provisional_data_source ()

WebKitWebDataSource *
webkit_web_frame_get_provisional_data_source
                               (WebKitWebFrame *frame);

You use the webkit_web_frame_load_request method to initiate a request that creates a provisional data source. The provisional data source will transition to a committed data source once any data has been received. Use webkit_web_frame_get_data_source to get the committed data source.

Since: 1.1.14

webkit_web_frame_get_security_origin ()

WebKitSecurityOrigin *
webkit_web_frame_get_security_origin (WebKitWebFrame *frame);

Returns the frame 's security origin.

Since: 1.1.14

webkit_web_frame_get_title ()

const gchar *
webkit_web_frame_get_title (WebKitWebFrame *frame);

Returns the frame 's document title

webkit_web_frame_get_uri ()

const gchar *
webkit_web_frame_get_uri (WebKitWebFrame *frame);

Returns the current URI of the contents displayed by the frame

webkit_web_frame_get_vertical_scrollbar_policy ()

GtkPolicyType
webkit_web_frame_get_vertical_scrollbar_policy
                               (WebKitWebFrame *frame);

webkit_web_frame_get_web_view ()

WebKitWebView *
webkit_web_frame_get_web_view (WebKitWebFrame *frame);

Returns the WebKitWebView that manages this WebKitWebFrame.

The WebKitWebView returned manages the entire hierarchy of WebKitWebFrame objects that contains frame .

webkit_web_frame_load_alternate_string ()

void
webkit_web_frame_load_alternate_string
                               (WebKitWebFrame *frame,
                                const gchar *content,
                                const gchar *base_url,
                                const gchar *unreachable_url);

Request loading of an alternate content for a URL that is unreachable. Using this method will preserve the back-forward list. The URI passed in base_url has to be an absolute URI.

Since: 1.1.6

webkit_web_frame_load_request ()

void
webkit_web_frame_load_request (WebKitWebFrame *frame,
                               WebKitNetworkRequest *request);

Connects to a given URI by initiating an 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_frame_stop_loading() to stop the load. This function is typically invoked on the main frame.

webkit_web_frame_load_string ()

void
webkit_web_frame_load_string (WebKitWebFrame *frame,
                              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.

Since: 1.1.1

webkit_web_frame_load_uri ()

void
webkit_web_frame_load_uri (WebKitWebFrame *frame,
                           const gchar *uri);

Requests loading of the specified URI string.

Since: 1.1.1

webkit_web_frame_new ()

WebKitWebFrame *
webkit_web_frame_new (WebKitWebView *web_view);

Creates a new WebKitWebFrame initialized with a controlling WebKitWebView.

webkit_web_frame_print ()

void
webkit_web_frame_print (WebKitWebFrame *frame);

Prints the given WebKitWebFrame, by presenting a print dialog to the user. If you need more control over the printing process, see webkit_web_frame_print_full().

Since: 1.1.5

webkit_web_frame_print_full ()

GtkPrintOperationResult
webkit_web_frame_print_full (WebKitWebFrame *frame,
                             GtkPrintOperation *operation,
                             GtkPrintOperationAction action,
                             GError **error);

Prints the given WebKitWebFrame, using the given GtkPrintOperation and GtkPrintOperationAction. This function wraps a call to gtk_print_operation_run() for printing the contents of the WebKitWebFrame.

Since: 1.1.5

webkit_web_frame_reload ()

void
webkit_web_frame_reload (WebKitWebFrame *frame);

Reloads the initial request.

webkit_web_frame_stop_loading ()

void
webkit_web_frame_stop_loading (WebKitWebFrame *frame);

Stops any pending loads on frame 's data source, and those of its children.

enum WebKitLoadStatus

WebKitWebFrame

typedef struct _WebKitWebFrame WebKitWebFrame;

The “horizontal-scrollbar-policy” property

  “horizontal-scrollbar-policy” GtkPolicyType

Determines the current policy for the horizontal scrollbar of the frame. For the main frame, make sure to set the same policy on the scrollable widget containing the WebKitWebView, unless you know what you are doing.

Flags: Read

Default value: GTK_POLICY_AUTOMATIC

Since: 1.1.14

The “load-status” property

  “load-status”              WebKitLoadStatus

Determines the current status of the load.

Flags: Read

Default value: WEBKIT_LOAD_FINISHED

Since: 1.1.7

The “name” property

  “name”                     gchar *

The name of the frame.

Flags: Read

Default value: NULL

The “title” property

  “title”                    gchar *

The document title of the frame.

Flags: Read

Default value: NULL

The “uri” property

  “uri”                      gchar *

The current URI of the contents displayed by the frame.

Flags: Read

Default value: NULL

The “vertical-scrollbar-policy” property

  “vertical-scrollbar-policy” GtkPolicyType

Determines the current policy for the vertical scrollbar of the frame. For the main frame, make sure to set the same policy on the scrollable widget containing the WebKitWebView, unless you know what you are doing.

Flags: Read

Default value: GTK_POLICY_AUTOMATIC

Since: 1.1.14

The “cleared” signal

void
user_function (WebKitWebFrame *webkitwebframe,
               gpointer        user_data)

Flags: Run Last

The “hovering-over-link” signal

void
user_function (WebKitWebFrame *webkitwebframe,
               gchar          *arg1,
               gchar          *arg2,
               gpointer        user_data)

Flags: Run Last

The “insecure-content-run” signal

void
user_function (WebKitWebFrame       *web_frame,
               WebKitSecurityOrigin *security_origin,
               gchar                *url,
               gpointer              user_data)

Invoked when insecure content is run from a secure page. This happens when a page loaded via HTTPS loads a stylesheet, script, image or iframe from an unencrypted HTTP URL.

Flags: Run Last

Since: 1.10.0

The “load-committed” signal

void
user_function (WebKitWebFrame *web_frame,
               gpointer        user_data)

Emitted when frame loading is done.

Flags: Run Last

The “resource-content-length-received” signal

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

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

Flags: Run Last

Since: 1.7.5

The “resource-load-failed” signal

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

Invoked when a resource failed to load.

Flags: Run Last

Since: 1.7.5

The “resource-load-finished” signal

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

Emitted when all the data for the resource was loaded.

Flags: Run Last

Since: 1.7.5

The “resource-request-starting” signal

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

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

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

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

Flags: Run Last

Since: 1.7.5

The “resource-response-received” signal

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

Emitted when the response is received from the server.

Flags: Run Last

Since: 1.7.5

The “scrollbars-policy-changed” signal

gboolean
user_function (WebKitWebFrame *web_view,
               gpointer        user_data)

Signal emitted when policy for one or both of the scrollbars of the view has changed. The default handler will apply the new policy to the container that holds the WebKitWebFrame if it is a GtkScrolledWindow and the frame is the main frame. If you do not want this to be handled automatically, you need to handle this signal.

The exception to this rule is that policies to disable the scrollbars are applied as GTK_POLICY_AUTOMATIC instead, since the size request of the widget would force browser windows to not be resizable.

You can obtain the new policies from the WebKitWebFrame:horizontal-scrollbar-policy and WebKitWebFrame:vertical-scrollbar-policy properties.

Flags: Action

Since: 1.1.14

The “title-changed” signal

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

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

Flags: Run Last