src/libedataserver/e-categories.h

   1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
   2 /*
   3  * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
   4  *
   5  * This library is free software: you can redistribute it and/or modify it
   6  * under the terms of the GNU Lesser General Public License as published by
   7  * the Free Software Foundation.
   8  *
   9  * This library is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  11  * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
  12  * for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public License
  15  * along with this library. If not, see <http://www.gnu.org/licenses/>.
  16  *
  17  */
  18
  19 #if !defined (__LIBEDATASERVER_H_INSIDE__) && !defined (LIBEDATASERVER_COMPILATION)
  20 #error "Only <libedataserver/libedataserver.h> should be included directly."
  21 #endif
  22
  23 #ifndef E_CATEGORIES_H
  24 #define E_CATEGORIES_H
  25
  26 #include <glib-object.h>
  27
  28 G_BEGIN_DECLS
  29
  30 G_DEPRECATED_FOR (e_categories_dup_list)
  31 GList *         e_categories_get_list           (void);
  32
  33 GList *         e_categories_dup_list           (void);
  34
  35 /* 'unused' parameter was 'color', but it is deprecated now (see bug #308815) */
  36 void            e_categories_add                (const gchar *category,
  37                                                  const gchar *unused,
  38                                                  const gchar *icon_file,
  39                                                  gboolean searchable);
  40 void            e_categories_remove             (const gchar *category);
  41 gboolean        e_categories_exist              (const gchar *category);
  42 G_DEPRECATED_FOR (e_categories_dup_icon_file_for)
  43 const gchar *   e_categories_get_icon_file_for  (const gchar *category);
  44 gchar *         e_categories_dup_icon_file_for  (const gchar *category);
  45 void            e_categories_set_icon_file_for  (const gchar *category,
  46                                                  const gchar *icon_file);
  47 gboolean        e_categories_is_searchable      (const gchar *category);
  48
  49 void            e_categories_register_change_listener
  50                                                 (GCallback listener,
  51                                                  gpointer user_data);
  52 void            e_categories_unregister_change_listener
  53                                                 (GCallback listener,
  54                                                  gpointer user_data);
  55
  56 G_END_DECLS
  57
  58 #endif /* E_CATEGORIES_H */