diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index aa136151f..b28d39c9c 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2008-07-28 Matthias Clasen + + * gio/gio-sections.txt: + * gio/gio-docs.xml: Add GEmblemedIcon + 2008-07-21 Matthias Clasen * === Released 2.17.4 === diff --git a/docs/reference/gio/gio-docs.xml b/docs/reference/gio/gio-docs.xml index a9b727986..3a5af391f 100644 --- a/docs/reference/gio/gio-docs.xml +++ b/docs/reference/gio/gio-docs.xml @@ -83,6 +83,7 @@ + Utilities diff --git a/docs/reference/gio/gio-sections.txt b/docs/reference/gio/gio-sections.txt index 2306731ce..60b7d01c5 100644 --- a/docs/reference/gio/gio-sections.txt +++ b/docs/reference/gio/gio-sections.txt @@ -416,6 +416,17 @@ G_FILE_ICON_GET_CLASS g_file_icon_get_type +
+gemblemedicon +GEmblemedIcon +GEmblemedIcon +g_emblemed_icon_new +g_emblemed_icon_get_icon +g_emblemed_icon_get_emblem + +g_emblemed_icon_get_type +
+
ginputstream GInputStream diff --git a/gio/Makefile.am b/gio/Makefile.am index c992a1e59..37a0b6af9 100644 --- a/gio/Makefile.am +++ b/gio/Makefile.am @@ -174,6 +174,8 @@ libgio_2_0_la_SOURCES = \ gdrive.c \ gdummyfile.h \ gdummyfile.c \ + gemblemedicon.h \ + gemblemedicon.c \ gfile.c \ gfileattribute.c \ gfileattribute-priv.h \ diff --git a/gio/gemblemedicon.c b/gio/gemblemedicon.c new file mode 100644 index 000000000..768e19372 --- /dev/null +++ b/gio/gemblemedicon.c @@ -0,0 +1,187 @@ +/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ + +/* GIO - GLib Input, Output and Streaming Library + * + * Copyright (C) 2006-2007 Red Hat, Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General + * Public License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place, Suite 330, + * Boston, MA 02111-1307, USA. + * + * Author: Matthias Clasen + */ + +#include + +#include + +#include "gemblemedicon.h" +#include "glibintl.h" + +#include "gioalias.h" + +/** + * SECTION:gemblemedicon + * @short_description: Icon with emblems + * @include: gio/gio.h + * @see_also: #GIcon, #GLoadableIcon, #GThemedIcon + * + * #GEmblemedIcon is an implementation of #GIcon that supports + * adding an emblem to an icon. To add multiple emblems to an + * icon, you can create nested #GemblemedIcons. + * + * Note that #GEmblemedIcon allows no control over the position + * of the emblems. It is up to the rendering code to pick a position. + **/ + +static void g_emblemed_icon_icon_iface_init (GIconIface *iface); + +struct _GEmblemedIcon +{ + GObject parent_instance; + + GIcon *icon; + GIcon *emblem; +}; + +struct _GEmblemedIconClass +{ + GObjectClass parent_class; +}; + +G_DEFINE_TYPE_WITH_CODE (GEmblemedIcon, g_emblemed_icon, G_TYPE_OBJECT, + G_IMPLEMENT_INTERFACE (G_TYPE_ICON, + g_emblemed_icon_icon_iface_init)) + + +static void +g_emblemed_icon_finalize (GObject *object) +{ + GEmblemedIcon *emblemed; + + emblemed = G_EMBLEMED_ICON (object); + + g_object_unref (emblemed->icon); + g_object_unref (emblemed->emblem); + + (*G_OBJECT_CLASS (g_emblemed_icon_parent_class)->finalize) (object); +} + +static void +g_emblemed_icon_class_init (GEmblemedIconClass *klass) +{ + GObjectClass *gobject_class = G_OBJECT_CLASS (klass); + gobject_class->finalize = g_emblemed_icon_finalize; +} + +static void +g_emblemed_icon_init (GEmblemedIcon *emblemed) +{ +} + +/** + * g_emblemed_icon_new: + * @icon: a #GIcon. + * @emblem: a #GIcon + * + * Creates a new emblemed icon for @icon with emblem @emblem. + * + * Returns: a new #GEmblemedIcon. + * + * Since: 2.18 + **/ +GIcon * +g_emblemed_icon_new (GIcon *icon, + GIcon *emblem) +{ + GEmblemedIcon *emblemed; + + g_return_val_if_fail (icon != NULL, NULL); + g_return_val_if_fail (emblem != NULL, NULL); + + emblemed = G_EMBLEMED_ICON (g_object_new (G_TYPE_EMBLEMED_ICON, NULL)); + emblemed->icon = g_object_ref (icon); + emblemed->emblem = g_object_ref (emblem); + + return G_ICON (emblemed); +} + +/** + * g_emblemed_icon_get_icon: + * @icon: a #GEmblemedIcon. + * + * Gets the main icon for @icon. + * + * Returns: a #GIcon that is owend by @icon + * + * Since: 2.18 + **/ +GIcon * +g_emblemed_icon_get_icon (GEmblemedIcon *icon) +{ + g_return_val_if_fail (G_IS_EMBLEMED_ICON (icon), NULL); + + return icon->icon; +} + +/** + * g_emblemed_icon_get_emblem: + * @icon: a #GEmblemedIcon. + * + * Gets the emblem for @icon. + * + * Returns: a #GIcon that is owned by @icon + * + * Since: 2.18 + **/ +GIcon * +g_emblemed_icon_get_emblem (GEmblemedIcon *icon) +{ + g_return_val_if_fail (G_IS_EMBLEMED_ICON (icon), NULL); + + return icon->emblem; +} + +static guint +g_emblemed_icon_hash (GIcon *icon) +{ + GEmblemedIcon *emblemed = G_EMBLEMED_ICON (icon); + guint hash; + + hash = g_icon_hash (emblemed->icon); + hash ^= g_icon_hash (emblemed->emblem); + + return hash; +} + +static gboolean +g_emblemed_icon_equal (GIcon *icon1, + GIcon *icon2) +{ + GEmblemedIcon *emblemed1 = G_EMBLEMED_ICON (icon1); + GEmblemedIcon *emblemed2 = G_EMBLEMED_ICON (icon2); + + return g_icon_equal (emblemed1->icon, emblemed2->icon) && + g_icon_equal (emblemed1->emblem, emblemed2->emblem); +} + +static void +g_emblemed_icon_icon_iface_init (GIconIface *iface) +{ + iface->hash = g_emblemed_icon_hash; + iface->equal = g_emblemed_icon_equal; +} + +#define __G_EMBLEMED_ICON_C__ +#include "gioaliasdef.c" diff --git a/gio/gemblemedicon.h b/gio/gemblemedicon.h new file mode 100644 index 000000000..3da12123f --- /dev/null +++ b/gio/gemblemedicon.h @@ -0,0 +1,59 @@ +/* Gio - GLib Input, Output and Streaming Library + * + * Copyright (C) 2006-2007 Red Hat, Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General + * Public License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place, Suite 330, + * Boston, MA 02111-1307, USA. + * + * Author: Matthias Clasen + */ + +#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) +#error "Only can be included directly." +#endif + +#ifndef __G_EMBLEMED_ICON_H__ +#define __G_EMBLEMED_ICON_H__ + +#include + +G_BEGIN_DECLS + +#define G_TYPE_EMBLEMED_ICON (g_emblemed_icon_get_type ()) +#define G_EMBLEMED_ICON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_EMBLEMED_ICON, GEmblemedIcon)) +#define G_EMBLEMED_ICON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_EMBLEMED_ICON, GEmblemedIconClass)) +#define G_IS_EMBLEMED_ICON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_EMBLEMED_ICON)) +#define G_IS_EMBLEMED_ICON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_EMBLEMED_ICON)) +#define G_EMBLEMED_ICON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_EMBLEMED_ICON, GEmblemedIconClass)) + +/** + * GEmblemedIcon: + * + * An implementation of #GIcon for icons with emblems. + **/ +typedef struct _GEmblemedIcon GEmblemedIcon; +typedef struct _GEmblemedIconClass GEmblemedIconClass; + +GType g_emblemed_icon_get_type (void) G_GNUC_CONST; + +GIcon *g_emblemed_icon_new (GIcon *icon, + GIcon *emblem); +GIcon *g_emblemed_icon_get_icon (GEmblemedIcon *icon); +GIcon *g_emblemed_icon_get_emblem (GEmblemedIcon *icon); + + +G_END_DECLS + +#endif /* __G_EMBLEMED_ICON_H__ */ diff --git a/gio/gio.h b/gio/gio.h index bc2daee50..31fb2b28c 100644 --- a/gio/gio.h +++ b/gio/gio.h @@ -36,6 +36,7 @@ #include #include #include +#include #include #include #include diff --git a/gio/gio.symbols b/gio/gio.symbols index 445d8bc4c..ebb76f374 100644 --- a/gio/gio.symbols +++ b/gio/gio.symbols @@ -804,3 +804,13 @@ g_ask_password_flags_get_type G_GNUC_CONST g_password_save_get_type G_GNUC_CONST #endif #endif + + +#if IN_HEADER(__G_EMBLEMED_ICON_H__) +#if IN_FILE(__G_EMBLEMED_ICON_C__) +g_emblemed_icon_get_type G_GNUC_CONST +g_emblemed_icon_new +g_emblemed_icon_get_icon +g_emblemed_icon_get_emblem +#endif +#endif