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"
30 static gboolean delegate_set_current_folder (GtkFileChooser *chooser,
33 static GFile * delegate_get_current_folder (GtkFileChooser *chooser);
34 static void delegate_set_current_name (GtkFileChooser *chooser,
36 static gboolean delegate_select_file (GtkFileChooser *chooser,
39 static void delegate_unselect_file (GtkFileChooser *chooser,
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,
54 static gboolean delegate_remove_shortcut_folder (GtkFileChooser *chooser,
57 static GSList * delegate_list_shortcut_folders (GtkFileChooser *chooser);
58 static void delegate_notify (GObject *object,
61 static void delegate_current_folder_changed (GtkFileChooser *chooser,
63 static void delegate_selection_changed (GtkFileChooser *chooser,
65 static void delegate_update_preview (GtkFileChooser *chooser,
67 static void delegate_file_activated (GtkFileChooser *chooser,
70 static GtkFileChooserConfirmation delegate_confirm_overwrite (GtkFileChooser *chooser,
74 * _gtk_file_chooser_install_properties:
75 * @klass: the class structure for a type deriving from #GObject
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
85 _gtk_file_chooser_install_properties (GObjectClass *klass)
87 g_object_class_override_property (klass,
88 GTK_FILE_CHOOSER_PROP_ACTION,
90 g_object_class_override_property (klass,
91 GTK_FILE_CHOOSER_PROP_EXTRA_WIDGET,
93 g_object_class_override_property (klass,
94 GTK_FILE_CHOOSER_PROP_FILTER,
96 g_object_class_override_property (klass,
97 GTK_FILE_CHOOSER_PROP_LOCAL_ONLY,
99 g_object_class_override_property (klass,
100 GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET,
102 g_object_class_override_property (klass,
103 GTK_FILE_CHOOSER_PROP_PREVIEW_WIDGET_ACTIVE,
104 "preview-widget-active");
105 g_object_class_override_property (klass,
106 GTK_FILE_CHOOSER_PROP_USE_PREVIEW_LABEL,
107 "use-preview-label");
108 g_object_class_override_property (klass,
109 GTK_FILE_CHOOSER_PROP_SELECT_MULTIPLE,
111 g_object_class_override_property (klass,
112 GTK_FILE_CHOOSER_PROP_SHOW_HIDDEN,
114 g_object_class_override_property (klass,
115 GTK_FILE_CHOOSER_PROP_DO_OVERWRITE_CONFIRMATION,
116 "do-overwrite-confirmation");
117 g_object_class_override_property (klass,
118 GTK_FILE_CHOOSER_PROP_CREATE_FOLDERS,
123 * _gtk_file_chooser_delegate_iface_init:
124 * @iface: a #GtkFileChoserIface structure
126 * An interface-initialization function for use in cases where
127 * an object is simply delegating the methods, signals of
128 * the #GtkFileChooser interface to another object.
129 * _gtk_file_chooser_set_delegate() must be called on each
130 * instance of the object so that the delegate object can
134 _gtk_file_chooser_delegate_iface_init (GtkFileChooserIface *iface)
136 iface->set_current_folder = delegate_set_current_folder;
137 iface->get_current_folder = delegate_get_current_folder;
138 iface->set_current_name = delegate_set_current_name;
139 iface->select_file = delegate_select_file;
140 iface->unselect_file = delegate_unselect_file;
141 iface->select_all = delegate_select_all;
142 iface->unselect_all = delegate_unselect_all;
143 iface->get_files = delegate_get_files;
144 iface->get_preview_file = delegate_get_preview_file;
145 iface->get_file_system = delegate_get_file_system;
146 iface->add_filter = delegate_add_filter;
147 iface->remove_filter = delegate_remove_filter;
148 iface->list_filters = delegate_list_filters;
149 iface->add_shortcut_folder = delegate_add_shortcut_folder;
150 iface->remove_shortcut_folder = delegate_remove_shortcut_folder;
151 iface->list_shortcut_folders = delegate_list_shortcut_folders;
155 * _gtk_file_chooser_set_delegate:
156 * @receiver: a #GObject implementing #GtkFileChooser
157 * @delegate: another #GObject implementing #GtkFileChooser
159 * Establishes that calls on @receiver for #GtkFileChooser
160 * methods should be delegated to @delegate, and that
161 * #GtkFileChooser signals emitted on @delegate should be
162 * forwarded to @receiver. Must be used in conjunction with
163 * _gtk_file_chooser_delegate_iface_init().
166 _gtk_file_chooser_set_delegate (GtkFileChooser *receiver,
167 GtkFileChooser *delegate)
169 g_return_if_fail (GTK_IS_FILE_CHOOSER (receiver));
170 g_return_if_fail (GTK_IS_FILE_CHOOSER (delegate));
172 g_object_set_data (G_OBJECT (receiver), I_("gtk-file-chooser-delegate"), delegate);
173 g_signal_connect (delegate, "notify",
174 G_CALLBACK (delegate_notify), receiver);
175 g_signal_connect (delegate, "current-folder-changed",
176 G_CALLBACK (delegate_current_folder_changed), receiver);
177 g_signal_connect (delegate, "selection-changed",
178 G_CALLBACK (delegate_selection_changed), receiver);
179 g_signal_connect (delegate, "update-preview",
180 G_CALLBACK (delegate_update_preview), receiver);
181 g_signal_connect (delegate, "file-activated",
182 G_CALLBACK (delegate_file_activated), receiver);
183 g_signal_connect (delegate, "confirm-overwrite",
184 G_CALLBACK (delegate_confirm_overwrite), receiver);
188 _gtk_file_chooser_delegate_get_quark (void)
190 static GQuark quark = 0;
192 if (G_UNLIKELY (quark == 0))
193 quark = g_quark_from_static_string ("gtk-file-chooser-delegate");
198 static GtkFileChooser *
199 get_delegate (GtkFileChooser *receiver)
201 return g_object_get_qdata (G_OBJECT (receiver),
202 GTK_FILE_CHOOSER_DELEGATE_QUARK);
206 delegate_select_file (GtkFileChooser *chooser,
210 return gtk_file_chooser_select_file (get_delegate (chooser), file, error);
214 delegate_unselect_file (GtkFileChooser *chooser,
217 gtk_file_chooser_unselect_file (get_delegate (chooser), file);
221 delegate_select_all (GtkFileChooser *chooser)
223 gtk_file_chooser_select_all (get_delegate (chooser));
227 delegate_unselect_all (GtkFileChooser *chooser)
229 gtk_file_chooser_unselect_all (get_delegate (chooser));
233 delegate_get_files (GtkFileChooser *chooser)
235 return gtk_file_chooser_get_files (get_delegate (chooser));
239 delegate_get_preview_file (GtkFileChooser *chooser)
241 return gtk_file_chooser_get_preview_file (get_delegate (chooser));
244 static GtkFileSystem *
245 delegate_get_file_system (GtkFileChooser *chooser)
247 return _gtk_file_chooser_get_file_system (get_delegate (chooser));
251 delegate_add_filter (GtkFileChooser *chooser,
252 GtkFileFilter *filter)
254 gtk_file_chooser_add_filter (get_delegate (chooser), filter);
258 delegate_remove_filter (GtkFileChooser *chooser,
259 GtkFileFilter *filter)
261 gtk_file_chooser_remove_filter (get_delegate (chooser), filter);
265 delegate_list_filters (GtkFileChooser *chooser)
267 return gtk_file_chooser_list_filters (get_delegate (chooser));
271 delegate_add_shortcut_folder (GtkFileChooser *chooser,
275 return _gtk_file_chooser_add_shortcut_folder (get_delegate (chooser), file, error);
279 delegate_remove_shortcut_folder (GtkFileChooser *chooser,
283 return _gtk_file_chooser_remove_shortcut_folder (get_delegate (chooser), file, error);
287 delegate_list_shortcut_folders (GtkFileChooser *chooser)
289 return _gtk_file_chooser_list_shortcut_folder_files (get_delegate (chooser));
293 delegate_set_current_folder (GtkFileChooser *chooser,
297 return gtk_file_chooser_set_current_folder_file (get_delegate (chooser), file, error);
301 delegate_get_current_folder (GtkFileChooser *chooser)
303 return gtk_file_chooser_get_current_folder_file (get_delegate (chooser));
307 delegate_set_current_name (GtkFileChooser *chooser,
310 gtk_file_chooser_set_current_name (get_delegate (chooser), name);
314 delegate_notify (GObject *object,
320 iface = g_type_interface_peek (g_type_class_peek (G_OBJECT_TYPE (object)),
321 gtk_file_chooser_get_type ());
322 if (g_object_interface_find_property (iface, pspec->name))
323 g_object_notify (data, pspec->name);
327 delegate_selection_changed (GtkFileChooser *chooser,
330 g_signal_emit_by_name (data, "selection-changed");
334 delegate_current_folder_changed (GtkFileChooser *chooser,
337 g_signal_emit_by_name (data, "current-folder-changed");
341 delegate_update_preview (GtkFileChooser *chooser,
344 g_signal_emit_by_name (data, "update-preview");
348 delegate_file_activated (GtkFileChooser *chooser,
351 g_signal_emit_by_name (data, "file-activated");
354 static GtkFileChooserConfirmation
355 delegate_confirm_overwrite (GtkFileChooser *chooser,
358 GtkFileChooserConfirmation conf;
360 g_signal_emit_by_name (data, "confirm-overwrite", &conf);