src/api/na-gconf-utils.h

   1 /*
   2  * Nautilus-Actions
   3  * A Nautilus extension which offers configurable context menu actions.
   4  *
   5  * Copyright (C) 2005 The GNOME Foundation
   6  * Copyright (C) 2006, 2007, 2008 Frederic Ruaudel and others (see AUTHORS)
   7  * Copyright (C) 2009, 2010, 2011 Pierre Wieser and others (see AUTHORS)
   8  *
   9  * This Program is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU General Public License as
  11  * published by the Free Software Foundation; either version 2 of
  12  * the License, or (at your option) any later version.
  13  *
  14  * This Program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public
  20  * License along with this Library; see the file COPYING.  If not,
  21  * write to the Free Software Foundation, Inc., 59 Temple Place,
  22  * Suite 330, Boston, MA 02111-1307, USA.
  23  *
  24  * Authors:
  25  *   Frederic Ruaudel <grumz@grumz.net>
  26  *   Rodrigo Moya <rodrigo@gnome-db.org>
  27  *   Pierre Wieser <pwieser@trychlos.org>
  28  *   ... and many others (see AUTHORS)
  29  */
  30
  31 #ifndef __NAUTILUS_ACTIONS_API_NA_GCONF_UTILS_H__
  32 #define __NAUTILUS_ACTIONS_API_NA_GCONF_UTILS_H__
  33
  34 #ifndef NA_DISABLE_DEPRECATED
  35
  36 /**
  37  * SECTION: gconf-utils
  38  * @title: GConf Misc
  39  * @short_description: The GConf Library Utilities
  40  * @include: runtime/na-gconf-utils.h
  41  *
  42  * Starting with Nautilus-Actions 3.1.0, GConf, whether it is used as a
  43  * preference storage subsystem or as an I/O provider, is deprecated.
  44  */
  45
  46 #include <gconf/gconf-client.h>
  47
  48 G_BEGIN_DECLS
  49
  50 GSList  *na_gconf_utils_get_subdirs( GConfClient *gconf, const gchar *path );
  51 void     na_gconf_utils_free_subdirs( GSList *subdirs );
  52
  53 gboolean na_gconf_utils_has_entry  ( GSList *entries, const gchar *entry );
  54 GSList  *na_gconf_utils_get_entries( GConfClient *gconf, const gchar *path );
  55 gboolean na_gconf_utils_get_bool_from_entries       ( GSList *entries, const gchar *entry, gboolean *value );
  56 gboolean na_gconf_utils_get_string_from_entries     ( GSList *entries, const gchar *entry, gchar **value );
  57 gboolean na_gconf_utils_get_string_list_from_entries( GSList *entries, const gchar *entry, GSList **value );
  58 void     na_gconf_utils_dump_entries                ( GSList *entries );
  59 void     na_gconf_utils_free_entries                ( GSList *entries );
  60
  61 gboolean na_gconf_utils_read_bool        ( GConfClient *gconf, const gchar *path, gboolean use_schema, gboolean default_value );
  62 gint     na_gconf_utils_read_int         ( GConfClient *gconf, const gchar *path, gboolean use_schema, gint default_value );
  63 gchar   *na_gconf_utils_read_string      ( GConfClient *gconf, const gchar *path, gboolean use_schema, const gchar *default_value );
  64 GSList  *na_gconf_utils_read_string_list ( GConfClient *gconf, const gchar *path );
  65
  66 gboolean na_gconf_utils_write_bool       ( GConfClient *gconf, const gchar *path, gboolean value, gchar **message );
  67 gboolean na_gconf_utils_write_int        ( GConfClient *gconf, const gchar *path, gint value, gchar **message );
  68 gboolean na_gconf_utils_write_string     ( GConfClient *gconf, const gchar *path, const gchar *value, gchar **message );
  69 gboolean na_gconf_utils_write_string_list( GConfClient *gconf, const gchar *path, GSList *value, gchar **message );
  70
  71 gboolean na_gconf_utils_remove_entry     ( GConfClient *gconf, const gchar *path, gchar **message );
  72
  73 GSList  *na_gconf_utils_slist_from_string( const gchar *value );
  74 gchar   *na_gconf_utils_slist_to_string  ( GSList *slist );
  75
  76 G_END_DECLS
  77
  78 #endif /* NA_DISABLE_DEPRECATED */
  79 #endif /* __NAUTILUS_ACTIONS_API_NA_GCONF_UTILS_H__ */