GThemedIcon
GThemedIcon — Icon theming support
|
|
Object Hierarchy
GObject
╰── GThemedIcon
Implemented Interfaces
GThemedIcon implements
GIcon.
Includes
#include <gio/gio.h>
Description
GThemedIcon is an implementation of GIcon that supports icon themes.
GThemedIcon contains a list of all of the icons present in an icon
theme, so that icons can be looked up quickly. GThemedIcon does
not provide actual pixmaps for icons, just the icon names.
Ideally something like gtk_icon_theme_choose_icon() should be used to
resolve the list of names so that fallback icons work nicely with
themes that inherit other themes.
Functions
g_themed_icon_new ()
GIcon *
g_themed_icon_new (const char *iconname);
Creates a new themed icon for iconname
.
Returns
a new GThemedIcon.
[transfer full][type GThemedIcon]
g_themed_icon_new_from_names ()
GIcon *
g_themed_icon_new_from_names (char **iconnames,
int len);
Creates a new themed icon for iconnames
.
Returns
a new GThemedIcon.
[transfer full][type GThemedIcon]
g_themed_icon_new_with_default_fallbacks ()
GIcon *
g_themed_icon_new_with_default_fallbacks
(const char *iconname);
Creates a new themed icon for iconname
, and all the names
that can be created by shortening iconname
at '-' characters.
In the following example, icon1
and icon2
are equivalent:
Returns
a new GThemedIcon.
[transfer full][type GThemedIcon]
g_themed_icon_prepend_name ()
void
g_themed_icon_prepend_name (GThemedIcon *icon,
const char *iconname);
Prepend a name to the list of icons from within icon
.
Note that doing so invalidates the hash computed by prior calls
to g_icon_hash().
Since: 2.18
g_themed_icon_append_name ()
void
g_themed_icon_append_name (GThemedIcon *icon,
const char *iconname);
Append a name to the list of icons from within icon
.
Note that doing so invalidates the hash computed by prior calls
to g_icon_hash().
g_themed_icon_get_names ()
const gchar * const *
g_themed_icon_get_names (GThemedIcon *icon);
Gets the names of icons from within icon
.
Returns
a list of icon names.
[transfer none]
Types and Values
GThemedIcon
typedef struct _GThemedIcon GThemedIcon;
An implementation of GIcon for themed icons.
Property Details
The “name” property
“name” gchar *
The icon name.
Owner: GThemedIcon
Flags: Write / Construct Only
Default value: NULL
The “names” property
“names” GStrv
A NULL-terminated array of icon names.
Owner: GThemedIcon
Flags: Read / Write / Construct Only
The “use-default-fallbacks” property
“use-default-fallbacks” gboolean
Whether to use the default fallbacks found by shortening the icon name
at '-' characters. If the "names" array has more than one element,
ignores any past the first.
For example, if the icon name was "gnome-dev-cdrom-audio", the array
would become
Owner: GThemedIcon
Flags: Read / Write / Construct Only
Default value: FALSE