1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: Alexander Larsson <alexl@redhat.com>
27 #include "gthemedicon.h"
35 * @short_description: Icon theming support
37 * @see_also: #GIcon, #GLoadableIcon
39 * #GThemedIcon is an implementation of #GIcon that supports icon themes.
40 * #GThemedIcon contains a list of all of the icons present in an icon
41 * theme, so that icons can be looked up quickly. #GThemedIcon does
42 * not provide actual pixmaps for icons, just the icon names.
43 * Ideally something like gtk_icon_theme_choose_icon() should be used to
44 * resolve the list of names so that fallback icons work nicely with
45 * themes that inherit other themes.
48 static void g_themed_icon_icon_iface_init (GIconIface *iface);
52 GObject parent_instance;
55 gboolean use_default_fallbacks;
58 struct _GThemedIconClass
60 GObjectClass parent_class;
68 PROP_USE_DEFAULT_FALLBACKS
71 G_DEFINE_TYPE_WITH_CODE (GThemedIcon, g_themed_icon, G_TYPE_OBJECT,
72 G_IMPLEMENT_INTERFACE (G_TYPE_ICON,
73 g_themed_icon_icon_iface_init))
76 g_themed_icon_get_property (GObject *object,
81 GThemedIcon *icon = G_THEMED_ICON (object);
86 g_value_set_boxed (value, icon->names);
89 case PROP_USE_DEFAULT_FALLBACKS:
90 g_value_set_boolean (value, icon->use_default_fallbacks);
94 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
99 g_themed_icon_set_property (GObject *object,
104 GThemedIcon *icon = G_THEMED_ICON (object);
111 name = g_value_get_string (value);
117 g_strfreev (icon->names);
119 icon->names = g_new (char *, 2);
120 icon->names[0] = g_strdup (name);
121 icon->names[1] = NULL;
125 names = g_value_dup_boxed (value);
131 g_strfreev (icon->names);
136 case PROP_USE_DEFAULT_FALLBACKS:
137 icon->use_default_fallbacks = g_value_get_boolean (value);
141 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
146 g_themed_icon_constructed (GObject *object)
148 GThemedIcon *themed = G_THEMED_ICON (object);
150 g_return_if_fail (themed->names != NULL && themed->names[0] != NULL);
152 if (themed->use_default_fallbacks)
154 int i = 0, dashes = 0;
158 gboolean is_symbolic;
162 is_symbolic = g_str_has_suffix (themed->names[0], "-symbolic");
164 name = g_strndup (themed->names[0], strlen (themed->names[0]) - 9);
166 name = g_strdup (themed->names[0]);
178 g_strfreev (themed->names);
180 names = g_new (char *, dashes + 1 + 1);
183 while ((dashp = strrchr (last, '-')) != NULL)
184 names[i++] = last = g_strndup (last, dashp - last);
190 themed->names = g_new (char *, dashes + 1 + 1);
191 for (i = 0; names[i] != NULL; i++)
192 themed->names[i] = g_strconcat (names[i], "-symbolic", NULL);
194 themed->names[i] = NULL;
199 themed->names = names;
205 g_themed_icon_finalize (GObject *object)
209 themed = G_THEMED_ICON (object);
211 g_strfreev (themed->names);
213 G_OBJECT_CLASS (g_themed_icon_parent_class)->finalize (object);
217 g_themed_icon_class_init (GThemedIconClass *klass)
219 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
221 gobject_class->finalize = g_themed_icon_finalize;
222 gobject_class->constructed = g_themed_icon_constructed;
223 gobject_class->set_property = g_themed_icon_set_property;
224 gobject_class->get_property = g_themed_icon_get_property;
231 g_object_class_install_property (gobject_class, PROP_NAME,
232 g_param_spec_string ("name",
234 P_("The name of the icon"),
236 G_PARAM_CONSTRUCT_ONLY | G_PARAM_WRITABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
241 * A %NULL-terminated array of icon names.
243 g_object_class_install_property (gobject_class, PROP_NAMES,
244 g_param_spec_boxed ("names",
246 P_("An array containing the icon names"),
248 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
251 * GThemedIcon:use-default-fallbacks:
253 * Whether to use the default fallbacks found by shortening the icon name
254 * at '-' characters. If the "names" array has more than one element,
255 * ignores any past the first.
257 * For example, if the icon name was "gnome-dev-cdrom-audio", the array
261 * "gnome-dev-cdrom-audio",
269 g_object_class_install_property (gobject_class, PROP_USE_DEFAULT_FALLBACKS,
270 g_param_spec_boolean ("use-default-fallbacks",
271 P_("use default fallbacks"),
272 P_("Whether to use default fallbacks found by shortening the name at '-' characters. Ignores names after the first if multiple names are given."),
274 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
278 g_themed_icon_init (GThemedIcon *themed)
280 themed->names = NULL;
285 * @iconname: a string containing an icon name.
287 * Creates a new themed icon for @iconname.
289 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
292 g_themed_icon_new (const char *iconname)
294 g_return_val_if_fail (iconname != NULL, NULL);
296 return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, NULL));
300 * g_themed_icon_new_from_names:
301 * @iconnames: (array length=len): an array of strings containing icon names.
302 * @len: the length of the @iconnames array, or -1 if @iconnames is
305 * Creates a new themed icon for @iconnames.
307 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon
310 g_themed_icon_new_from_names (char **iconnames,
315 g_return_val_if_fail (iconnames != NULL, NULL);
322 names = g_new (char *, len + 1);
324 for (i = 0; i < len; i++)
325 names[i] = iconnames[i];
329 icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", names, NULL));
334 icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", iconnames, NULL));
340 * g_themed_icon_new_with_default_fallbacks:
341 * @iconname: a string containing an icon name
343 * Creates a new themed icon for @iconname, and all the names
344 * that can be created by shortening @iconname at '-' characters.
346 * In the following example, @icon1 and @icon2 are equivalent:
348 * const char *names[] = {
349 * "gnome-dev-cdrom-audio",
355 * icon1 = g_themed_icon_new_from_names (names, 4);
356 * icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
359 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
362 g_themed_icon_new_with_default_fallbacks (const char *iconname)
364 g_return_val_if_fail (iconname != NULL, NULL);
366 return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, "use-default-fallbacks", TRUE, NULL));
371 * g_themed_icon_get_names:
372 * @icon: a #GThemedIcon.
374 * Gets the names of icons from within @icon.
376 * Returns: (transfer none): a list of icon names.
379 g_themed_icon_get_names (GThemedIcon *icon)
381 g_return_val_if_fail (G_IS_THEMED_ICON (icon), NULL);
382 return (const char * const *)icon->names;
386 * g_themed_icon_append_name:
387 * @icon: a #GThemedIcon
388 * @iconname: name of icon to append to list of icons from within @icon.
390 * Append a name to the list of icons from within @icon.
393 * Note that doing so invalidates the hash computed by prior calls
398 g_themed_icon_append_name (GThemedIcon *icon,
399 const char *iconname)
403 g_return_if_fail (G_IS_THEMED_ICON (icon));
404 g_return_if_fail (iconname != NULL);
406 num_names = g_strv_length (icon->names);
407 icon->names = g_realloc (icon->names, sizeof (char*) * (num_names + 2));
408 icon->names[num_names] = g_strdup (iconname);
409 icon->names[num_names + 1] = NULL;
411 g_object_notify (G_OBJECT (icon), "names");
415 * g_themed_icon_prepend_name:
416 * @icon: a #GThemedIcon
417 * @iconname: name of icon to prepend to list of icons from within @icon.
419 * Prepend a name to the list of icons from within @icon.
422 * Note that doing so invalidates the hash computed by prior calls
429 g_themed_icon_prepend_name (GThemedIcon *icon,
430 const char *iconname)
436 g_return_if_fail (G_IS_THEMED_ICON (icon));
437 g_return_if_fail (iconname != NULL);
439 num_names = g_strv_length (icon->names);
440 names = g_new (char*, num_names + 2);
441 for (i = 0; icon->names[i]; i++)
442 names[i + 1] = icon->names[i];
443 names[0] = g_strdup (iconname);
444 names[num_names + 1] = NULL;
446 g_free (icon->names);
449 g_object_notify (G_OBJECT (icon), "names");
453 g_themed_icon_hash (GIcon *icon)
455 GThemedIcon *themed = G_THEMED_ICON (icon);
461 for (i = 0; themed->names[i] != NULL; i++)
462 hash ^= g_str_hash (themed->names[i]);
468 g_themed_icon_equal (GIcon *icon1,
471 GThemedIcon *themed1 = G_THEMED_ICON (icon1);
472 GThemedIcon *themed2 = G_THEMED_ICON (icon2);
475 for (i = 0; themed1->names[i] != NULL && themed2->names[i] != NULL; i++)
477 if (!g_str_equal (themed1->names[i], themed2->names[i]))
481 return themed1->names[i] == NULL && themed2->names[i] == NULL;
486 g_themed_icon_to_tokens (GIcon *icon,
490 GThemedIcon *themed_icon = G_THEMED_ICON (icon);
493 g_return_val_if_fail (out_version != NULL, FALSE);
497 for (n = 0; themed_icon->names[n] != NULL; n++)
498 g_ptr_array_add (tokens,
499 g_strdup (themed_icon->names[n]));
505 g_themed_icon_from_tokens (gchar **tokens,
514 g_return_val_if_fail (version == 0, NULL);
516 names = g_new0 (gchar *, num_tokens + 1);
517 for (n = 0; n < num_tokens; n++)
518 names[n] = tokens[n];
521 icon = g_themed_icon_new_from_names (names, num_tokens);
528 g_themed_icon_serialize (GIcon *icon)
530 GThemedIcon *themed_icon = G_THEMED_ICON (icon);
532 return g_variant_new ("(sv)", "themed", g_variant_new ("^as", themed_icon->names));
536 g_themed_icon_icon_iface_init (GIconIface *iface)
538 iface->hash = g_themed_icon_hash;
539 iface->equal = g_themed_icon_equal;
540 iface->to_tokens = g_themed_icon_to_tokens;
541 iface->from_tokens = g_themed_icon_from_tokens;
542 iface->serialize = g_themed_icon_serialize;