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
   6  * modify it under the terms of version 2 of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17  * Boston, MA 02110-1301, USA.
  18  */
  19
  20 #if !defined (__LIBEDATASERVER_H_INSIDE__) && !defined (LIBEDATASERVER_COMPILATION)
  21 #error "Only <libedataserver/libedataserver.h> should be included directly."
  22 #endif
  23
  24 #ifndef E_CATEGORIES_H
  25 #define E_CATEGORIES_H
  26
  27 #include <glib-object.h>
  28
  29 G_BEGIN_DECLS
  30
  31 GList *         e_categories_get_list           (void);
  32
  33 /* 'unused' parameter was 'color', but it is deprecated now (see bug #308815) */
  34 void            e_categories_add                (const gchar *category,
  35                                                  const gchar *unused,
  36                                                  const gchar *icon_file,
  37                                                  gboolean searchable);
  38 void            e_categories_remove             (const gchar *category);
  39 gboolean        e_categories_exist              (const gchar *category);
  40 const gchar *   e_categories_get_icon_file_for  (const gchar *category);
  41 void            e_categories_set_icon_file_for  (const gchar *category,
  42                                                  const gchar *icon_file);
  43 gboolean        e_categories_is_searchable      (const gchar *category);
  44
  45 void            e_categories_register_change_listener
  46                                                 (GCallback listener,
  47                                                  gpointer user_data);
  48 void            e_categories_unregister_change_listener
  49                                                 (GCallback listener,
  50                                                  gpointer user_data);
  51
  52 G_END_DECLS
  53
  54 #endif /* E_CATEGORIES_H */