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 <config.h>
  23 #include "gtkfilechooserutils.h"
  24 #include "gtkfilechooser.h"
  25 #include "gtkfilesystem.h"
  26 #include "gtktypebuiltins.h"
  27 #include "gtkalias.h"
  28
  29 static gboolean       delegate_set_current_folder     (GtkFileChooser    *chooser,
  30                                                        const GtkFilePath *path,
  31                                                        GError           **error);
  32 static GtkFilePath *  delegate_get_current_folder     (GtkFileChooser    *chooser);
  33 static void           delegate_set_current_name       (GtkFileChooser    *chooser,
  34                                                        const gchar       *name);
  35 static gboolean       delegate_select_path            (GtkFileChooser    *chooser,
  36                                                        const GtkFilePath *path,
  37                                                        GError           **error);
  38 static void           delegate_unselect_path          (GtkFileChooser    *chooser,
  39                                                        const GtkFilePath *path);
  40 static void           delegate_select_all             (GtkFileChooser    *chooser);
  41 static void           delegate_unselect_all           (GtkFileChooser    *chooser);
  42 static GSList *       delegate_get_paths              (GtkFileChooser    *chooser);
  43 static GtkFilePath *  delegate_get_preview_path       (GtkFileChooser    *chooser);
  44 static GtkFileSystem *delegate_get_file_system        (GtkFileChooser    *chooser);
  45 static void           delegate_add_filter             (GtkFileChooser    *chooser,
  46                                                        GtkFileFilter     *filter);
  47 static void           delegate_remove_filter          (GtkFileChooser    *chooser,
  48                                                        GtkFileFilter     *filter);
  49 static GSList *       delegate_list_filters           (GtkFileChooser    *chooser);
  50 static gboolean       delegate_add_shortcut_folder    (GtkFileChooser    *chooser,
  51                                                        const GtkFilePath *path,
  52                                                        GError           **error);
  53 static gboolean       delegate_remove_shortcut_folder (GtkFileChooser    *chooser,
  54                                                        const GtkFilePath *path,
  55                                                        GError           **error);
  56 static GSList *       delegate_list_shortcut_folders  (GtkFileChooser    *chooser);
  57 static void           delegate_notify                 (GObject           *object,
  58                                                        GParamSpec        *pspec,
  59                                                        gpointer           data);
  60 static void           delegate_current_folder_changed (GtkFileChooser    *chooser,
  61                                                        gpointer           data);
  62 static void           delegate_selection_changed      (GtkFileChooser    *chooser,
  63                                                        gpointer           data);
  64 static void           delegate_update_preview         (GtkFileChooser    *chooser,
  65                                                        gpointer           data);
  66 static void           delegate_file_activated         (GtkFileChooser    *chooser,
  67                                                        gpointer           data);
  68
  69 static GtkFileChooserConfirmation delegate_confirm_overwrite (GtkFileChooser    *chooser,
  70                                                               gpointer           data);
  71
  72 /**
  73  * _gtk_file_chooser_install_properties:
  74  * @klass: the class structure for a type deriving from #GObject
  75  *
  76  * Installs the necessary properties for a class implementing
  77  * #GtkFileChooser. A #GtkParamSpecOverride property is installed
  78  * for each property, using the values from the #GtkFileChooserProp
  79  * enumeration. The caller must make sure itself that the enumeration
  80  * values don't collide with some other property values they
  81  * are using.
  82  **/
  83 void
  84 _gtk_file_chooser_install_properties (GObjectClass *klass)
  85 {
  86   g_object_class_override_property (klass,
  87                                     GTK_FILE_CHOOSER_PROP_ACTION,
  88                                     "action");
  89   g_object_class_override_property (klass,
  90                                     GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
  91                                     "extra-widget");
  92   g_object_class_override_property (klass,
  93                                     GTK_FILE_CHOOSER_PROP_FILE_SYSTEM_BACKEND,
  94                                     "file-system-backend");
  95   g_object_class_override_property (klass,
  96                                     GTK_FILE_CHOOSER_PROP_FILTER,
  97                                     "filter");
  98   g_object_class_override_property (klass,
  99                                     GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
 100                                     "local-only");
 101   g_object_class_override_property (klass,
 102                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET,
 103                                     "preview-widget");
 104   g_object_class_override_property (klass,
 105                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET_ACTIVE,
 106                                     "preview-widget-active");
 107   g_object_class_override_property (klass,
 108                                     GTK_FILE_CHOOSER_PROP_USE_PREVIEW_LABEL,
 109                                     "use-preview-label");
 110   g_object_class_override_property (klass,
 111                                     GTK_FILE_CHOOSER_PROP_SELECT_MULTIPLE,
 112                                     "select-multiple");
 113   g_object_class_override_property (klass,
 114                                     GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
 115                                     "show-hidden");
 116   g_object_class_override_property (klass,
 117                                     GTK_FILE_CHOOSER_PROP_DO_OVERWRITE_CONFIRMATION,
 118                                     "do-overwrite-confirmation");
 119 }
 120
 121 /**
 122  * _gtk_file_chooser_delegate_iface_init:
 123  * @iface: a #GtkFileChoserIface structure
 124  *
 125  * An interface-initialization function for use in cases where
 126  * an object is simply delegating the methods, signals of
 127  * the #GtkFileChooser interface to another object.
 128  * _gtk_file_chooser_set_delegate() must be called on each
 129  * instance of the object so that the delegate object can
 130  * be found.
 131  **/
 132 void
 133 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
 134 {
 135   iface->set_current_folder = delegate_set_current_folder;
 136   iface->get_current_folder = delegate_get_current_folder;
 137   iface->set_current_name = delegate_set_current_name;
 138   iface->select_path = delegate_select_path;
 139   iface->unselect_path = delegate_unselect_path;
 140   iface->select_all = delegate_select_all;
 141   iface->unselect_all = delegate_unselect_all;
 142   iface->get_paths = delegate_get_paths;
 143   iface->get_preview_path = delegate_get_preview_path;
 144   iface->get_file_system = delegate_get_file_system;
 145   iface->add_filter = delegate_add_filter;
 146   iface->remove_filter = delegate_remove_filter;
 147   iface->list_filters = delegate_list_filters;
 148   iface->add_shortcut_folder = delegate_add_shortcut_folder;
 149   iface->remove_shortcut_folder = delegate_remove_shortcut_folder;
 150   iface->list_shortcut_folders = delegate_list_shortcut_folders;
 151 }
 152
 153 /**
 154  * _gtk_file_chooser_set_delegate:
 155  * @receiver: a #GObject implementing #GtkFileChooser
 156  * @delegate: another #GObject implementing #GtkFileChooser
 157  *
 158  * Establishes that calls on @receiver for #GtkFileChooser
 159  * methods should be delegated to @delegate, and that
 160  * #GtkFileChooser signals emitted on @delegate should be
 161  * forwarded to @receiver. Must be used in conjunction with
 162  * _gtk_file_chooser_delegate_iface_init().
 163  **/
 164 void
 165 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
 166                                 GtkFileChooser *delegate)
 167 {
 168   g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
 169   g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
 170
 171   g_object_set_data (G_OBJECT (receiver), g_intern_static_string ("gtk-file-chooser-delegate"), delegate);
 172   g_signal_connect (delegate, "notify",
 173                     G_CALLBACK (delegate_notify), receiver);
 174   g_signal_connect (delegate, "current-folder-changed",
 175                     G_CALLBACK (delegate_current_folder_changed), receiver);
 176   g_signal_connect (delegate, "selection-changed",
 177                     G_CALLBACK (delegate_selection_changed), receiver);
 178   g_signal_connect (delegate, "update-preview",
 179                     G_CALLBACK (delegate_update_preview), receiver);
 180   g_signal_connect (delegate, "file-activated",
 181                     G_CALLBACK (delegate_file_activated), receiver);
 182   g_signal_connect (delegate, "confirm-overwrite",
 183                     G_CALLBACK (delegate_confirm_overwrite), receiver);
 184 }
 185
 186 GQuark
 187 _gtk_file_chooser_delegate_get_quark (void)
 188 {
 189   static GQuark quark = 0;
 190
 191   if (G_UNLIKELY (quark == 0))
 192     quark = g_quark_from_static_string ("gtk-file-chooser-delegate");
 193
 194   return quark;
 195 }
 196
 197 static GtkFileChooser *
 198 get_delegate (GtkFileChooser *receiver)
 199 {
 200   return g_object_get_qdata (G_OBJECT (receiver),
 201                              GTK_FILE_CHOOSER_DELEGATE_QUARK);
 202 }
 203
 204 static gboolean
 205 delegate_select_path (GtkFileChooser    *chooser,
 206                       const GtkFilePath *path,
 207                       GError           **error)
 208 {
 209   return _gtk_file_chooser_select_path (get_delegate (chooser), path, error);
 210 }
 211
 212 static void
 213 delegate_unselect_path (GtkFileChooser    *chooser,
 214                         const GtkFilePath *path)
 215 {
 216   _gtk_file_chooser_unselect_path (get_delegate (chooser), path);
 217 }
 218
 219 static void
 220 delegate_select_all (GtkFileChooser *chooser)
 221 {
 222   gtk_file_chooser_select_all (get_delegate (chooser));
 223 }
 224
 225 static void
 226 delegate_unselect_all (GtkFileChooser *chooser)
 227 {
 228   gtk_file_chooser_unselect_all (get_delegate (chooser));
 229 }
 230
 231 static GSList *
 232 delegate_get_paths (GtkFileChooser *chooser)
 233 {
 234   return _gtk_file_chooser_get_paths (get_delegate (chooser));
 235 }
 236
 237 static GtkFilePath *
 238 delegate_get_preview_path (GtkFileChooser *chooser)
 239 {
 240   return _gtk_file_chooser_get_preview_path (get_delegate (chooser));
 241 }
 242
 243 static GtkFileSystem *
 244 delegate_get_file_system (GtkFileChooser *chooser)
 245 {
 246   return _gtk_file_chooser_get_file_system (get_delegate (chooser));
 247 }
 248
 249 static void
 250 delegate_add_filter (GtkFileChooser *chooser,
 251                      GtkFileFilter  *filter)
 252 {
 253   gtk_file_chooser_add_filter (get_delegate (chooser), filter);
 254 }
 255
 256 static void
 257 delegate_remove_filter (GtkFileChooser *chooser,
 258                         GtkFileFilter  *filter)
 259 {
 260   gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
 261 }
 262
 263 static GSList *
 264 delegate_list_filters (GtkFileChooser *chooser)
 265 {
 266   return gtk_file_chooser_list_filters (get_delegate (chooser));
 267 }
 268
 269 static gboolean
 270 delegate_add_shortcut_folder (GtkFileChooser    *chooser,
 271                               const GtkFilePath *path,
 272                               GError           **error)
 273 {
 274   return _gtk_file_chooser_add_shortcut_folder (get_delegate (chooser), path, error);
 275 }
 276
 277 static gboolean
 278 delegate_remove_shortcut_folder (GtkFileChooser    *chooser,
 279                                  const GtkFilePath *path,
 280                                  GError           **error)
 281 {
 282   return _gtk_file_chooser_remove_shortcut_folder (get_delegate (chooser), path, error);
 283 }
 284
 285 static GSList *
 286 delegate_list_shortcut_folders (GtkFileChooser *chooser)
 287 {
 288   return gtk_file_chooser_list_shortcut_folders (get_delegate (chooser));
 289 }
 290
 291 static gboolean
 292 delegate_set_current_folder (GtkFileChooser    *chooser,
 293                              const GtkFilePath *path,
 294                              GError           **error)
 295 {
 296   return _gtk_file_chooser_set_current_folder_path (get_delegate (chooser), path, error);
 297 }
 298
 299 static GtkFilePath *
 300 delegate_get_current_folder (GtkFileChooser *chooser)
 301 {
 302   return _gtk_file_chooser_get_current_folder_path (get_delegate (chooser));
 303 }
 304
 305 static void
 306 delegate_set_current_name (GtkFileChooser *chooser,
 307                            const gchar    *name)
 308 {
 309   gtk_file_chooser_set_current_name (get_delegate (chooser), name);
 310 }
 311
 312 static void
 313 delegate_notify (GObject    *object,
 314                  GParamSpec *pspec,
 315                  gpointer    data)
 316 {
 317   gpointer iface;
 318
 319   iface = g_type_interface_peek (g_type_class_peek (G_OBJECT_TYPE (object)),
 320                                  gtk_file_chooser_get_type ());
 321   if (g_object_interface_find_property (iface, pspec->name))
 322     g_object_notify (data, pspec->name);
 323 }
 324
 325 static void
 326 delegate_selection_changed (GtkFileChooser *chooser,
 327                             gpointer        data)
 328 {
 329   g_signal_emit_by_name (data, "selection-changed");
 330 }
 331
 332 static void
 333 delegate_current_folder_changed (GtkFileChooser *chooser,
 334                                  gpointer        data)
 335 {
 336   g_signal_emit_by_name (data, "current-folder-changed");
 337 }
 338
 339 static void
 340 delegate_update_preview (GtkFileChooser    *chooser,
 341                          gpointer           data)
 342 {
 343   g_signal_emit_by_name (data, "update-preview");
 344 }
 345
 346 static void
 347 delegate_file_activated (GtkFileChooser    *chooser,
 348                          gpointer           data)
 349 {
 350   g_signal_emit_by_name (data, "file-activated");
 351 }
 352
 353 static GtkFileChooserConfirmation
 354 delegate_confirm_overwrite (GtkFileChooser    *chooser,
 355                             gpointer           data)
 356 {
 357   GtkFileChooserConfirmation conf;
 358
 359   g_signal_emit_by_name (data, "confirm-overwrite", &conf);
 360   return conf;
 361 }
 362
 363 #define __GTK_FILE_CHOOSER_UTILS_C__
 364 #include "gtkaliasdef.c"