WebKitGTK+ Reference Manual: WebKitIconDatabase

## WebKitIconDatabase WebKitIconDatabase — A WebKit web application database |

## Synopsis

                        WebKitIconDatabase;
    void                webkit_icon_database_clear          (WebKitIconDatabase *database);
    GdkPixbuf *         webkit_icon_database_get_icon_pixbuf
                                                            (WebKitIconDatabase *database,
                                                             const gchar *page_uri);
    gchar *             webkit_icon_database_get_icon_uri   (WebKitIconDatabase *database,
                                                             const gchar *page_uri);
    const gchar *       webkit_icon_database_get_path       (WebKitIconDatabase *database);
    GType               webkit_icon_database_get_type       (void);
    void                webkit_icon_database_set_path       (WebKitIconDatabase *database,
                                                             const gchar *path);

## Object Hierarchy

      GObject
       +----WebKitIconDatabase

## Properties

      "path"                     gchar*                : Read / Write

## Signals

      "icon-loaded"                                    : Run Last

## Description

WebKitIconDatabase provides access to website icons, as shown in tab labels, window captions or bookmarks. All views share the same icon database.

The icon database is enabled by default and stored in ~/.local/share/webkit/icondatabase, depending on XDG_DATA_HOME.

WebKit will automatically look for available icons in link elements on opened pages as well as an existing favicon.ico and load the images found into the memory cache if possible. The signal "icon-loaded" will be emitted when any icon is found and loaded. Old Icons are automatically cleaned up after 4 days.

`webkit_icon_database_set_path()` can be used to change the location of the database and also to disable it by passing `NULL`.

If WebKitWebSettings::enable-private-browsing is `TRUE` new icons won't be added to the database on disk and no existing icons will be deleted from it.

## Details

### WebKitIconDatabase

    typedef struct _WebKitIconDatabase WebKitIconDatabase;

### webkit_icon_database_clear ()

    void                webkit_icon_database_clear          (WebKitIconDatabase *database);

### Warning

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

Clears all icons from the database.

`database` : | a WebKitIconDatabase

Since 1.3.13

### webkit_icon_database_get_icon_pixbuf ()

    GdkPixbuf *         webkit_icon_database_get_icon_pixbuf
                                                            (WebKitIconDatabase *database,
                                                             const gchar *page_uri);

### Warning

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

Obtains a GdkPixbuf of the favicon for the given page URI, or a default icon if there is no icon for the given page. Use `webkit_icon_database_get_icon_uri()` if you need to distinguish these cases. Usually you want to connect to WebKitIconDatabase::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_web_view_get_icon_pixbuf()`.

`database` : | a WebKitIconDatabase
`page_uri` : | URI of the page containing the icon
Returns : | a new reference to a GdkPixbuf, or `NULL`. [transfer full]

Since 1.3.13

### webkit_icon_database_get_icon_uri ()

    gchar *             webkit_icon_database_get_icon_uri   (WebKitIconDatabase *database,
                                                             const gchar *page_uri);

### Warning

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

Obtains the URI for the favicon for the given page URI. See also `webkit_web_view_get_icon_uri()`.

`database` : | a WebKitIconDatabase
`page_uri` : | URI of the page containing the icon
Returns : | a newly allocated URI for the favicon, or `NULL`

Since 1.3.13

### webkit_icon_database_get_path ()

    const gchar *       webkit_icon_database_get_path       (WebKitIconDatabase *database);

### Warning

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

Determines the absolute path to the database folder on disk.

`database` : | a WebKitIconDatabase
Returns : | the absolute path of the database folder, or `NULL`

Since 1.3.13

### webkit_icon_database_get_type ()

    GType               webkit_icon_database_get_type       (void);

### webkit_icon_database_set_path ()

    void                webkit_icon_database_set_path       (WebKitIconDatabase *database,
                                                             const gchar *path);

### Warning

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

Specifies the absolute path to the database folder on disk.

Passing `NULL` or "" disables the icon database.

`database` : | a WebKitIconDatabase
`path` : | an absolute path to the icon database folder

Since 1.3.13

## Property Details

### The `"path"` property

      "path"                     gchar*                : Read / Write

### Warning

`WebKitIconDatabase:path` has been deprecated since version 1.8 and should not be used in newly-written code. Use WebKitFaviconDatabase::path instead.

The absolute path of the icon database folder.

Default value: NULL

Since 1.3.13

## Signal Details

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

    void                user_function                      (WebKitIconDatabase *database,
                                                            WebKitWebFrame     *frame,
                                                            gchar              *frame_uri,
                                                            gpointer            user_data)      : Run Last

### Warning

`WebKitIconDatabase::icon-loaded` has been deprecated since version 1.8 and should not be used in newly-written code. Use WebKitFaviconDatabase::icon-loaded instead.

This signal is emitted when a favicon is available for a page, or a child frame. See WebKitWebView::icon-loaded if you only need the favicon for the main frame of a particular WebKitWebView.

`database` : | the object on which the signal is emitted
`frame` : | the frame containing the icon
`frame_uri` : | the URI of the frame containing the icon
`user_data` : | user data set when the signal handler was connected.

Since 1.3.13