pintos-os.org Git - pspp/blob - src/ui/gui/psppire-selector.h

   1 /* PSPPIRE - a graphical user interface for PSPP.
   2    Copyright (C) 2007, 2010  Free Software Foundation
   3
   4    This program is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation, either version 3 of the License, or
   7    (at your option) any later version.
   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
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
  16
  17
  18 #ifndef __PSPPIRE_SELECTOR_H__
  19 #define __PSPPIRE_SELECTOR_H__
  20
  21
  22 #include <glib.h>
  23 #include <glib-object.h>
  24 #include <gtk/gtk.h>
  25
  26 G_BEGIN_DECLS
  27
  28 #define PSPPIRE_SELECTOR_TYPE            (psppire_selector_get_type ())
  29 #define PSPPIRE_SELECTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), PSPPIRE_SELECTOR_TYPE, PsppireSelector))
  30 #define PSPPIRE_SELECTOR_CLASS(class)    (G_TYPE_CHECK_CLASS_CAST ((class), \
  31     PSPPIRE_SELECTOR_TYPE, PsppireSelectorClass))
  32 #define PSPPIRE_IS_SELECTOR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
  33     PSPPIRE_SELECTOR_TYPE))
  34 #define PSPPIRE_IS_SELECTOR_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \
  35     PSPPIRE_SELECTOR_TYPE))
  36
  37
  38 typedef struct _PsppireSelector       PsppireSelector;
  39 typedef struct _PsppireSelectorClass  PsppireSelectorClass;
  40
  41
  42 /* Function for appending selected items to the destination widget */
  43 typedef void SelectItemsFunc (GtkTreeIter iter,
  44                               GtkWidget *dest,
  45                               GtkTreeModel *source_model,
  46                               gpointer data);
  47
  48 /* Function to determine if items may be selected */
  49 typedef gboolean AllowSelectionFunc (GtkWidget *src, GtkWidget *dest);
  50
  51
  52 /* Function to determine whether an item in MODEL, pointed to by ITER
  53    is currently selected.
  54
  55    Returns TRUE if the item is currently selected, FALSE otherwise.
  56  */
  57 typedef gboolean FilterItemsFunc (GtkTreeModel *model,
  58                                   GtkTreeIter *iter,
  59                                   PsppireSelector *selector);
  60
  61 enum psppire_selector_dir
  62   {
  63     PSPPIRE_SELECTOR_SOURCE_TO_DEST,
  64     PSPPIRE_SELECTOR_DEST_TO_SOURCE
  65   };
  66
  67
  68 struct _PsppireSelector
  69 {
  70   GtkButton parent;
  71
  72   /* <private> */
  73   GtkWidget *arrow;
  74
  75   gboolean dispose_has_run;
  76
  77   enum psppire_selector_dir direction;
  78
  79   GtkWidget *source;
  80   GtkWidget *dest;
  81
  82   /* A flag indicating that the object is in the process of
  83      updating its subjects.
  84      (not thread safe if two threads access the same object)
  85   */
  86   gboolean selecting;
  87
  88   gint orientation;
  89
  90   SelectItemsFunc *select_items;
  91   gpointer select_user_data;
  92
  93   FilterItemsFunc *filter;
  94
  95   AllowSelectionFunc *allow_selection;
  96
  97   gulong row_activate_id ;
  98   gulong source_select_id ;
  99
 100   gboolean primary_requested;
 101   GList *source_litem;
 102 };
 103
 104 struct _PsppireSelectorClass
 105 {
 106   GtkButtonClass parent_class;
 107
 108   /* This is a hash of Lists of FilterItemsFunc pointers, keyed by address of
 109      the source widget */
 110   GHashTable *source_hash;
 111
 112   /* A hash of SelectItemFuncs indexed by GType */
 113   GHashTable *default_selection_funcs;
 114 };
 115
 116 GType      psppire_selector_get_type        (void);
 117 GtkWidget* psppire_selector_new             (void);
 118
 119
 120 /* Set FILTER_FUNC for this selector */
 121 void psppire_selector_set_filter_func (PsppireSelector *selector,
 122                                        FilterItemsFunc *filter_func);
 123
 124 /* Set SELECT_FUNC for this selector */
 125 void psppire_selector_set_select_func (PsppireSelector *selector,
 126                                        SelectItemsFunc *select_func,
 127                                        gpointer user_data);
 128
 129 /* Force the selector to update its dest and source widgets */
 130 void psppire_selector_update_subjects (PsppireSelector *selector);
 131
 132
 133 void psppire_selector_set_allow (PsppireSelector *, AllowSelectionFunc *);
 134
 135
 136 GType psppire_selector_orientation_get_type (void) G_GNUC_CONST;
 137
 138
 139 typedef enum {
 140   PSPPIRE_SELECT_SOURCE_BEFORE_DEST,
 141   PSPPIRE_SELECT_SOURCE_AFTER_DEST,
 142   PSPPIRE_SELECT_SOURCE_ABOVE_DEST,
 143   PSPPIRE_SELECT_SOURCE_BELOW_DEST
 144 } PsppireSelectorOrientation;
 145
 146 #define PSPPIRE_TYPE_SELECTOR_ORIENTATION \
 147   (psppire_selector_orientation_get_type())
 148
 149
 150 void psppire_selector_set_default_selection_func (GType type, SelectItemsFunc *);
 151
 152
 153 G_END_DECLS
 154
 155 #endif /* __PSPPIRE_SELECTOR_H__ */