1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
3 /* GIO - GLib Input, Output and Streaming Library
5 * Copyright (C) 2006-2007 Red Hat, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General
18 * Public License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20 * Boston, MA 02111-1307, USA.
22 * Author: Matthias Clasen <mclasen@redhat.com>
23 * Clemens N. Buss <cebuzz@gmail.com>
30 #include "gemblemedicon.h"
37 * SECTION:gemblemedicon
38 * @short_description: Icon with emblems
40 * @see_also: #GIcon, #GLoadableIcon, #GThemedIcon, #GEmblem
42 * #GEmblemedIcon is an implementation of #GIcon that supports
43 * adding an emblem to an icon. Adding multiple emblems to an
44 * icon is ensured via g_emblemed_icon_add_emblem().
46 * Note that #GEmblemedIcon allows no control over the position
47 * of the emblems. See also #GEmblem for more information.
50 static void g_emblemed_icon_icon_iface_init (GIconIface
*iface
);
54 GObject parent_instance
;
60 struct _GEmblemedIconClass
62 GObjectClass parent_class
;
65 G_DEFINE_TYPE_WITH_CODE (GEmblemedIcon
, g_emblemed_icon
, G_TYPE_OBJECT
,
66 G_IMPLEMENT_INTERFACE (G_TYPE_ICON
,
67 g_emblemed_icon_icon_iface_init
))
71 g_emblemed_icon_finalize (GObject
*object
)
73 GEmblemedIcon
*emblemed
;
75 emblemed
= G_EMBLEMED_ICON (object
);
77 g_object_unref (emblemed
->icon
);
78 g_list_foreach (emblemed
->emblems
, (GFunc
) g_object_unref
, NULL
);
79 g_list_free (emblemed
->emblems
);
81 (*G_OBJECT_CLASS (g_emblemed_icon_parent_class
)->finalize
) (object
);
85 g_emblemed_icon_class_init (GEmblemedIconClass
*klass
)
87 GObjectClass
*gobject_class
= G_OBJECT_CLASS (klass
);
88 gobject_class
->finalize
= g_emblemed_icon_finalize
;
92 g_emblemed_icon_init (GEmblemedIcon
*emblemed
)
97 * g_emblemed_icon_new:
101 * Creates a new emblemed icon for @icon with the emblem @emblem.
103 * Returns: a new #GIcon
108 g_emblemed_icon_new (GIcon
*icon
,
111 GEmblemedIcon
*emblemed
;
113 g_return_val_if_fail (G_IS_ICON (icon
), NULL
);
114 g_return_val_if_fail (!G_IS_EMBLEM (icon
), NULL
);
115 g_return_val_if_fail (G_IS_EMBLEM (emblem
), NULL
);
117 emblemed
= G_EMBLEMED_ICON (g_object_new (G_TYPE_EMBLEMED_ICON
, NULL
));
118 emblemed
->icon
= g_object_ref (icon
);
120 g_emblemed_icon_add_emblem (emblemed
, emblem
);
122 return G_ICON (emblemed
);
127 * g_emblemed_icon_get_icon:
128 * @emblemed: a #GEmblemedIcon
130 * Gets the main icon for @emblemed.
132 * Returns: a #GIcon that is owned by @emblemed
137 g_emblemed_icon_get_icon (GEmblemedIcon
*emblemed
)
139 g_return_val_if_fail (G_IS_EMBLEMED_ICON (emblemed
), NULL
);
141 return emblemed
->icon
;
145 * g_emblemed_icon_get_emblems:
146 * @emblemed: a #GEmblemedIcon
148 * Gets the list of emblems for the @icon.
150 * Returns: a #GList of #GEmblem <!-- -->s that is owned by @emblemed
156 g_emblemed_icon_get_emblems (GEmblemedIcon
*emblemed
)
158 g_return_val_if_fail (G_IS_EMBLEMED_ICON (emblemed
), NULL
);
160 return emblemed
->emblems
;
165 * g_emblemed_icon_add_emblem:
166 * @emblemed: a #GEmblemedIcon
167 * @emblem: a #GEmblem
169 * Adds @emblem to the #GList of #GEmblem <!-- -->s.
174 g_emblemed_icon_add_emblem (GEmblemedIcon
*emblemed
,
177 g_return_if_fail (G_IS_EMBLEMED_ICON (emblemed
));
178 g_return_if_fail (G_IS_EMBLEM (emblem
));
180 g_object_ref (emblem
);
181 emblemed
->emblems
= g_list_append (emblemed
->emblems
, emblem
);
185 g_emblemed_icon_hash (GIcon
*icon
)
187 GEmblemedIcon
*emblemed
= G_EMBLEMED_ICON (icon
);
189 guint hash
= g_icon_hash (emblemed
->icon
);
191 for (list
= emblemed
->emblems
; list
!= NULL
; list
= list
->next
)
192 hash
^= g_icon_hash (G_ICON (list
->data
));
198 g_emblem_comp (GEmblem
*a
,
201 guint hash_a
= g_icon_hash (G_ICON (a
));
202 guint hash_b
= g_icon_hash (G_ICON (b
));
214 g_emblemed_icon_equal (GIcon
*icon1
,
217 GEmblemedIcon
*emblemed1
= G_EMBLEMED_ICON (icon1
);
218 GEmblemedIcon
*emblemed2
= G_EMBLEMED_ICON (icon2
);
219 GList
*list1
, *list2
;
221 if (!g_icon_equal (emblemed1
->icon
, emblemed2
->icon
))
224 list1
= emblemed1
->emblems
;
225 list2
= emblemed2
->emblems
;
227 list1
= g_list_sort (list1
, (GCompareFunc
) g_emblem_comp
);
228 list2
= g_list_sort (list2
, (GCompareFunc
) g_emblem_comp
);
230 while (list1
&& list2
)
232 if (!g_icon_equal (G_ICON (list1
->data
), G_ICON (list2
->data
)))
239 return list1
== NULL
&& list2
== NULL
;
243 g_emblemed_icon_to_tokens (GIcon
*icon
,
247 GEmblemedIcon
*emblemed_icon
= G_EMBLEMED_ICON (icon
);
251 /* GEmblemedIcons are encoded as
253 * <encoded_icon> [<encoded_emblem_icon>]*
256 g_return_val_if_fail (out_version
!= NULL
, FALSE
);
260 s
= g_icon_to_string (emblemed_icon
->icon
);
264 g_ptr_array_add (tokens
, s
);
266 for (l
= emblemed_icon
->emblems
; l
!= NULL
; l
= l
->next
)
268 GIcon
*emblem_icon
= G_ICON (l
->data
);
270 s
= g_icon_to_string (emblem_icon
);
274 g_ptr_array_add (tokens
, s
);
281 g_emblemed_icon_from_tokens (gchar
**tokens
,
286 GEmblemedIcon
*emblemed_icon
;
289 emblemed_icon
= NULL
;
295 G_IO_ERROR_INVALID_ARGUMENT
,
296 _("Can't handle version %d of GEmblemedIcon encoding"),
305 G_IO_ERROR_INVALID_ARGUMENT
,
306 _("Malformed number of tokens (%d) in GEmblemedIcon encoding"),
311 emblemed_icon
= g_object_new (G_TYPE_EMBLEMED_ICON
, NULL
);
312 emblemed_icon
->icon
= g_icon_new_for_string (tokens
[0], error
);
313 if (emblemed_icon
->icon
== NULL
)
316 for (n
= 1; n
< num_tokens
; n
++)
320 emblem
= g_icon_new_for_string (tokens
[n
], error
);
324 if (!G_IS_EMBLEM (emblem
))
326 g_set_error_literal (error
,
328 G_IO_ERROR_INVALID_ARGUMENT
,
329 _("Expected a GEmblem for GEmblemedIcon"));
330 g_object_unref (emblem
);
334 emblemed_icon
->emblems
= g_list_append (emblemed_icon
->emblems
, emblem
);
337 return G_ICON (emblemed_icon
);
340 if (emblemed_icon
!= NULL
)
341 g_object_unref (emblemed_icon
);
346 g_emblemed_icon_icon_iface_init (GIconIface
*iface
)
348 iface
->hash
= g_emblemed_icon_hash
;
349 iface
->equal
= g_emblemed_icon_equal
;
350 iface
->to_tokens
= g_emblemed_icon_to_tokens
;
351 iface
->from_tokens
= g_emblemed_icon_from_tokens
;
354 #define __G_EMBLEMED_ICON_C__
355 #include "gioaliasdef.c"