2 * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 1999-2002 Hiroyuki Yamamoto
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26 typedef struct _Folder Folder;
27 typedef struct _LocalFolder LocalFolder;
28 typedef struct _RemoteFolder RemoteFolder;
30 typedef struct _MaildirFolder MaildirFolder;
32 typedef struct _FolderItem FolderItem;
34 #include "prefs_folder_item.h"
36 #include "prefs_account.h"
41 #define FOLDER(obj) ((Folder *)obj)
42 #define FOLDER_TYPE(obj) (FOLDER(obj)->type)
44 #define LOCAL_FOLDER(obj) ((LocalFolder *)obj)
45 #define REMOTE_FOLDER(obj) ((RemoteFolder *)obj)
47 #define FOLDER_IS_LOCAL(obj) (FOLDER_TYPE(obj) == F_MH || \
48 FOLDER_TYPE(obj) == F_MBOX || \
49 FOLDER_TYPE(obj) == F_MAILDIR)
52 #define MAILDIR_FOLDER(obj) ((MaildirFolder *)obj)
55 #define FOLDER_ITEM(obj) ((FolderItem *)obj)
75 } SpecialFolderItemType;
102 F_MOVE_FAILED_DEST_IS_PARENT,
103 F_MOVE_FAILED_DEST_IS_CHILD,
107 typedef void (*FolderUIFunc) (Folder *folder,
110 typedef void (*FolderDestroyNotify) (Folder *folder,
113 typedef void (*FolderItemFunc) (FolderItem *item,
115 typedef void (*FolderItemUpdateFunc) (FolderItem *item,
116 gboolean contentchange,
124 PrefsAccount *account;
132 FolderUIFunc ui_func;
133 gpointer ui_func_data;
141 /* virtual functions */
143 GSList * (*get_msg_list) (Folder *folder,
147 FolderItem *(*item_new) (Folder *folder);
148 void (*item_destroy) (Folder *folder,
150 gchar * (*fetch_msg) (Folder *folder,
153 MsgInfo * (*get_msginfo) (Folder *folder,
156 GSList * (*get_msginfos) (Folder *folder,
158 GSList *msgnum_list);
159 gint (*add_msg) (Folder *folder,
162 gboolean remove_source);
163 gint (*move_msg) (Folder *folder,
166 gint (*move_msgs_with_dest) (Folder *folder,
169 gint (*copy_msg) (Folder *folder,
172 gint (*copy_msgs_with_dest) (Folder *folder,
175 gint (*remove_msg) (Folder *folder,
178 gint (*remove_msgs) (Folder *folder,
181 gint (*remove_all_msg) (Folder *folder,
183 gboolean (*is_msg_changed) (Folder *folder,
186 gint (*scan) (Folder *folder);
187 gint (*get_num_list) (Folder *folder,
190 void (*scan_tree) (Folder *folder);
192 gint (*create_tree) (Folder *folder);
193 FolderItem * (*create_folder) (Folder *folder,
196 gint (*rename_folder) (Folder *folder,
199 gint (*remove_folder) (Folder *folder,
202 void (*destroy) (Folder *folder);
203 void (*update_mark) (Folder *folder,
205 void (*change_flags) (Folder *folder,
208 void (*finished_copy) (Folder * folder, FolderItem * item);
209 void (*finished_remove) (Folder * folder, FolderItem * item);
210 gboolean (*check_msgnum_validity) (Folder * folder, FolderItem * item);
228 struct _MaildirFolder
236 SpecialFolderItemType stype;
253 guint no_sub : 1; /* no child allowed? */
254 guint no_select : 1; /* not selectable? */
255 guint collapsed : 1; /* collapsed item */
256 guint threaded : 1; /* threaded folder view */
257 guint hide_read_msgs : 1; /* hide read messages */
258 guint ret_rcpt : 1; /* return receipt */
261 guint opened : 1; /* opened by summary view */
262 guint need_update : 1; /* folderview for this folder should be updated */
264 FolderSortKey sort_key;
265 FolderSortType sort_type;
271 PrefsAccount *account;
279 PrefsFolderItem * prefs;
283 FolderSortKey sort_key;
284 FolderSortType sort_type;
287 guint hide_read_msgs : 1; /* CLAWS */
288 guint ret_rcpt : 1; /* CLAWS */
291 Folder *folder_new (FolderType type,
294 void folder_local_folder_init (Folder *folder,
297 void folder_remote_folder_init (Folder *folder,
301 void folder_destroy (Folder *folder);
302 void folder_local_folder_destroy (LocalFolder *lfolder);
303 void folder_remote_folder_destroy(RemoteFolder *rfolder);
305 FolderItem *folder_item_new (Folder *folder,
308 void folder_item_append (FolderItem *parent,
310 void folder_item_remove (FolderItem *item);
311 void folder_item_destroy (FolderItem *item);
313 void folder_set_ui_func (Folder *folder,
316 void folder_set_name (Folder *folder,
318 void folder_tree_destroy (Folder *folder);
320 void folder_add (Folder *folder);
322 GList *folder_get_list (void);
323 gint folder_read_list (void);
324 void folder_write_list (void);
325 void folder_scan_tree (Folder *folder);
326 FolderItem *folder_create_folder(FolderItem *parent, const gchar *name);
327 void folder_update_op_count (void);
328 void folder_func_to_all_folders (FolderItemFunc function,
330 void folder_count_total_msgs (guint *new,
335 Folder *folder_find_from_path (const gchar *path);
336 Folder *folder_find_from_name (const gchar *name,
338 FolderItem *folder_find_item_from_path (const gchar *path);
339 gchar *folder_get_identifier (Folder *folder);
340 gchar *folder_item_get_identifier (FolderItem *item);
341 FolderItem *folder_find_item_from_identifier (const gchar *identifier);
343 Folder *folder_get_default_folder (void);
344 FolderItem *folder_get_default_inbox (void);
345 FolderItem *folder_get_default_outbox (void);
346 FolderItem *folder_get_default_draft (void);
347 FolderItem *folder_get_default_queue (void);
348 FolderItem *folder_get_default_trash (void);
349 FolderItem *folder_get_default_processing (void);
350 void folder_set_missing_folders (void);
351 void folder_unref_account_all (PrefsAccount *account);
353 gchar *folder_get_path (Folder *folder);
354 gchar *folder_item_get_path (FolderItem *item);
356 gint folder_item_open (FolderItem *item);
357 void folder_item_close (FolderItem *item);
358 gint folder_item_scan (FolderItem *item);
359 void folder_item_scan_foreach (GHashTable *table);
360 MsgInfo *folder_item_get_msginfo (FolderItem *item,
362 MsgInfo *folder_item_get_msginfo_by_msgid(FolderItem *item,
364 GSList *folder_item_get_msg_list (FolderItem *item);
365 gchar *folder_item_fetch_msg (FolderItem *item,
367 gint folder_item_add_msg (FolderItem *dest,
369 gboolean remove_source);
370 gint folder_item_move_to (FolderItem *src,
372 FolderItem **new_item);
373 gint folder_item_move_msg (FolderItem *dest,
375 gint folder_item_move_msgs_with_dest (FolderItem *dest,
377 gint folder_item_copy_msg (FolderItem *dest,
379 gint folder_item_copy_msgs_with_dest (FolderItem *dest,
381 gint folder_item_remove_msg (FolderItem *item,
383 gint folder_item_remove_msgs (FolderItem *item,
385 gint folder_item_remove_all_msg (FolderItem *item);
386 gboolean folder_item_is_msg_changed (FolderItem *item,
388 gchar *folder_item_get_cache_file (FolderItem *item);
389 gchar *folder_item_get_mark_file (FolderItem *item);
390 gchar * folder_item_get_identifier(FolderItem * item);
392 GHashTable *folder_persist_prefs_new (Folder *folder);
393 void folder_persist_prefs_free (GHashTable *pptable);
394 const PersistPrefs *folder_get_persist_prefs
395 (GHashTable *pptable, const char *name);
397 void folder_item_restore_persist_prefs (FolderItem *item, GHashTable *pptable);
398 void folder_clean_cache_memory ();
399 void folder_item_write_cache (FolderItem *item);
400 void folder_item_set_default_flags (FolderItem *dest, MsgFlags *flags);
402 void folder_item_apply_processing (FolderItem *item);
404 void folder_update_item (FolderItem *item,
405 gboolean contentchange);
406 void folder_update_items_when_required (gboolean contentchange);
407 void folder_update_item_recursive (FolderItem *item,
408 gboolean update_summary);
409 gint folder_item_update_callback_register(FolderItemUpdateFunc func,
411 void folder_item_update_callback_unregister(gint id);
413 #endif /* __FOLDER_H__ */