## WebKitIconDatabase

WebKitIconDatabase

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

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