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_install_property (klass,
  71                                    GTK_FILE_CHOOSER_PROP_ACTION,
  72                                    g_param_spec_override ("action",
  73                                                           GTK_TYPE_FILE_CHOOSER_ACTION,
  74                                                           G_PARAM_READWRITE));
  75   g_object_class_install_property (klass,
  76                                    GTK_FILE_CHOOSER_PROP_FILE_SYSTEM,
  77                                    g_param_spec_override ("file-system",
  78                                                           GTK_TYPE_FILE_SYSTEM,
  79                                                           G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY));
  80   g_object_class_install_property (klass,
  81                                    GTK_FILE_CHOOSER_PROP_FILTER,
  82                                    g_param_spec_override ("filter",
  83                                                           GTK_TYPE_FILE_FILTER,
  84                                                           G_PARAM_READWRITE));
  85   g_object_class_install_property (klass,
  86                                    GTK_FILE_CHOOSER_PROP_FOLDER_MODE,
  87                                    g_param_spec_override ("folder-mode",
  88                                                           G_TYPE_BOOLEAN,
  89                                                           G_PARAM_READWRITE));
  90   g_object_class_install_property (klass,
  91                                    GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
  92                                    g_param_spec_override ("local-only",
  93                                                           G_TYPE_BOOLEAN,
  94                                                           G_PARAM_READWRITE));
  95   g_object_class_install_property (klass,
  96                                    GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET,
  97                                    g_param_spec_override ("preview-widget",
  98                                                           GTK_TYPE_WIDGET,
  99                                                           G_PARAM_READWRITE));
 100   g_object_class_install_property (klass,
 101                                    GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET_ACTIVE,
 102                                    g_param_spec_override ("preview-widget-active",
 103                                                           G_TYPE_BOOLEAN,
 104                                                           G_PARAM_READWRITE));
 105   g_object_class_install_property (klass,
 106                                    GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
 107                                    g_param_spec_override ("extra-widget",
 108                                                           GTK_TYPE_WIDGET,
 109                                                           G_PARAM_READWRITE));
 110   g_object_class_install_property (klass,
 111                                    GTK_FILE_CHOOSER_PROP_SELECT_MULTIPLE,
 112                                    g_param_spec_override ("select-multiple",
 113                                                           G_TYPE_BOOLEAN,
 114                                                           G_PARAM_READWRITE));
 115   g_object_class_install_property (klass,
 116                                    GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
 117                                    g_param_spec_override ("show-hidden",
 118                                                           G_TYPE_BOOLEAN,
 119                                                           G_PARAM_READWRITE));
 120 }
 121
 122 /**
 123  * _gtk_file_chooser_delegate_iface_init:
 124  * @iface: a #GtkFileChoserIface structure
 125  *
 126  * An interface-initialization function for use in cases where
 127  * an object is simply delegating the methods, signals of
 128  * the #GtkFileChooser interface to another object.
 129  * _gtk_file_chooser_set_delegate() must be called on each
 130  * instance of the object so that the delegate object can
 131  * be found.
 132  **/
 133 void
 134 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
 135 {
 136   iface->set_current_folder = delegate_set_current_folder;
 137   iface->get_current_folder = delegate_get_current_folder;
 138   iface->set_current_name = delegate_set_current_name;
 139   iface->select_path = delegate_select_path;
 140   iface->unselect_path = delegate_unselect_path;
 141   iface->select_all = delegate_select_all;
 142   iface->unselect_all = delegate_unselect_all;
 143   iface->get_paths = delegate_get_paths;
 144   iface->get_preview_path = delegate_get_preview_path;
 145   iface->get_file_system = delegate_get_file_system;
 146   iface->add_filter = delegate_add_filter;
 147   iface->remove_filter = delegate_remove_filter;
 148   iface->list_filters = delegate_list_filters;
 149 }
 150
 151 /**
 152  * _gtk_file_chooser_set_delegate:
 153  * @receiver: a GOobject implementing #GtkFileChooser
 154  * @delegate: another GObject implementing #GtkFileChooser
 155  *
 156  * Establishes that calls on @receiver for #GtkFileChooser
 157  * methods should be delegated to @delegate, and that
 158  * #GtkFileChooser signals emitted on @delegate should be
 159  * forwarded to @receiver. Must be used in confunction with
 160  * _gtk_file_chooser_delegate_iface_init().
 161  **/
 162 void
 163 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
 164                                 GtkFileChooser *delegate)
 165 {
 166   g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
 167   g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
 168
 169   g_object_set_data (G_OBJECT (receiver), "gtk-file-chooser-delegate", delegate);
 170
 171   g_signal_connect (delegate, "notify",
 172                     G_CALLBACK (delegate_notify), receiver);
 173   g_signal_connect (delegate, "current-folder-changed",
 174                     G_CALLBACK (delegate_current_folder_changed), receiver);
 175   g_signal_connect (delegate, "selection-changed",
 176                     G_CALLBACK (delegate_selection_changed), receiver);
 177   g_signal_connect (delegate, "update-preview",
 178                     G_CALLBACK (delegate_update_preview), receiver);
 179 }
 180
 181 static GtkFileChooser *
 182 get_delegate (GtkFileChooser *receiver)
 183 {
 184   return g_object_get_data (G_OBJECT (receiver), "gtk-file-chooser-delegate");
 185 }
 186
 187 static void
 188 delegate_select_path (GtkFileChooser    *chooser,
 189                       const GtkFilePath *path)
 190 {
 191   _gtk_file_chooser_select_path (get_delegate (chooser), path);
 192 }
 193
 194 static void
 195 delegate_unselect_path (GtkFileChooser    *chooser,
 196                         const GtkFilePath *path)
 197 {
 198   _gtk_file_chooser_unselect_path (get_delegate (chooser), path);
 199 }
 200
 201 static void
 202 delegate_select_all (GtkFileChooser *chooser)
 203 {
 204   gtk_file_chooser_select_all (get_delegate (chooser));
 205 }
 206
 207 static void
 208 delegate_unselect_all (GtkFileChooser *chooser)
 209 {
 210   gtk_file_chooser_unselect_all (get_delegate (chooser));
 211 }
 212
 213 static GSList *
 214 delegate_get_paths (GtkFileChooser *chooser)
 215 {
 216   return _gtk_file_chooser_get_paths (get_delegate (chooser));
 217 }
 218
 219 static GtkFilePath *
 220 delegate_get_preview_path (GtkFileChooser *chooser)
 221 {
 222   return _gtk_file_chooser_get_preview_path (get_delegate (chooser));
 223 }
 224
 225 static GtkFileSystem *
 226 delegate_get_file_system (GtkFileChooser *chooser)
 227 {
 228   return _gtk_file_chooser_get_file_system (get_delegate (chooser));
 229 }
 230
 231 static void
 232 delegate_add_filter (GtkFileChooser *chooser,
 233                      GtkFileFilter  *filter)
 234 {
 235   gtk_file_chooser_add_filter (get_delegate (chooser), filter);
 236 }
 237
 238 static void
 239 delegate_remove_filter (GtkFileChooser *chooser,
 240                         GtkFileFilter  *filter)
 241 {
 242   gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
 243 }
 244
 245 static GSList *
 246 delegate_list_filters (GtkFileChooser *chooser)
 247 {
 248   return gtk_file_chooser_list_filters (get_delegate (chooser));
 249 }
 250
 251 static void
 252 delegate_set_current_folder (GtkFileChooser    *chooser,
 253                              const GtkFilePath *path)
 254 {
 255   _gtk_file_chooser_set_current_folder_path (chooser, path);
 256 }
 257
 258 static GtkFilePath *
 259 delegate_get_current_folder (GtkFileChooser *chooser)
 260 {
 261   return _gtk_file_chooser_get_current_folder_path (get_delegate (chooser));
 262 }
 263
 264 static void
 265 delegate_set_current_name (GtkFileChooser *chooser,
 266                            const gchar    *name)
 267 {
 268   gtk_file_chooser_set_current_name (get_delegate (chooser), name);
 269 }
 270
 271 static void
 272 delegate_notify (GObject    *object,
 273                  GParamSpec *pspec,
 274                  gpointer    data)
 275 {
 276   if (pspec->param_id >= GTK_FILE_CHOOSER_PROP_FIRST &&
 277       pspec->param_id <= GTK_FILE_CHOOSER_PROP_LAST)
 278     {
 279       g_object_notify (data, pspec->name);
 280     }
 281 }
 282
 283 static void
 284 delegate_selection_changed (GtkFileChooser *chooser,
 285                             gpointer        data)
 286 {
 287   g_signal_emit_by_name (data, "selection-changed");
 288 }
 289
 290 static void
 291 delegate_current_folder_changed (GtkFileChooser *chooser,
 292                                  gpointer        data)
 293 {
 294   g_signal_emit_by_name (data, "current-folder-changed");
 295 }
 296
 297 static void
 298 delegate_update_preview (GtkFileChooser    *chooser,
 299                          gpointer           data)
 300 {
 301   g_signal_emit_by_name (data, "update-preview");
 302 }