gtkfilechooserprivate.h 9.68 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
2 3 4 5 6 7 8 9 10 11 12 13 14 15
 * gtkfilechooserprivate.h: Interface definition for file selector GUIs
 * Copyright (C) 2003, Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
16
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
17 18 19 20 21 22 23
 */

#ifndef __GTK_FILE_CHOOSER_PRIVATE_H__
#define __GTK_FILE_CHOOSER_PRIVATE_H__

#include "gtkfilechooser.h"
#include "gtkfilesystem.h"
24 25
#include "gtkfilesystemmodel.h"
#include "gtkliststore.h"
26
#include "gtkrecentmanager.h"
27 28
#include "gtksearchengine.h"
#include "gtkquery.h"
29
#include "gtksizegroup.h"
30 31 32
#include "gtktreemodelsort.h"
#include "gtktreestore.h"
#include "gtktreeview.h"
33
#include "gtkbox.h"
34 35 36 37 38 39 40 41 42 43 44 45 46

G_BEGIN_DECLS

#define GTK_FILE_CHOOSER_GET_IFACE(inst)  (G_TYPE_INSTANCE_GET_INTERFACE ((inst), GTK_TYPE_FILE_CHOOSER, GtkFileChooserIface))

typedef struct _GtkFileChooserIface GtkFileChooserIface;

struct _GtkFileChooserIface
{
  GTypeInterface base_iface;

  /* Methods
   */
47
  gboolean       (*set_current_folder) 	   (GtkFileChooser    *chooser,
48
					    GFile             *file,
49
					    GError           **error);
50
  GFile *        (*get_current_folder) 	   (GtkFileChooser    *chooser);
51 52
  void           (*set_current_name)   	   (GtkFileChooser    *chooser,
					    const gchar       *name);
53 54
  gboolean       (*select_file)        	   (GtkFileChooser    *chooser,
					    GFile             *file,
55
					    GError           **error);
56 57
  void           (*unselect_file)      	   (GtkFileChooser    *chooser,
					    GFile             *file);
58 59
  void           (*select_all)         	   (GtkFileChooser    *chooser);
  void           (*unselect_all)       	   (GtkFileChooser    *chooser);
60 61
  GSList *       (*get_files)          	   (GtkFileChooser    *chooser);
  GFile *        (*get_preview_file)   	   (GtkFileChooser    *chooser);
62 63 64 65 66 67
  GtkFileSystem *(*get_file_system)    	   (GtkFileChooser    *chooser);
  void           (*add_filter)         	   (GtkFileChooser    *chooser,
					    GtkFileFilter     *filter);
  void           (*remove_filter)      	   (GtkFileChooser    *chooser,
					    GtkFileFilter     *filter);
  GSList *       (*list_filters)       	   (GtkFileChooser    *chooser);
68
  gboolean       (*add_shortcut_folder)    (GtkFileChooser    *chooser,
69
					    GFile             *file,
70 71
					    GError           **error);
  gboolean       (*remove_shortcut_folder) (GtkFileChooser    *chooser,
72
					    GFile             *file,
73
					    GError           **error);
74
  GSList *       (*list_shortcut_folders)  (GtkFileChooser    *chooser);
75 76 77 78 79
  
  /* Signals
   */
  void (*current_folder_changed) (GtkFileChooser *chooser);
  void (*selection_changed)      (GtkFileChooser *chooser);
80
  void (*update_preview)         (GtkFileChooser *chooser);
81
  void (*file_activated)         (GtkFileChooser *chooser);
82
  GtkFileChooserConfirmation (*confirm_overwrite) (GtkFileChooser *chooser);
83 84
};

85
GtkFileSystem *_gtk_file_chooser_get_file_system         (GtkFileChooser    *chooser);
86 87
gboolean       _gtk_file_chooser_set_current_folder_file (GtkFileChooser    *chooser,
							  GFile             *file,
88
							  GError           **error);
89 90 91
GFile *        _gtk_file_chooser_get_current_folder_file (GtkFileChooser    *chooser);
gboolean       _gtk_file_chooser_select_file             (GtkFileChooser    *chooser,
							  GFile             *file,
92
							  GError           **error);
93 94 95 96
void           _gtk_file_chooser_unselect_file           (GtkFileChooser    *chooser,
							  GFile             *file);
GSList *       _gtk_file_chooser_get_files               (GtkFileChooser    *chooser);
GFile *        _gtk_file_chooser_get_preview_file        (GtkFileChooser    *chooser);
97
gboolean       _gtk_file_chooser_add_shortcut_folder     (GtkFileChooser    *chooser,
98
							  GFile             *folder,
99 100
							  GError           **error);
gboolean       _gtk_file_chooser_remove_shortcut_folder  (GtkFileChooser    *chooser,
101
							  GFile             *folder,
102
							  GError           **error);
103
GSList *       _gtk_file_chooser_list_shortcut_folder_files (GtkFileChooser *chooser);
104

105 106 107 108 109 110 111 112 113
/* GtkFileChooserDialog private */

struct _GtkFileChooserDialogPrivate
{
  GtkWidget *widget;
  
  char *file_system;

  /* for use with GtkFileChooserEmbed */
114
  gboolean response_requested;
115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136
};


/* GtkFileChooserWidget private */

struct _GtkFileChooserWidgetPrivate
{
  GtkWidget *impl;

  char *file_system;
};


/* GtkFileChooserDefault private */

typedef enum {
  LOAD_EMPTY,			/* There is no model */
  LOAD_PRELOAD,			/* Model is loading and a timer is running; model isn't inserted into the tree yet */
  LOAD_LOADING,			/* Timeout expired, model is inserted into the tree, but not fully loaded yet */
  LOAD_FINISHED			/* Model is fully loaded and inserted into the tree */
} LoadState;

137 138
typedef enum {
  RELOAD_EMPTY,			/* No folder has been set */
139
  RELOAD_HAS_FOLDER		/* We have a folder, although it may not be completely loaded yet; no need to reload */
140 141
} ReloadState;

142 143 144 145 146
typedef enum {
  LOCATION_MODE_PATH_BAR,
  LOCATION_MODE_FILENAME_ENTRY
} LocationMode;

147 148
typedef enum {
  OPERATION_MODE_BROWSE,
149 150
  OPERATION_MODE_SEARCH,
  OPERATION_MODE_RECENT
151 152
} OperationMode;

153 154
struct _GtkFileChooserDefault
{
155
  GtkBox parent_instance;
156 157 158 159 160 161 162

  GtkFileChooserAction action;

  GtkFileSystem *file_system;

  /* Save mode widgets */
  GtkWidget *save_widgets;
163
  GtkWidget *save_widgets_table;
164 165 166 167

  GtkWidget *save_folder_label;

  /* The file browsing widgets */
168
  GtkWidget *browse_widgets_box;
169
  GtkWidget *browse_header_box;
170 171 172 173 174 175 176 177 178 179
  GtkWidget *browse_shortcuts_tree_view;
  GtkWidget *browse_shortcuts_add_button;
  GtkWidget *browse_shortcuts_remove_button;
  GtkWidget *browse_shortcuts_popup_menu;
  GtkWidget *browse_shortcuts_popup_menu_remove_item;
  GtkWidget *browse_shortcuts_popup_menu_rename_item;
  GtkWidget *browse_files_tree_view;
  GtkWidget *browse_files_popup_menu;
  GtkWidget *browse_files_popup_menu_add_shortcut_item;
  GtkWidget *browse_files_popup_menu_hidden_files_item;
180
  GtkWidget *browse_files_popup_menu_size_column_item;
181
  GtkWidget *browse_files_popup_menu_copy_file_location_item;
182
  GtkWidget *browse_files_popup_menu_visit_file_item;
183
  GtkWidget *browse_new_folder_button;
184
  GtkWidget *browse_path_bar_hbox;
185
  GtkSizeGroup *browse_path_bar_size_group;
186
  GtkWidget *browse_path_bar;
187 188
  GtkWidget *browse_special_mode_icon;
  GtkWidget *browse_special_mode_label;
189
  GtkWidget *browse_select_a_folder_info_bar;
190
  GtkWidget *browse_select_a_folder_label;
191
  GtkWidget *browse_select_a_folder_icon;
192 193

  GtkFileSystemModel *browse_files_model;
194
  char *browse_files_last_selected_name;
195

196
  /* OPERATION_MODE_SEARCH */
197 198 199 200
  GtkWidget *search_hbox;
  GtkWidget *search_entry;
  GtkSearchEngine *search_engine;
  GtkQuery *search_query;
201
  GtkFileSystemModel *search_model;
202

203
  /* OPERATION_MODE_RECENT */
204
  GtkRecentManager *recent_manager;
205
  GtkFileSystemModel *recent_model;
206 207
  guint load_recent_id;

208 209 210 211 212 213 214 215
  GtkWidget *filter_combo_hbox;
  GtkWidget *filter_combo;
  GtkWidget *preview_box;
  GtkWidget *preview_label;
  GtkWidget *preview_widget;
  GtkWidget *extra_align;
  GtkWidget *extra_widget;

216 217 218 219 220 221
  GtkWidget *location_button;
  GtkWidget *location_entry_box;
  GtkWidget *location_label;
  GtkWidget *location_entry;
  LocationMode location_mode;

222
  GtkListStore *shortcuts_model;
223 224 225 226 227 228

  /* Filter for the shortcuts pane.  We filter out the "current folder" row and
   * the separator that we use for the "Save in folder" combo.
   */
  GtkTreeModel *shortcuts_pane_filter_model;
  
229 230
  /* Handles */
  GSList *loading_shortcuts;
231 232 233 234 235 236 237 238
  GSList *reload_icon_cancellables;
  GCancellable *file_list_drag_data_received_cancellable;
  GCancellable *update_current_folder_cancellable;
  GCancellable *should_respond_get_info_cancellable;
  GCancellable *file_exists_get_info_cancellable;
  GCancellable *update_from_entry_cancellable;
  GCancellable *shortcuts_activate_iter_cancellable;
  GSList *pending_cancellables;
239

240
  LoadState load_state;
241
  ReloadState reload_state;
242 243
  guint load_timeout_id;

244 245
  OperationMode operation_mode;

246
  GSList *pending_select_files;
247 248 249 250 251 252 253 254 255 256 257

  GtkFileFilter *current_filter;
  GSList *filters;

  int num_volumes;
  int num_shortcuts;
  int num_bookmarks;

  gulong volumes_changed_id;
  gulong bookmarks_changed_id;

258 259 260
  GFile *current_volume_file;
  GFile *current_folder;
  GFile *preview_file;
261 262 263 264
  char *preview_display_name;

  GtkTreeViewColumn *list_name_column;
  GtkCellRenderer *list_name_renderer;
265
  GtkTreeViewColumn *list_mtime_column;
266
  GtkTreeViewColumn *list_size_column;
267 268 269 270 271 272 273

  GSource *edited_idle;
  char *edited_new_text;

  gulong settings_signal_id;
  int icon_size;

274 275
  GSource *focus_entry_idle;

276 277 278
  gulong toplevel_set_focus_id;
  GtkWidget *toplevel_last_focus_widget;

279 280 281
  gint sort_column;
  GtkSortType sort_order;

282 283
  GSettings *settings;

284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299
#if 0
  GdkDragContext *shortcuts_drag_context;
  GSource *shortcuts_drag_outside_idle;
#endif

  /* Flags */

  guint local_only : 1;
  guint preview_widget_active : 1;
  guint use_preview_label : 1;
  guint select_multiple : 1;
  guint show_hidden : 1;
  guint do_overwrite_confirmation : 1;
  guint list_sort_ascending : 1;
  guint changing_folder : 1;
  guint shortcuts_current_folder_active : 1;
300 301 302
  guint has_home : 1;
  guint has_desktop : 1;
  guint has_search : 1;
303
  guint show_size_column : 1;
304
  guint create_folders : 1;
305 306 307 308 309 310 311

#if 0
  guint shortcuts_drag_outside : 1;
#endif
};


312 313 314
G_END_DECLS

#endif /* __GTK_FILE_CHOOSER_PRIVATE_H__ */