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