Method

WebKit2FaviconDatabaseget_favicon

Declaration [src]

void
webkit_favicon_database_get_favicon (
  WebKitFaviconDatabase* database,
  const gchar* page_uri,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

Description [src]

Asynchronously obtains a #cairo_surface_t of the favicon for the given page URI. It returns the cached icon if it’s in the database asynchronously waiting for the icon to be read from the database.

This is an asynchronous method. When the operation is finished, callback will be invoked. You can then call webkit_favicon_database_get_favicon_finish() to get the result of the operation.

You must call webkit_web_context_set_favicon_database_directory() for the WebKitWebContext associated with this WebKitFaviconDatabase before attempting to use this function; otherwise, webkit_favicon_database_get_favicon_finish() will return WEBKIT_FAVICON_DATABASE_ERROR_NOT_INITIALIZED.

Parameters

`page_uri`	`const gchar*`
	URI of the page for which we want to retrieve the favicon.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`cancellable`	`GCancellable`
	A `GCancellable` or `NULL`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`callback`	`GAsyncReadyCallback`
	A `GAsyncReadyCallback` to call when the request is satisfied or `NULL` if you don’t care about the result.
	The argument can be `NULL`.
`user_data`	`gpointer`
	The data to pass to `callback`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.