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.
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.
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.
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.
23 #include "gtkfilechooserutils.h"
24 #include "gtkfilechooser.h"
25 #include "gtkfilesystem.h"
26 #include "gtktypebuiltins.h"
28 static gboolean delegate_set_current_folder (GtkFileChooser *chooser,
29 const GtkFilePath *path,
31 static GtkFilePath * delegate_get_current_folder (GtkFileChooser *chooser);
32 static void delegate_set_current_name (GtkFileChooser *chooser,
34 static gboolean delegate_select_path (GtkFileChooser *chooser,
35 const GtkFilePath *path,
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,
52 static gboolean delegate_remove_shortcut_folder (GtkFileChooser *chooser,
53 const GtkFilePath *path,
55 static GSList * delegate_list_shortcut_folders (GtkFileChooser *chooser);
56 static void delegate_notify (GObject *object,
59 static void delegate_current_folder_changed (GtkFileChooser *chooser,
61 static void delegate_selection_changed (GtkFileChooser *chooser,
63 static void delegate_update_preview (GtkFileChooser *chooser,
65 static void delegate_file_activated (GtkFileChooser *chooser,
69 * _gtk_file_chooser_install_properties:
70 * @klass: the class structure for a type deriving from #GObject
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
80 _gtk_file_chooser_install_properties (GObjectClass *klass)
82 g_object_class_override_property (klass,
83 GTK_FILE_CHOOSER_PROP_ACTION,
85 g_object_class_override_property (klass,
86 GTK_FILE_CHOOSER_PROP_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,
94 g_object_class_override_property (klass,
95 GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
97 g_object_class_override_property (klass,
98 GTK_FILE_CHOOSER_PROP_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,
109 g_object_class_override_property (klass,
110 GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
115 * _gtk_file_chooser_delegate_iface_init:
116 * @iface: a #GtkFileChoserIface structure
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
126 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
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;
147 * _gtk_file_chooser_set_delegate:
148 * @receiver: a GOobject implementing #GtkFileChooser
149 * @delegate: another GObject implementing #GtkFileChooser
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 confunction with
155 * _gtk_file_chooser_delegate_iface_init().
158 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
159 GtkFileChooser *delegate)
161 g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
162 g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
164 g_object_set_data (G_OBJECT (receiver), "gtk-file-chooser-delegate", delegate);
166 g_signal_connect (delegate, "notify",
167 G_CALLBACK (delegate_notify), receiver);
168 g_signal_connect (delegate, "current-folder-changed",
169 G_CALLBACK (delegate_current_folder_changed), receiver);
170 g_signal_connect (delegate, "selection-changed",
171 G_CALLBACK (delegate_selection_changed), receiver);
172 g_signal_connect (delegate, "update-preview",
173 G_CALLBACK (delegate_update_preview), receiver);
174 g_signal_connect (delegate, "file-activated",
175 G_CALLBACK (delegate_file_activated), receiver);
178 static GtkFileChooser *
179 get_delegate (GtkFileChooser *receiver)
181 return g_object_get_data (G_OBJECT (receiver), "gtk-file-chooser-delegate");
185 delegate_select_path (GtkFileChooser *chooser,
186 const GtkFilePath *path,
189 return _gtk_file_chooser_select_path (get_delegate (chooser), path, error);
193 delegate_unselect_path (GtkFileChooser *chooser,
194 const GtkFilePath *path)
196 _gtk_file_chooser_unselect_path (get_delegate (chooser), path);
200 delegate_select_all (GtkFileChooser *chooser)
202 gtk_file_chooser_select_all (get_delegate (chooser));
206 delegate_unselect_all (GtkFileChooser *chooser)
208 gtk_file_chooser_unselect_all (get_delegate (chooser));
212 delegate_get_paths (GtkFileChooser *chooser)
214 return _gtk_file_chooser_get_paths (get_delegate (chooser));
218 delegate_get_preview_path (GtkFileChooser *chooser)
220 return _gtk_file_chooser_get_preview_path (get_delegate (chooser));
223 static GtkFileSystem *
224 delegate_get_file_system (GtkFileChooser *chooser)
226 return _gtk_file_chooser_get_file_system (get_delegate (chooser));
230 delegate_add_filter (GtkFileChooser *chooser,
231 GtkFileFilter *filter)
233 gtk_file_chooser_add_filter (get_delegate (chooser), filter);
237 delegate_remove_filter (GtkFileChooser *chooser,
238 GtkFileFilter *filter)
240 gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
244 delegate_list_filters (GtkFileChooser *chooser)
246 return gtk_file_chooser_list_filters (get_delegate (chooser));
250 delegate_add_shortcut_folder (GtkFileChooser *chooser,
251 const GtkFilePath *path,
254 return _gtk_file_chooser_add_shortcut_folder (get_delegate (chooser), path, error);
258 delegate_remove_shortcut_folder (GtkFileChooser *chooser,
259 const GtkFilePath *path,
262 return _gtk_file_chooser_remove_shortcut_folder (get_delegate (chooser), path, error);
266 delegate_list_shortcut_folders (GtkFileChooser *chooser)
268 return gtk_file_chooser_list_shortcut_folders (get_delegate (chooser));
272 delegate_set_current_folder (GtkFileChooser *chooser,
273 const GtkFilePath *path,
276 return _gtk_file_chooser_set_current_folder_path (get_delegate (chooser), path, error);
280 delegate_get_current_folder (GtkFileChooser *chooser)
282 return _gtk_file_chooser_get_current_folder_path (get_delegate (chooser));
286 delegate_set_current_name (GtkFileChooser *chooser,
289 gtk_file_chooser_set_current_name (get_delegate (chooser), name);
293 delegate_notify (GObject *object,
297 if (pspec->param_id >= GTK_FILE_CHOOSER_PROP_FIRST &&
298 pspec->param_id <= GTK_FILE_CHOOSER_PROP_LAST)
300 g_object_notify (data, pspec->name);
305 delegate_selection_changed (GtkFileChooser *chooser,
308 g_signal_emit_by_name (data, "selection-changed");
312 delegate_current_folder_changed (GtkFileChooser *chooser,
315 g_signal_emit_by_name (data, "current-folder-changed");
319 delegate_update_preview (GtkFileChooser *chooser,
322 g_signal_emit_by_name (data, "update-preview");
326 delegate_file_activated (GtkFileChooser *chooser,
329 g_signal_emit_by_name (data, "file-activated");