src/stash.h

   1 /*
   2  *      stash.h - this file is part of Geany, a fast and lightweight IDE
   3  *
   4  *      Copyright 2008 The Geany contributors
   5  *
   6  *      This program is free software; you can redistribute it and/or modify
   7  *      it under the terms of the GNU General Public License as published by
   8  *      the Free Software Foundation; either version 2 of the License, or
   9  *      (at your option) any later version.
  10  *
  11  *      This program is distributed in the hope that it will be useful,
  12  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *      GNU General Public License for more details.
  15  *
  16  *      You should have received a copy of the GNU General Public License along
  17  *      with this program; if not, write to the Free Software Foundation, Inc.,
  18  *      51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19  */
  20
  21 #ifndef GEANY_STASH_H
  22 #define GEANY_STASH_H 1
  23
  24 #include "gtkcompat.h"
  25
  26 G_BEGIN_DECLS
  27
  28 /** Opaque type for a group of settings. */
  29 typedef struct StashGroup StashGroup;
  30
  31 /** Can be @c GtkWidget* or @c gchar* depending on whether the @a owner argument is used for
  32  * stash_group_display() and stash_group_update(). */
  33 typedef gconstpointer StashWidgetID;
  34
  35 GType stash_group_get_type(void);
  36
  37 StashGroup *stash_group_new(const gchar *name);
  38
  39 void stash_group_add_boolean(StashGroup *group, gboolean *setting,
  40                 const gchar *key_name, gboolean default_value);
  41
  42 void stash_group_add_double(StashGroup *group, gdouble *setting,
  43                 const gchar *key_name, gdouble default_value);
  44
  45 void stash_group_add_integer(StashGroup *group, gint *setting,
  46                 const gchar *key_name, gint default_value);
  47
  48 void stash_group_add_string(StashGroup *group, gchar **setting,
  49                 const gchar *key_name, const gchar *default_value);
  50
  51 void stash_group_add_string_vector(StashGroup *group, gchar ***setting,
  52                 const gchar *key_name, const gchar **default_value);
  53
  54 void stash_group_load_from_key_file(StashGroup *group, GKeyFile *keyfile);
  55
  56 void stash_group_save_to_key_file(StashGroup *group, GKeyFile *keyfile);
  57
  58 void stash_group_free(StashGroup *group);
  59
  60 gboolean stash_group_load_from_file(StashGroup *group, const gchar *filename);
  61
  62 gint stash_group_save_to_file(StashGroup *group, const gchar *filename,
  63                 GKeyFileFlags flags);
  64
  65 /* *** GTK-related functions *** */
  66
  67 void stash_group_add_toggle_button(StashGroup *group, gboolean *setting,
  68                 const gchar *key_name, gboolean default_value, StashWidgetID widget_id);
  69
  70 void stash_group_add_radio_buttons(StashGroup *group, gint *setting,
  71                 const gchar *key_name, gint default_value,
  72                 StashWidgetID widget_id, gint enum_id, ...) G_GNUC_NULL_TERMINATED;
  73
  74 void stash_group_add_spin_button_integer(StashGroup *group, gint *setting,
  75                 const gchar *key_name, gint default_value, StashWidgetID widget_id);
  76
  77 void stash_group_add_combo_box(StashGroup *group, gint *setting,
  78                 const gchar *key_name, gint default_value, StashWidgetID widget_id);
  79
  80 void stash_group_add_combo_box_entry(StashGroup *group, gchar **setting,
  81                 const gchar *key_name, const gchar *default_value, StashWidgetID widget_id);
  82
  83 void stash_group_add_entry(StashGroup *group, gchar **setting,
  84                 const gchar *key_name, const gchar *default_value, StashWidgetID widget_id);
  85
  86 void stash_group_add_widget_property(StashGroup *group, gpointer setting,
  87                 const gchar *key_name, gpointer default_value, StashWidgetID widget_id,
  88                 const gchar *property_name, GType type);
  89
  90 void stash_group_display(StashGroup *group, GtkWidget *owner);
  91
  92 void stash_group_update(StashGroup *group, GtkWidget *owner);
  93
  94 void stash_group_free_settings(StashGroup *group);
  95
  96
  97 #ifdef GEANY_PRIVATE
  98
  99 void stash_group_set_various(StashGroup *group, gboolean various,
 100         const gchar *prefix);
 101
 102 void stash_group_set_use_defaults(StashGroup *group, gboolean use_defaults);
 103
 104 /* *** GTK-related functions *** */
 105
 106 void stash_tree_setup(GPtrArray *group_array, GtkTreeView *tree);
 107
 108 void stash_tree_display(GtkTreeView *tree);
 109
 110 void stash_tree_update(GtkTreeView *tree);
 111
 112 #endif /* GEANY_PRIVATE */
 113
 114 G_END_DECLS
 115
 116 #endif /* GEANY_STASH_H */