Pileus Git - ~andy/gtk/blob - gtk/gtkfilechooserutils.c

   1 /* GTK - The GIMP Toolkit
   2  * gtkfilechooserutils.c: Private utility functions useful for
   3  *                        implementing a GtkFileChooser interface
   4  * Copyright (C) 2003, Red Hat, Inc.
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library 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 GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  */
  21
  22 #include "gtkfilechooserutils.h"
  23 #include "gtkfilechooser.h"
  24 #include "gtkfilechooserenums.h"
  25 #include "gtkfilesystem.h"
  26
  27 static void           delegate_set_current_folder     (GtkFileChooser    *chooser,
  28                                                        const GtkFilePath *path);
  29 static GtkFilePath *  delegate_get_current_folder     (GtkFileChooser    *chooser);
  30 static void           delegate_set_current_name       (GtkFileChooser    *chooser,
  31                                                        const gchar       *name);
  32 static void           delegate_select_path            (GtkFileChooser    *chooser,
  33                                                        const GtkFilePath *path);
  34 static void           delegate_unselect_path          (GtkFileChooser    *chooser,
  35                                                        const GtkFilePath *path);
  36 static void           delegate_select_all             (GtkFileChooser    *chooser);
  37 static void           delegate_unselect_all           (GtkFileChooser    *chooser);
  38 static GSList *       delegate_get_paths              (GtkFileChooser    *chooser);
  39 static GtkFilePath *  delegate_get_preview_path       (GtkFileChooser    *chooser);
  40 static GtkFileSystem *delegate_get_file_system        (GtkFileChooser    *chooser);
  41 static void           delegate_add_filter             (GtkFileChooser    *chooser,
  42                                                        GtkFileFilter     *filter);
  43 static void           delegate_remove_filter          (GtkFileChooser    *chooser,
  44                                                        GtkFileFilter     *filter);
  45 static GSList *       delegate_list_filters           (GtkFileChooser    *chooser);
  46 static void           delegate_notify                 (GObject           *object,
  47                                                        GParamSpec        *pspec,
  48                                                        gpointer           data);
  49 static void           delegate_current_folder_changed (GtkFileChooser    *chooser,
  50                                                        gpointer           data);
  51 static void           delegate_selection_changed      (GtkFileChooser    *chooser,
  52                                                        gpointer           data);
  53 static void           delegate_update_preview         (GtkFileChooser    *chooser,
  54                                                        gpointer           data);
  55
  56 /**
  57  * _gtk_file_chooser_install_properties:
  58  * @klass: the class structure for a type deriving from #GObject
  59  *
  60  * Installs the necessary properties for a class implementing
  61  * #GtkFileChooser. A #GtkParamSpecOverride property is installed
  62  * for each property, using the values from the #GtkFileChooserProp
  63  * enumeration. The caller must make sure itself that the enumeration
  64  * values don't collide with some other property values they
  65  * are using.
  66  **/
  67 void
  68 _gtk_file_chooser_install_properties (GObjectClass *klass)
  69 {
  70   g_object_class_override_property (klass,
  71                                     GTK_FILE_CHOOSER_PROP_ACTION,
  72                                     "action");
  73   g_object_class_override_property (klass,
  74                                     GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
  75                                     "extra-widget");
  76   g_object_class_override_property (klass,
  77                                     GTK_FILE_CHOOSER_PROP_FILE_SYSTEM,
  78                                     "file-system");
  79   g_object_class_override_property (klass,
  80                                     GTK_FILE_CHOOSER_PROP_FILTER,
  81                                     "filter");
  82   g_object_class_override_property (klass,
  83                                     GTK_FILE_CHOOSER_PROP_FOLDER_MODE,
  84                                     "folder-mode");
  85   g_object_class_override_property (klass,
  86                                     GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
  87                                     "local-only");
  88   g_object_class_override_property (klass,
  89                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET,
  90                                     "preview-widget");
  91   g_object_class_override_property (klass,
  92                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET_ACTIVE,
  93                                     "preview-widget-active");
  94   g_object_class_override_property (klass,
  95                                     GTK_FILE_CHOOSER_PROP_SELECT_MULTIPLE,
  96                                     "select-multiple");
  97   g_object_class_override_property (klass,
  98                                     GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
  99                                     "show-hidden");
 100 }
 101
 102 /**
 103  * _gtk_file_chooser_delegate_iface_init:
 104  * @iface: a #GtkFileChoserIface structure
 105  *
 106  * An interface-initialization function for use in cases where
 107  * an object is simply delegating the methods, signals of
 108  * the #GtkFileChooser interface to another object.
 109  * _gtk_file_chooser_set_delegate() must be called on each
 110  * instance of the object so that the delegate object can
 111  * be found.
 112  **/
 113 void
 114 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
 115 {
 116   iface->set_current_folder = delegate_set_current_folder;
 117   iface->get_current_folder = delegate_get_current_folder;
 118   iface->set_current_name = delegate_set_current_name;
 119   iface->select_path = delegate_select_path;
 120   iface->unselect_path = delegate_unselect_path;
 121   iface->select_all = delegate_select_all;
 122   iface->unselect_all = delegate_unselect_all;
 123   iface->get_paths = delegate_get_paths;
 124   iface->get_preview_path = delegate_get_preview_path;
 125   iface->get_file_system = delegate_get_file_system;
 126   iface->add_filter = delegate_add_filter;
 127   iface->remove_filter = delegate_remove_filter;
 128   iface->list_filters = delegate_list_filters;
 129 }
 130
 131 /**
 132  * _gtk_file_chooser_set_delegate:
 133  * @receiver: a GOobject implementing #GtkFileChooser
 134  * @delegate: another GObject implementing #GtkFileChooser
 135  *
 136  * Establishes that calls on @receiver for #GtkFileChooser
 137  * methods should be delegated to @delegate, and that
 138  * #GtkFileChooser signals emitted on @delegate should be
 139  * forwarded to @receiver. Must be used in confunction with
 140  * _gtk_file_chooser_delegate_iface_init().
 141  **/
 142 void
 143 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
 144                                 GtkFileChooser *delegate)
 145 {
 146   g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
 147   g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
 148
 149   g_object_set_data (G_OBJECT (receiver), "gtk-file-chooser-delegate", delegate);
 150
 151   g_signal_connect (delegate, "notify",
 152                     G_CALLBACK (delegate_notify), receiver);
 153   g_signal_connect (delegate, "current-folder-changed",
 154                     G_CALLBACK (delegate_current_folder_changed), receiver);
 155   g_signal_connect (delegate, "selection-changed",
 156                     G_CALLBACK (delegate_selection_changed), receiver);
 157   g_signal_connect (delegate, "update-preview",
 158                     G_CALLBACK (delegate_update_preview), receiver);
 159 }
 160
 161 static GtkFileChooser *
 162 get_delegate (GtkFileChooser *receiver)
 163 {
 164   return g_object_get_data (G_OBJECT (receiver), "gtk-file-chooser-delegate");
 165 }
 166
 167 static void
 168 delegate_select_path (GtkFileChooser    *chooser,
 169                       const GtkFilePath *path)
 170 {
 171   _gtk_file_chooser_select_path (get_delegate (chooser), path);
 172 }
 173
 174 static void
 175 delegate_unselect_path (GtkFileChooser    *chooser,
 176                         const GtkFilePath *path)
 177 {
 178   _gtk_file_chooser_unselect_path (get_delegate (chooser), path);
 179 }
 180
 181 static void
 182 delegate_select_all (GtkFileChooser *chooser)
 183 {
 184   gtk_file_chooser_select_all (get_delegate (chooser));
 185 }
 186
 187 static void
 188 delegate_unselect_all (GtkFileChooser *chooser)
 189 {
 190   gtk_file_chooser_unselect_all (get_delegate (chooser));
 191 }
 192
 193 static GSList *
 194 delegate_get_paths (GtkFileChooser *chooser)
 195 {
 196   return _gtk_file_chooser_get_paths (get_delegate (chooser));
 197 }
 198
 199 static GtkFilePath *
 200 delegate_get_preview_path (GtkFileChooser *chooser)
 201 {
 202   return _gtk_file_chooser_get_preview_path (get_delegate (chooser));
 203 }
 204
 205 static GtkFileSystem *
 206 delegate_get_file_system (GtkFileChooser *chooser)
 207 {
 208   return _gtk_file_chooser_get_file_system (get_delegate (chooser));
 209 }
 210
 211 static void
 212 delegate_add_filter (GtkFileChooser *chooser,
 213                      GtkFileFilter  *filter)
 214 {
 215   gtk_file_chooser_add_filter (get_delegate (chooser), filter);
 216 }
 217
 218 static void
 219 delegate_remove_filter (GtkFileChooser *chooser,
 220                         GtkFileFilter  *filter)
 221 {
 222   gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
 223 }
 224
 225 static GSList *
 226 delegate_list_filters (GtkFileChooser *chooser)
 227 {
 228   return gtk_file_chooser_list_filters (get_delegate (chooser));
 229 }
 230
 231 static void
 232 delegate_set_current_folder (GtkFileChooser    *chooser,
 233                              const GtkFilePath *path)
 234 {
 235   _gtk_file_chooser_set_current_folder_path (chooser, path);
 236 }
 237
 238 static GtkFilePath *
 239 delegate_get_current_folder (GtkFileChooser *chooser)
 240 {
 241   return _gtk_file_chooser_get_current_folder_path (get_delegate (chooser));
 242 }
 243
 244 static void
 245 delegate_set_current_name (GtkFileChooser *chooser,
 246                            const gchar    *name)
 247 {
 248   gtk_file_chooser_set_current_name (get_delegate (chooser), name);
 249 }
 250
 251 static void
 252 delegate_notify (GObject    *object,
 253                  GParamSpec *pspec,
 254                  gpointer    data)
 255 {
 256   if (pspec->param_id >= GTK_FILE_CHOOSER_PROP_FIRST &&
 257       pspec->param_id <= GTK_FILE_CHOOSER_PROP_LAST)
 258     {
 259       g_object_notify (data, pspec->name);
 260     }
 261 }
 262
 263 static void
 264 delegate_selection_changed (GtkFileChooser *chooser,
 265                             gpointer        data)
 266 {
 267   g_signal_emit_by_name (data, "selection-changed");
 268 }
 269
 270 static void
 271 delegate_current_folder_changed (GtkFileChooser *chooser,
 272                                  gpointer        data)
 273 {
 274   g_signal_emit_by_name (data, "current-folder-changed");
 275 }
 276
 277 static void
 278 delegate_update_preview (GtkFileChooser    *chooser,
 279                          gpointer           data)
 280 {
 281   g_signal_emit_by_name (data, "update-preview");
 282 }