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, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include "config.h"
  21 #include "gtkfilechooserutils.h"
  22 #include "gtkfilechooser.h"
  23 #include "gtkfilesystem.h"
  24 #include "gtktypebuiltins.h"
  25 #include "gtkintl.h"
  26
  27
  28 static gboolean       delegate_set_current_folder     (GtkFileChooser    *chooser,
  29                                                        GFile             *file,
  30                                                        GError           **error);
  31 static GFile *        delegate_get_current_folder     (GtkFileChooser    *chooser);
  32 static void           delegate_set_current_name       (GtkFileChooser    *chooser,
  33                                                        const gchar       *name);
  34 static gboolean       delegate_select_file            (GtkFileChooser    *chooser,
  35                                                        GFile             *file,
  36                                                        GError           **error);
  37 static void           delegate_unselect_file          (GtkFileChooser    *chooser,
  38                                                        GFile             *file);
  39 static void           delegate_select_all             (GtkFileChooser    *chooser);
  40 static void           delegate_unselect_all           (GtkFileChooser    *chooser);
  41 static GSList *       delegate_get_files              (GtkFileChooser    *chooser);
  42 static GFile *        delegate_get_preview_file       (GtkFileChooser    *chooser);
  43 static GtkFileSystem *delegate_get_file_system        (GtkFileChooser    *chooser);
  44 static void           delegate_add_filter             (GtkFileChooser    *chooser,
  45                                                        GtkFileFilter     *filter);
  46 static void           delegate_remove_filter          (GtkFileChooser    *chooser,
  47                                                        GtkFileFilter     *filter);
  48 static GSList *       delegate_list_filters           (GtkFileChooser    *chooser);
  49 static gboolean       delegate_add_shortcut_folder    (GtkFileChooser    *chooser,
  50                                                        GFile             *file,
  51                                                        GError           **error);
  52 static gboolean       delegate_remove_shortcut_folder (GtkFileChooser    *chooser,
  53                                                        GFile             *file,
  54                                                        GError           **error);
  55 static GSList *       delegate_list_shortcut_folders  (GtkFileChooser    *chooser);
  56 static void           delegate_notify                 (GObject           *object,
  57                                                        GParamSpec        *pspec,
  58                                                        gpointer           data);
  59 static void           delegate_current_folder_changed (GtkFileChooser    *chooser,
  60                                                        gpointer           data);
  61 static void           delegate_selection_changed      (GtkFileChooser    *chooser,
  62                                                        gpointer           data);
  63 static void           delegate_update_preview         (GtkFileChooser    *chooser,
  64                                                        gpointer           data);
  65 static void           delegate_file_activated         (GtkFileChooser    *chooser,
  66                                                        gpointer           data);
  67
  68 static GtkFileChooserConfirmation delegate_confirm_overwrite (GtkFileChooser    *chooser,
  69                                                               gpointer           data);
  70
  71 /**
  72  * _gtk_file_chooser_install_properties:
  73  * @klass: the class structure for a type deriving from #GObject
  74  *
  75  * Installs the necessary properties for a class implementing
  76  * #GtkFileChooser. A #GtkParamSpecOverride property is installed
  77  * for each property, using the values from the #GtkFileChooserProp
  78  * enumeration. The caller must make sure itself that the enumeration
  79  * values don't collide with some other property values they
  80  * are using.
  81  **/
  82 void
  83 _gtk_file_chooser_install_properties (GObjectClass *klass)
  84 {
  85   g_object_class_override_property (klass,
  86                                     GTK_FILE_CHOOSER_PROP_ACTION,
  87                                     "action");
  88   g_object_class_override_property (klass,
  89                                     GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
  90                                     "extra-widget");
  91   g_object_class_override_property (klass,
  92                                     GTK_FILE_CHOOSER_PROP_FILTER,
  93                                     "filter");
  94   g_object_class_override_property (klass,
  95                                     GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
  96                                     "local-only");
  97   g_object_class_override_property (klass,
  98                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET,
  99                                     "preview-widget");
 100   g_object_class_override_property (klass,
 101                                     GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET_ACTIVE,
 102                                     "preview-widget-active");
 103   g_object_class_override_property (klass,
 104                                     GTK_FILE_CHOOSER_PROP_USE_PREVIEW_LABEL,
 105                                     "use-preview-label");
 106   g_object_class_override_property (klass,
 107                                     GTK_FILE_CHOOSER_PROP_SELECT_MULTIPLE,
 108                                     "select-multiple");
 109   g_object_class_override_property (klass,
 110                                     GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
 111                                     "show-hidden");
 112   g_object_class_override_property (klass,
 113                                     GTK_FILE_CHOOSER_PROP_DO_OVERWRITE_CONFIRMATION,
 114                                     "do-overwrite-confirmation");
 115   g_object_class_override_property (klass,
 116                                     GTK_FILE_CHOOSER_PROP_CREATE_FOLDERS,
 117                                     "create-folders");
 118 }
 119
 120 /**
 121  * _gtk_file_chooser_delegate_iface_init:
 122  * @iface: a #GtkFileChoserIface structure
 123  *
 124  * An interface-initialization function for use in cases where
 125  * an object is simply delegating the methods, signals of
 126  * the #GtkFileChooser interface to another object.
 127  * _gtk_file_chooser_set_delegate() must be called on each
 128  * instance of the object so that the delegate object can
 129  * be found.
 130  **/
 131 void
 132 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
 133 {
 134   iface->set_current_folder = delegate_set_current_folder;
 135   iface->get_current_folder = delegate_get_current_folder;
 136   iface->set_current_name = delegate_set_current_name;
 137   iface->select_file = delegate_select_file;
 138   iface->unselect_file = delegate_unselect_file;
 139   iface->select_all = delegate_select_all;
 140   iface->unselect_all = delegate_unselect_all;
 141   iface->get_files = delegate_get_files;
 142   iface->get_preview_file = delegate_get_preview_file;
 143   iface->get_file_system = delegate_get_file_system;
 144   iface->add_filter = delegate_add_filter;
 145   iface->remove_filter = delegate_remove_filter;
 146   iface->list_filters = delegate_list_filters;
 147   iface->add_shortcut_folder = delegate_add_shortcut_folder;
 148   iface->remove_shortcut_folder = delegate_remove_shortcut_folder;
 149   iface->list_shortcut_folders = delegate_list_shortcut_folders;
 150 }
 151
 152 /**
 153  * _gtk_file_chooser_set_delegate:
 154  * @receiver: a #GObject implementing #GtkFileChooser
 155  * @delegate: another #GObject implementing #GtkFileChooser
 156  *
 157  * Establishes that calls on @receiver for #GtkFileChooser
 158  * methods should be delegated to @delegate, and that
 159  * #GtkFileChooser signals emitted on @delegate should be
 160  * forwarded to @receiver. Must be used in conjunction with
 161  * _gtk_file_chooser_delegate_iface_init().
 162  **/
 163 void
 164 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
 165                                 GtkFileChooser *delegate)
 166 {
 167   g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
 168   g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
 169
 170   g_object_set_data (G_OBJECT (receiver), I_("gtk-file-chooser-delegate"), delegate);
 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   g_signal_connect (delegate, "file-activated",
 180                     G_CALLBACK (delegate_file_activated), receiver);
 181   g_signal_connect (delegate, "confirm-overwrite",
 182                     G_CALLBACK (delegate_confirm_overwrite), receiver);
 183 }
 184
 185 GQuark
 186 _gtk_file_chooser_delegate_get_quark (void)
 187 {
 188   static GQuark quark = 0;
 189
 190   if (G_UNLIKELY (quark == 0))
 191     quark = g_quark_from_static_string ("gtk-file-chooser-delegate");
 192
 193   return quark;
 194 }
 195
 196 static GtkFileChooser *
 197 get_delegate (GtkFileChooser *receiver)
 198 {
 199   return g_object_get_qdata (G_OBJECT (receiver),
 200                              GTK_FILE_CHOOSER_DELEGATE_QUARK);
 201 }
 202
 203 static gboolean
 204 delegate_select_file (GtkFileChooser    *chooser,
 205                       GFile             *file,
 206                       GError           **error)
 207 {
 208   return gtk_file_chooser_select_file (get_delegate (chooser), file, error);
 209 }
 210
 211 static void
 212 delegate_unselect_file (GtkFileChooser *chooser,
 213                         GFile          *file)
 214 {
 215   gtk_file_chooser_unselect_file (get_delegate (chooser), file);
 216 }
 217
 218 static void
 219 delegate_select_all (GtkFileChooser *chooser)
 220 {
 221   gtk_file_chooser_select_all (get_delegate (chooser));
 222 }
 223
 224 static void
 225 delegate_unselect_all (GtkFileChooser *chooser)
 226 {
 227   gtk_file_chooser_unselect_all (get_delegate (chooser));
 228 }
 229
 230 static GSList *
 231 delegate_get_files (GtkFileChooser *chooser)
 232 {
 233   return gtk_file_chooser_get_files (get_delegate (chooser));
 234 }
 235
 236 static GFile *
 237 delegate_get_preview_file (GtkFileChooser *chooser)
 238 {
 239   return gtk_file_chooser_get_preview_file (get_delegate (chooser));
 240 }
 241
 242 static GtkFileSystem *
 243 delegate_get_file_system (GtkFileChooser *chooser)
 244 {
 245   return _gtk_file_chooser_get_file_system (get_delegate (chooser));
 246 }
 247
 248 static void
 249 delegate_add_filter (GtkFileChooser *chooser,
 250                      GtkFileFilter  *filter)
 251 {
 252   gtk_file_chooser_add_filter (get_delegate (chooser), filter);
 253 }
 254
 255 static void
 256 delegate_remove_filter (GtkFileChooser *chooser,
 257                         GtkFileFilter  *filter)
 258 {
 259   gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
 260 }
 261
 262 static GSList *
 263 delegate_list_filters (GtkFileChooser *chooser)
 264 {
 265   return gtk_file_chooser_list_filters (get_delegate (chooser));
 266 }
 267
 268 static gboolean
 269 delegate_add_shortcut_folder (GtkFileChooser  *chooser,
 270                               GFile           *file,
 271                               GError         **error)
 272 {
 273   return _gtk_file_chooser_add_shortcut_folder (get_delegate (chooser), file, error);
 274 }
 275
 276 static gboolean
 277 delegate_remove_shortcut_folder (GtkFileChooser  *chooser,
 278                                  GFile           *file,
 279                                  GError         **error)
 280 {
 281   return _gtk_file_chooser_remove_shortcut_folder (get_delegate (chooser), file, error);
 282 }
 283
 284 static GSList *
 285 delegate_list_shortcut_folders (GtkFileChooser *chooser)
 286 {
 287   return _gtk_file_chooser_list_shortcut_folder_files (get_delegate (chooser));
 288 }
 289
 290 static gboolean
 291 delegate_set_current_folder (GtkFileChooser  *chooser,
 292                              GFile           *file,
 293                              GError         **error)
 294 {
 295   return gtk_file_chooser_set_current_folder_file (get_delegate (chooser), file, error);
 296 }
 297
 298 static GFile *
 299 delegate_get_current_folder (GtkFileChooser *chooser)
 300 {
 301   return gtk_file_chooser_get_current_folder_file (get_delegate (chooser));
 302 }
 303
 304 static void
 305 delegate_set_current_name (GtkFileChooser *chooser,
 306                            const gchar    *name)
 307 {
 308   gtk_file_chooser_set_current_name (get_delegate (chooser), name);
 309 }
 310
 311 static void
 312 delegate_notify (GObject    *object,
 313                  GParamSpec *pspec,
 314                  gpointer    data)
 315 {
 316   gpointer iface;
 317
 318   iface = g_type_interface_peek (g_type_class_peek (G_OBJECT_TYPE (object)),
 319                                  gtk_file_chooser_get_type ());
 320   if (g_object_interface_find_property (iface, pspec->name))
 321     g_object_notify (data, pspec->name);
 322 }
 323
 324 static void
 325 delegate_selection_changed (GtkFileChooser *chooser,
 326                             gpointer        data)
 327 {
 328   g_signal_emit_by_name (data, "selection-changed");
 329 }
 330
 331 static void
 332 delegate_current_folder_changed (GtkFileChooser *chooser,
 333                                  gpointer        data)
 334 {
 335   g_signal_emit_by_name (data, "current-folder-changed");
 336 }
 337
 338 static void
 339 delegate_update_preview (GtkFileChooser    *chooser,
 340                          gpointer           data)
 341 {
 342   g_signal_emit_by_name (data, "update-preview");
 343 }
 344
 345 static void
 346 delegate_file_activated (GtkFileChooser    *chooser,
 347                          gpointer           data)
 348 {
 349   g_signal_emit_by_name (data, "file-activated");
 350 }
 351
 352 static GtkFileChooserConfirmation
 353 delegate_confirm_overwrite (GtkFileChooser    *chooser,
 354                             gpointer           data)
 355 {
 356   GtkFileChooserConfirmation conf;
 357
 358   g_signal_emit_by_name (data, "confirm-overwrite", &conf);
 359   return conf;
 360 }
 361
 362 static GFile *
 363 get_parent_for_uri (const char *uri)
 364 {
 365   GFile *file;
 366   GFile *parent;
 367
 368   file = g_file_new_for_uri (uri);
 369   parent = g_file_get_parent (file);
 370
 371   g_object_unref (file);
 372   return parent;
 373
 374 }
 375
 376 /* Extracts the parent folders out of the supplied list of GtkRecentInfo* items, and returns
 377  * a list of GFile* for those unique parents.
 378  */
 379 GList *
 380 _gtk_file_chooser_extract_recent_folders (GList *infos)
 381 {
 382   GList *l;
 383   GList *result;
 384   GHashTable *folders;
 385
 386   result = NULL;
 387
 388   folders = g_hash_table_new (g_file_hash, (GEqualFunc) g_file_equal);
 389
 390   for (l = infos; l; l = l->next)
 391     {
 392       GtkRecentInfo *info = l->data;
 393       const char *uri;
 394       GFile *parent;
 395
 396       uri = gtk_recent_info_get_uri (info);
 397       parent = get_parent_for_uri (uri);
 398
 399       if (parent)
 400         {
 401           if (!g_hash_table_lookup (folders, parent))
 402             {
 403               g_hash_table_insert (folders, parent, (gpointer) 1);
 404               result = g_list_prepend (result, g_object_ref (parent));
 405             }
 406
 407           g_object_unref (parent);
 408         }
 409     }
 410
 411   result = g_list_reverse (result);
 412
 413   g_hash_table_destroy (folders);
 414
 415   return result;
 416 }
 417
 418 GSettings *
 419 _gtk_file_chooser_get_settings_for_widget (GtkWidget *widget)
 420 {
 421   static GQuark file_chooser_settings_quark = 0;
 422   GtkSettings *gtksettings;
 423   GSettings *settings;
 424
 425   if (G_UNLIKELY (file_chooser_settings_quark == 0))
 426     file_chooser_settings_quark = g_quark_from_static_string ("-gtk-file-chooser-settings");
 427
 428   gtksettings = gtk_widget_get_settings (widget);
 429   settings = g_object_get_qdata (G_OBJECT (gtksettings), file_chooser_settings_quark);
 430
 431   if (G_UNLIKELY (settings == NULL))
 432     {
 433       settings = g_settings_new ("org.gtk.Settings.FileChooser");
 434       g_settings_delay (settings);
 435
 436       g_object_set_qdata_full (G_OBJECT (gtksettings),
 437                                file_chooser_settings_quark,
 438                                settings,
 439                                g_object_unref);
 440     }
 441
 442   return settings;
 443 }