WebKitWebLoaderClient

WebKitWebLoaderClient

Synopsis

                    WebKitWebLoaderClient;

Object Hierarchy

  GObject
   +----WebKitWebLoaderClient

Signals

  "load-committed"                                 : Run Last
  "load-failed"                                    : Run Last
  "load-finished"                                  : Run Last
  "provisional-load-failed"                        : Run Last
  "provisional-load-received-server-redirect"      : Run Last
  "provisional-load-started"                       : Run Last

Description

Details

WebKitWebLoaderClient

typedef struct _WebKitWebLoaderClient WebKitWebLoaderClient;

Signal Details

The "load-committed" signal

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

This signal is emitted when content starts arriving for a page load. The necessary transport requirements are stabilished, and the load is being performed.

This signal is emitted after "provisional-load-started".

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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 "load-failed" signal

gboolean            user_function                      (WebKitWebLoaderClient *loader_client,
                                                        WebKitWebView         *web_view,
                                                        gchar                 *error,
                                                        gpointer               Returns,
                                                        gpointer               user_data)          : Run Last

This signal is emitted when an error occurs loading a committed data source. By default, if the signal is not handled, a stock error page will be displayed. You need to handle the signal if you want to provide your own error page. This signal finishes the load so no other signals will be emitted after this one.

This signal is emitted after "load-committed".

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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.

The "load-finished" signal

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

This signal is emitted when a page load completes, that is, when all the resources are done loading with no error. In case of errors during loading, the load finishes when either "provisional-load-failed" or "load-failed" are emitted.

This signal is emitted after "load-committed".

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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 "provisional-load-failed" signal

gboolean            user_function                      (WebKitWebLoaderClient *loader_client,
                                                        WebKitWebView         *web_view,
                                                        gchar                 *error,
                                                        gpointer               Returns,
                                                        gpointer               user_data)          : Run Last

This signal is emitted when an error occurs when starting to load data for a page. By default, if the signal is not handled, a stock error page will be displayed. You need to handle the signal if you want to provide your own error page. This signal finishes the load so no other signals will be emitted after this one.

This signal is emitted after "provisional-load-started".

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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.

The "provisional-load-received-server-redirect" signal

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

This signal is emitted when a provisional data source receives a server redirect.

This signal is emitted after "provisional-load-started".

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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 "provisional-load-started" signal

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

This signal is emitted when new load request is made. No data has been received yet, empty structures have been allocated to perform the load; the load may still fail for transport issues such as not being able to resolve a name, or connect to a port.

loader_client :

the WebKitWebLoaderClient

web_view :

the WebKitWebView associated with this event

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.