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 16 17 18 19 20 21 22 23 24 25
 * 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
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#ifndef __GTK_FILE_CHOOSER_PRIVATE_H__
#define __GTK_FILE_CHOOSER_PRIVATE_H__

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

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
   */
49
  gboolean       (*set_current_folder) 	   (GtkFileChooser    *chooser,
50
					    GFile             *file,
51
					    GError           **error);
52
  GFile *        (*get_current_folder) 	   (GtkFileChooser    *chooser);
53 54
  void           (*set_current_name)   	   (GtkFileChooser    *chooser,
					    const gchar       *name);
55 56
  gboolean       (*select_file)        	   (GtkFileChooser    *chooser,
					    GFile             *file,
57
					    GError           **error);
58 59
  void           (*unselect_file)      	   (GtkFileChooser    *chooser,
					    GFile             *file);
60 61
  void           (*select_all)         	   (GtkFileChooser    *chooser);
  void           (*unselect_all)       	   (GtkFileChooser    *chooser);
62 63
  GSList *       (*get_files)          	   (GtkFileChooser    *chooser);
  GFile *        (*get_preview_file)   	   (GtkFileChooser    *chooser);
64 65 66 67 68 69
  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);
70
  gboolean       (*add_shortcut_folder)    (GtkFileChooser    *chooser,
71
					    GFile             *file,
72 73
					    GError           **error);
  gboolean       (*remove_shortcut_folder) (GtkFileChooser    *chooser,
74
					    GFile             *file,
75
					    GError           **error);
76
  GSList *       (*list_shortcut_folders)  (GtkFileChooser    *chooser);
77 78 79 80 81
  
  /* Signals
   */
  void (*current_folder_changed) (GtkFileChooser *chooser);
  void (*selection_changed)      (GtkFileChooser *chooser);
82
  void (*update_preview)         (GtkFileChooser *chooser);
83
  void (*file_activated)         (GtkFileChooser *chooser);
84
  GtkFileChooserConfirmation (*confirm_overwrite) (GtkFileChooser *chooser);
85 86
};

87
GtkFileSystem *_gtk_file_chooser_get_file_system         (GtkFileChooser    *chooser);
88 89
gboolean       _gtk_file_chooser_set_current_folder_file (GtkFileChooser    *chooser,
							  GFile             *file,
90
							  GError           **error);
91 92 93
GFile *        _gtk_file_chooser_get_current_folder_file (GtkFileChooser    *chooser);
gboolean       _gtk_file_chooser_select_file             (GtkFileChooser    *chooser,
							  GFile             *file,
94
							  GError           **error);
95 96 97 98
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);
99
gboolean       _gtk_file_chooser_add_shortcut_folder     (GtkFileChooser    *chooser,
100
							  GFile             *folder,
101 102
							  GError           **error);
gboolean       _gtk_file_chooser_remove_shortcut_folder  (GtkFileChooser    *chooser,
103
							  GFile             *folder,
104
							  GError           **error);
105
GSList *       _gtk_file_chooser_list_shortcut_folder_files (GtkFileChooser *chooser);
106

107 108 109 110 111 112 113 114 115
/* GtkFileChooserDialog private */

struct _GtkFileChooserDialogPrivate
{
  GtkWidget *widget;
  
  char *file_system;

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


/* 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;

139 140 141 142 143 144
typedef enum {
  RELOAD_EMPTY,			/* No folder has been set */
  RELOAD_HAS_FOLDER,		/* We have a folder, although it may not be completely loaded yet; no need to reload */
  RELOAD_WAS_UNMAPPED		/* We had a folder but got unmapped; reload is needed */
} ReloadState;

145 146 147 148 149
typedef enum {
  LOCATION_MODE_PATH_BAR,
  LOCATION_MODE_FILENAME_ENTRY
} LocationMode;

150 151
typedef enum {
  OPERATION_MODE_BROWSE,
152 153
  OPERATION_MODE_SEARCH,
  OPERATION_MODE_RECENT
154 155
} OperationMode;

156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182
struct _GtkFileChooserDefault
{
  GtkVBox parent_instance;

  GtkFileChooserAction action;

  GtkFileSystem *file_system;

  /* Save mode widgets */
  GtkWidget *save_widgets;

  GtkWidget *save_folder_label;
  GtkWidget *save_folder_combo;
  GtkWidget *save_expander;

  /* The file browsing widgets */
  GtkWidget *browse_widgets;
  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;
183
  GtkWidget *browse_files_popup_menu_size_column_item;
184
  GtkWidget *browse_new_folder_button;
185
  GtkWidget *browse_path_bar_hbox;
186
  GtkSizeGroup *browse_path_bar_size_group;
187 188 189
  GtkWidget *browse_path_bar;

  GtkFileSystemModel *browse_files_model;
190
  char *browse_files_last_selected_name;
191

192
  /* OPERATION_MODE_SEARCH */
193 194 195 196
  GtkWidget *search_hbox;
  GtkWidget *search_entry;
  GtkSearchEngine *search_engine;
  GtkQuery *search_query;
197
  GtkFileSystemModel *search_model;
198

199
  /* OPERATION_MODE_RECENT */
200
  GtkWidget *recent_hbox;
201
  GtkRecentManager *recent_manager;
202
  GtkFileSystemModel *recent_model;
203 204
  guint load_recent_id;

205 206 207 208 209 210 211 212
  GtkWidget *filter_combo_hbox;
  GtkWidget *filter_combo;
  GtkWidget *preview_box;
  GtkWidget *preview_label;
  GtkWidget *preview_widget;
  GtkWidget *extra_align;
  GtkWidget *extra_widget;

213 214 215 216 217 218
  GtkWidget *location_button;
  GtkWidget *location_entry_box;
  GtkWidget *location_label;
  GtkWidget *location_entry;
  LocationMode location_mode;

219
  GtkListStore *shortcuts_model;
220 221 222 223 224 225 226 227 228 229

  /* 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;
  
  /* Filter for the "Save in folder" combo.  We filter out the Search row and
   * its separator.
   */
  GtkTreeModel *shortcuts_combo_filter_model;
230

231 232
  /* Handles */
  GSList *loading_shortcuts;
233 234 235 236 237 238 239 240
  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;
241

242
  LoadState load_state;
243
  ReloadState reload_state;
244 245
  guint load_timeout_id;

246 247
  OperationMode operation_mode;

248
  GSList *pending_select_files;
249 250 251 252 253 254 255 256 257 258 259

  GtkFileFilter *current_filter;
  GSList *filters;

  int num_volumes;
  int num_shortcuts;
  int num_bookmarks;

  gulong volumes_changed_id;
  gulong bookmarks_changed_id;

260 261 262
  GFile *current_volume_file;
  GFile *current_folder;
  GFile *preview_file;
263 264 265 266
  char *preview_display_name;

  GtkTreeViewColumn *list_name_column;
  GtkCellRenderer *list_name_renderer;
267
  GtkTreeViewColumn *list_mtime_column;
268
  GtkTreeViewColumn *list_size_column;
269 270 271 272 273 274 275 276 277 278

  GSource *edited_idle;
  char *edited_new_text;

  gulong settings_signal_id;
  int icon_size;

  gulong toplevel_set_focus_id;
  GtkWidget *toplevel_last_focus_widget;

279 280 281
  gint sort_column;
  GtkSortType sort_order;

282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297
#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;
298
  guint expand_folders : 1;
299 300 301
  guint has_home : 1;
  guint has_desktop : 1;
  guint has_search : 1;
302
  guint has_recent : 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__ */