Top | ![]() |
![]() |
![]() |
![]() |
struct | WebKitFaviconDatabase |
#define | WEBKIT_FAVICON_DATABASE_ERROR |
enum | WebKitFaviconDatabaseError |
WebKitFaviconDatabase provides access to the icons associated with web sites.
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 a memory cache if possible. That cache is frozen to an on-disk database for persistence.
If “enable-private-browsing” is TRUE
, new icons
won't be added to the on-disk database and no existing icons will
be deleted from it. Nevertheless, WebKit will still store them in
the in-memory cache during the current execution.
gchar * webkit_favicon_database_get_favicon_uri (WebKitFaviconDatabase *database
,const gchar *page_uri
);
Obtains the URI of the favicon for the given page_uri
.
a newly allocated URI for the favicon, or NULL
if the
database doesn't have a favicon for page_uri
.
void
webkit_favicon_database_clear (WebKitFaviconDatabase *database
);
Clears all icons from the database.
#define WEBKIT_FAVICON_DATABASE_ERROR (webkit_favicon_database_error_quark())
Enum values used to denote the various errors related to the WebKitFaviconDatabase.
The WebKitFaviconDatabase has not been initialized yet |
||
There is not an icon available for the requested URL |
||
There might be an icon for the requested URL, but its data is unknown at the moment |
“favicon-changed”
signalvoid user_function (WebKitFaviconDatabase *database, char *page_uri, char *favicon_uri, gpointer user_data)
This signal is emitted when the favicon URI of page_uri
has
been changed to favicon_uri
in the database. You can connect
to this signal and call webkit_favicon_database_get_favicon()
to get the favicon. If you are interested in the favicon of a
WebKitWebView it's easier to use the “favicon”
property. See webkit_web_view_get_favicon()
for more details.
database |
the object on which the signal is emitted |
|
page_uri |
the URI of the Web page containing the icon |
|
favicon_uri |
the URI of the favicon |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last