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