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
  28 static gboolean       delegate_set_current_folder     (GtkFileChooser    *chooser,
  29                                                        const GtkFilePath *path,
  30                                                        GError           **error);
  31 static GtkFilePath *  delegate_get_current_folder     (GtkFileChooser    *chooser);
  32 static void           delegate_set_current_name       (GtkFileChooser    *chooser,
  33                                                        const gchar       *name);
  34 static gboolean       delegate_select_path            (GtkFileChooser    *chooser,
  35                                                        const GtkFilePath *path,
  36                                                        GError           **error);
  37 static void           delegate_unselect_path          (GtkFileChooser    *chooser,
  38                                                        const GtkFilePath *path);
  39 static void           delegate_select_all             (GtkFileChooser    *chooser);
  40 static void           delegate_unselect_all           (GtkFileChooser    *chooser);
  41 static GSList *       delegate_get_paths              (GtkFileChooser    *chooser);
  42 static GtkFilePath *  delegate_get_preview_path       (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                                                        const GtkFilePath *path,
  51                                                        GError           **error);
  52 static gboolean       delegate_remove_shortcut_folder (GtkFileChooser    *chooser,
  53                                                        const GtkFilePath *path,
  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 /**
  69  * _gtk_file_chooser_install_properties:
  70  * @klass: the class structure for a type deriving from #GObject
  71  *
  72  * Installs the necessary properties for a class implementing
  73  * #GtkFileChooser. A #GtkParamSpecOverride property is installed
  74  * for each property, using the values from the #GtkFileChooserProp
  75  * enumeration. The caller must make sure itself that the enumeration
  76  * values don't collide with some other property values they
  77  * are using.
  78  **/
  79 void
  80 _gtk_file_chooser_install_properties (GObjectClass *klass)
  81 {
  82   g_object_class_override_property (klass,
  83                                     GTK_FILE_CHOOSER_PROP_ACTION,
  84                                     "action");
  85   g_object_class_override_property (klass,
  86                                     GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
  87                                     "extra-widget");
  88   g_object_class_override_property (klass,
  89                                     GTK_FILE_CHOOSER_PROP_FILE_SYSTEM_BACKEND,
  90                                     "file-system-backend");
  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 }
 113
 114 /**
 115  * _gtk_file_chooser_delegate_iface_init:
 116  * @iface: a #GtkFileChoserIface structure
 117  *
 118  * An interface-initialization function for use in cases where
 119  * an object is simply delegating the methods, signals of
 120  * the #GtkFileChooser interface to another object.
 121  * _gtk_file_chooser_set_delegate() must be called on each
 122  * instance of the object so that the delegate object can
 123  * be found.
 124  **/
 125 void
 126 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
 127 {
 128   iface->set_current_folder = delegate_set_current_folder;
 129   iface->get_current_folder = delegate_get_current_folder;
 130   iface->set_current_name = delegate_set_current_name;
 131   iface->select_path = delegate_select_path;
 132   iface->unselect_path = delegate_unselect_path;
 133   iface->select_all = delegate_select_all;
 134   iface->unselect_all = delegate_unselect_all;
 135   iface->get_paths = delegate_get_paths;
 136   iface->get_preview_path = delegate_get_preview_path;
 137   iface->get_file_system = delegate_get_file_system;
 138   iface->add_filter = delegate_add_filter;
 139   iface->remove_filter = delegate_remove_filter;
 140   iface->list_filters = delegate_list_filters;
 141   iface->add_shortcut_folder = delegate_add_shortcut_folder;
 142   iface->remove_shortcut_folder = delegate_remove_shortcut_folder;
 143   iface->list_shortcut_folders = delegate_list_shortcut_folders;
 144 }
 145
 146 /**
 147  * _gtk_file_chooser_set_delegate:
 148  * @receiver: a #GObject implementing #GtkFileChooser
 149  * @delegate: another #GObject implementing #GtkFileChooser
 150  *
 151  * Establishes that calls on @receiver for #GtkFileChooser
 152  * methods should be delegated to @delegate, and that
 153  * #GtkFileChooser signals emitted on @delegate should be
 154  * forwarded to @receiver. Must be used in conjunction with
 155  * _gtk_file_chooser_delegate_iface_init().
 156  **/
 157 void
 158 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
 159                                 GtkFileChooser *delegate)
 160 {
 161   g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
 162   g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
 163
 164   g_object_set_data (G_OBJECT (receiver), "gtk-file-chooser-delegate", delegate);
 165   g_signal_connect (delegate, "notify",
 166                     G_CALLBACK (delegate_notify), receiver);
 167   g_signal_connect (delegate, "current-folder-changed",
 168                     G_CALLBACK (delegate_current_folder_changed), receiver);
 169   g_signal_connect (delegate, "selection-changed",
 170                     G_CALLBACK (delegate_selection_changed), receiver);
 171   g_signal_connect (delegate, "update-preview",
 172                     G_CALLBACK (delegate_update_preview), receiver);
 173   g_signal_connect (delegate, "file-activated",
 174                     G_CALLBACK (delegate_file_activated), receiver);
 175 }
 176
 177 static GtkFileChooser *
 178 get_delegate (GtkFileChooser *receiver)
 179 {
 180   return g_object_get_data (G_OBJECT (receiver), "gtk-file-chooser-delegate");
 181 }
 182
 183 static gboolean
 184 delegate_select_path (GtkFileChooser    *chooser,
 185                       const GtkFilePath *path,
 186                       GError           **error)
 187 {
 188   return _gtk_file_chooser_select_path (get_delegate (chooser), path, error);
 189 }
 190
 191 static void
 192 delegate_unselect_path (GtkFileChooser    *chooser,
 193                         const GtkFilePath *path)
 194 {
 195   _gtk_file_chooser_unselect_path (get_delegate (chooser), path);
 196 }
 197
 198 static void
 199 delegate_select_all (GtkFileChooser *chooser)
 200 {
 201   gtk_file_chooser_select_all (get_delegate (chooser));
 202 }
 203
 204 static void
 205 delegate_unselect_all (GtkFileChooser *chooser)
 206 {
 207   gtk_file_chooser_unselect_all (get_delegate (chooser));
 208 }
 209
 210 static GSList *
 211 delegate_get_paths (GtkFileChooser *chooser)
 212 {
 213   return _gtk_file_chooser_get_paths (get_delegate (chooser));
 214 }
 215
 216 static GtkFilePath *
 217 delegate_get_preview_path (GtkFileChooser *chooser)
 218 {
 219   return _gtk_file_chooser_get_preview_path (get_delegate (chooser));
 220 }
 221
 222 static GtkFileSystem *
 223 delegate_get_file_system (GtkFileChooser *chooser)
 224 {
 225   return _gtk_file_chooser_get_file_system (get_delegate (chooser));
 226 }
 227
 228 static void
 229 delegate_add_filter (GtkFileChooser *chooser,
 230                      GtkFileFilter  *filter)
 231 {
 232   gtk_file_chooser_add_filter (get_delegate (chooser), filter);
 233 }
 234
 235 static void
 236 delegate_remove_filter (GtkFileChooser *chooser,
 237                         GtkFileFilter  *filter)
 238 {
 239   gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
 240 }
 241
 242 static GSList *
 243 delegate_list_filters (GtkFileChooser *chooser)
 244 {
 245   return gtk_file_chooser_list_filters (get_delegate (chooser));
 246 }
 247
 248 static gboolean
 249 delegate_add_shortcut_folder (GtkFileChooser    *chooser,
 250                               const GtkFilePath *path,
 251                               GError           **error)
 252 {
 253   return _gtk_file_chooser_add_shortcut_folder (get_delegate (chooser), path, error);
 254 }
 255
 256 static gboolean
 257 delegate_remove_shortcut_folder (GtkFileChooser    *chooser,
 258                                  const GtkFilePath *path,
 259                                  GError           **error)
 260 {
 261   return _gtk_file_chooser_remove_shortcut_folder (get_delegate (chooser), path, error);
 262 }
 263
 264 static GSList *
 265 delegate_list_shortcut_folders (GtkFileChooser *chooser)
 266 {
 267   return gtk_file_chooser_list_shortcut_folders (get_delegate (chooser));
 268 }
 269
 270 static gboolean
 271 delegate_set_current_folder (GtkFileChooser    *chooser,
 272                              const GtkFilePath *path,
 273                              GError           **error)
 274 {
 275   return _gtk_file_chooser_set_current_folder_path (get_delegate (chooser), path, error);
 276 }
 277
 278 static GtkFilePath *
 279 delegate_get_current_folder (GtkFileChooser *chooser)
 280 {
 281   return _gtk_file_chooser_get_current_folder_path (get_delegate (chooser));
 282 }
 283
 284 static void
 285 delegate_set_current_name (GtkFileChooser *chooser,
 286                            const gchar    *name)
 287 {
 288   gtk_file_chooser_set_current_name (get_delegate (chooser), name);
 289 }
 290
 291 static void
 292 delegate_notify (GObject    *object,
 293                  GParamSpec *pspec,
 294                  gpointer    data)
 295 {
 296   gpointer iface;
 297
 298   iface = g_type_interface_peek (g_type_class_peek (G_OBJECT_TYPE (object)),
 299                                  gtk_file_chooser_get_type ());
 300   if (g_object_interface_find_property (iface, pspec->name))
 301     g_object_notify (data, pspec->name);
 302 }
 303
 304 static void
 305 delegate_selection_changed (GtkFileChooser *chooser,
 306                             gpointer        data)
 307 {
 308   g_signal_emit_by_name (data, "selection-changed");
 309 }
 310
 311 static void
 312 delegate_current_folder_changed (GtkFileChooser *chooser,
 313                                  gpointer        data)
 314 {
 315   g_signal_emit_by_name (data, "current-folder-changed");
 316 }
 317
 318 static void
 319 delegate_update_preview (GtkFileChooser    *chooser,
 320                          gpointer           data)
 321 {
 322   g_signal_emit_by_name (data, "update-preview");
 323 }
 324
 325 static void
 326 delegate_file_activated (GtkFileChooser    *chooser,
 327                          gpointer           data)
 328 {
 329   g_signal_emit_by_name (data, "file-activated");
 330 }