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