aboutsummaryrefslogtreecommitdiff
path: root/libsylph/folder.h
diff options
context:
space:
mode:
authorhiro <hiro@ee746299-78ed-0310-b773-934348b2243d>2005-09-05 10:00:53 +0000
committerhiro <hiro@ee746299-78ed-0310-b773-934348b2243d>2005-09-05 10:00:53 +0000
commit3bf24b9336184fe9e28f7e09b9c5200a5f82b7d2 (patch)
tree51ccac6f26dcdf9fcfac1a7879477bfde2759b80 /libsylph/folder.h
parent11776e5a524745b01ac145439ac2892a29bd0826 (diff)
moved more modules to libsylph.
git-svn-id: svn://sylpheed.sraoss.jp/sylpheed/trunk@548 ee746299-78ed-0310-b773-934348b2243d
Diffstat (limited to 'libsylph/folder.h')
-rw-r--r--libsylph/folder.h395
1 files changed, 395 insertions, 0 deletions
diff --git a/libsylph/folder.h b/libsylph/folder.h
new file mode 100644
index 00000000..0908e241
--- /dev/null
+++ b/libsylph/folder.h
@@ -0,0 +1,395 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 1999-2005 Hiroyuki Yamamoto
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifndef __FOLDER_H__
+#define __FOLDER_H__
+
+#include <glib.h>
+#include <time.h>
+
+typedef struct _Folder Folder;
+typedef struct _FolderClass FolderClass;
+
+typedef struct _LocalFolder LocalFolder;
+typedef struct _RemoteFolder RemoteFolder;
+#if 0
+typedef struct _MboxFolder MboxFolder;
+typedef struct _MaildirFolder MaildirFolder;
+#endif
+
+typedef struct _FolderItem FolderItem;
+
+#define FOLDER(obj) ((Folder *)obj)
+#define FOLDER_CLASS(obj) (FOLDER(obj)->klass)
+#define FOLDER_TYPE(obj) (FOLDER(obj)->klass->type)
+
+#define LOCAL_FOLDER(obj) ((LocalFolder *)obj)
+#define REMOTE_FOLDER(obj) ((RemoteFolder *)obj)
+
+#define FOLDER_IS_LOCAL(obj) (FOLDER_TYPE(obj) == F_MH || \
+ FOLDER_TYPE(obj) == F_MBOX || \
+ FOLDER_TYPE(obj) == F_MAILDIR)
+
+#if 0
+#define MBOX_FOLDER(obj) ((MboxFolder *)obj)
+#define MAILDIR_FOLDER(obj) ((MaildirFolder *)obj)
+#endif
+
+#define FOLDER_ITEM(obj) ((FolderItem *)obj)
+
+#define FOLDER_ITEM_CAN_ADD(obj) \
+ ((obj) && FOLDER_ITEM(obj)->folder && \
+ FOLDER_ITEM(obj)->path && \
+ (FOLDER_IS_LOCAL(FOLDER_ITEM(obj)->folder) || \
+ FOLDER_TYPE(FOLDER_ITEM(obj)->folder) == F_IMAP) && \
+ !FOLDER_ITEM(obj)->no_select)
+
+typedef enum
+{
+ F_MH,
+ F_MBOX,
+ F_MAILDIR,
+ F_IMAP,
+ F_NEWS,
+ F_UNKNOWN
+} FolderType;
+
+typedef enum
+{
+ F_NORMAL,
+ F_INBOX,
+ F_OUTBOX,
+ F_DRAFT,
+ F_QUEUE,
+ F_TRASH
+} SpecialFolderItemType;
+
+typedef enum
+{
+ SORT_BY_NONE,
+ SORT_BY_NUMBER,
+ SORT_BY_SIZE,
+ SORT_BY_DATE,
+ SORT_BY_FROM,
+ SORT_BY_SUBJECT,
+ SORT_BY_SCORE,
+ SORT_BY_LABEL,
+ SORT_BY_MARK,
+ SORT_BY_UNREAD,
+ SORT_BY_MIME,
+ SORT_BY_TO
+} FolderSortKey;
+
+typedef enum
+{
+ SORT_ASCENDING,
+ SORT_DESCENDING
+} FolderSortType;
+
+typedef void (*FolderUIFunc) (Folder *folder,
+ FolderItem *item,
+ gpointer data);
+typedef void (*FolderDestroyNotify) (Folder *folder,
+ FolderItem *item,
+ gpointer data);
+
+#include "prefs_account.h"
+#include "session.h"
+#include "procmsg.h"
+
+struct _Folder
+{
+ FolderClass *klass;
+
+ gchar *name;
+ PrefsAccount *account;
+
+ FolderItem *inbox;
+ FolderItem *outbox;
+ FolderItem *draft;
+ FolderItem *queue;
+ FolderItem *trash;
+
+ FolderUIFunc ui_func;
+ gpointer ui_func_data;
+
+ GNode *node;
+
+ gpointer data;
+};
+
+struct _FolderClass
+{
+ FolderType type;
+
+ /* virtual functions */
+ Folder * (*folder_new) (const gchar *name,
+ const gchar *path);
+ void (*destroy) (Folder *folder);
+
+ gint (*scan_tree) (Folder *folder);
+ gint (*create_tree) (Folder *folder);
+
+ GSList * (*get_msg_list) (Folder *folder,
+ FolderItem *item,
+ gboolean use_cache);
+ /* return value is locale charset */
+ gchar * (*fetch_msg) (Folder *folder,
+ FolderItem *item,
+ gint num);
+ MsgInfo * (*get_msginfo) (Folder *folder,
+ FolderItem *item,
+ gint num);
+ gint (*add_msg) (Folder *folder,
+ FolderItem *dest,
+ const gchar *file,
+ MsgFlags *flags,
+ gboolean remove_source);
+ gint (*add_msgs) (Folder *folder,
+ FolderItem *dest,
+ GSList *file_list,
+ gboolean remove_source,
+ gint *first);
+ gint (*move_msg) (Folder *folder,
+ FolderItem *dest,
+ MsgInfo *msginfo);
+ gint (*move_msgs) (Folder *folder,
+ FolderItem *dest,
+ GSList *msglist);
+ gint (*copy_msg) (Folder *folder,
+ FolderItem *dest,
+ MsgInfo *msginfo);
+ gint (*copy_msgs) (Folder *folder,
+ FolderItem *dest,
+ GSList *msglist);
+ gint (*remove_msg) (Folder *folder,
+ FolderItem *item,
+ MsgInfo *msginfo);
+ gint (*remove_msgs) (Folder *folder,
+ FolderItem *item,
+ GSList *msglist);
+ gint (*remove_all_msg) (Folder *folder,
+ FolderItem *item);
+ gboolean (*is_msg_changed) (Folder *folder,
+ FolderItem *item,
+ MsgInfo *msginfo);
+ gint (*close) (Folder *folder,
+ FolderItem *item);
+ gint (*scan) (Folder *folder,
+ FolderItem *item);
+
+ FolderItem * (*create_folder) (Folder *folder,
+ FolderItem *parent,
+ const gchar *name);
+ gint (*rename_folder) (Folder *folder,
+ FolderItem *item,
+ const gchar *name);
+ gint (*move_folder) (Folder *folder,
+ FolderItem *item,
+ FolderItem *new_parent);
+ gint (*remove_folder) (Folder *folder,
+ FolderItem *item);
+};
+
+struct _LocalFolder
+{
+ Folder folder;
+
+ gchar *rootpath;
+};
+
+struct _RemoteFolder
+{
+ Folder folder;
+
+ Session *session;
+};
+
+#if 0
+struct _MboxFolder
+{
+ LocalFolder lfolder;
+};
+
+struct _MaildirFolder
+{
+ LocalFolder lfolder;
+};
+#endif
+
+struct _FolderItem
+{
+ SpecialFolderItemType stype;
+
+ gchar *name; /* UTF-8 */
+ gchar *path; /* UTF-8 */
+
+ time_t mtime;
+
+ gint new;
+ gint unread;
+ gint total;
+ gint unmarked_num;
+
+ gint last_num;
+
+ /* special flags */
+ guint no_sub : 1; /* no child allowed? */
+ guint no_select : 1; /* not selectable? */
+ guint collapsed : 1; /* collapsed item */
+ guint threaded : 1; /* threaded folder view */
+
+ guint opened : 1; /* opened by summary view */
+ guint updated : 1; /* folderview should be updated */
+
+ guint cache_dirty : 1; /* cache file needs to be updated */
+ guint mark_dirty : 1; /* mark file needs to be updated */
+
+ FolderSortKey sort_key;
+ FolderSortType sort_type;
+
+ GNode *node;
+
+ FolderItem *parent;
+
+ Folder *folder;
+
+ PrefsAccount *account;
+
+ gboolean ac_apply_sub;
+
+ gchar *auto_to;
+ gboolean use_auto_to_on_reply;
+ gchar *auto_cc;
+ gchar *auto_bcc;
+ gchar *auto_replyto;
+
+ gboolean trim_summary_subject;
+ gboolean trim_compose_subject;
+
+ GSList *mark_queue;
+
+ gpointer data;
+};
+
+Folder *folder_new (FolderType type,
+ const gchar *name,
+ const gchar *path);
+void folder_local_folder_init (Folder *folder,
+ const gchar *name,
+ const gchar *path);
+void folder_remote_folder_init (Folder *folder,
+ const gchar *name,
+ const gchar *path);
+
+void folder_destroy (Folder *folder);
+void folder_local_folder_destroy (LocalFolder *lfolder);
+void folder_remote_folder_destroy(RemoteFolder *rfolder);
+
+FolderItem *folder_item_new (const gchar *name,
+ const gchar *path);
+void folder_item_append (FolderItem *parent,
+ FolderItem *item);
+void folder_item_remove (FolderItem *item);
+void folder_item_remove_children (FolderItem *item);
+void folder_item_destroy (FolderItem *item);
+
+gint folder_item_compare (FolderItem *item_a,
+ FolderItem *item_b);
+
+void folder_set_ui_func (Folder *folder,
+ FolderUIFunc func,
+ gpointer data);
+void folder_set_name (Folder *folder,
+ const gchar *name);
+void folder_tree_destroy (Folder *folder);
+
+void folder_add (Folder *folder);
+
+GList *folder_get_list (void);
+gint folder_read_list (void);
+void folder_write_list (void);
+
+gchar *folder_get_status (GPtrArray *folders,
+ gboolean full);
+
+Folder *folder_find_from_path (const gchar *path);
+Folder *folder_find_from_name (const gchar *name,
+ FolderType type);
+FolderItem *folder_find_item_from_path (const gchar *path);
+FolderItem *folder_find_child_item_by_name (FolderItem *item,
+ const gchar *name);
+gchar *folder_get_identifier (Folder *folder);
+gchar *folder_item_get_identifier (FolderItem *item);
+FolderItem *folder_find_item_from_identifier (const gchar *identifier);
+
+Folder *folder_get_default_folder (void);
+FolderItem *folder_get_default_inbox (void);
+FolderItem *folder_get_default_outbox (void);
+FolderItem *folder_get_default_draft (void);
+FolderItem *folder_get_default_queue (void);
+FolderItem *folder_get_default_trash (void);
+
+void folder_set_missing_folders (void);
+void folder_unref_account_all (PrefsAccount *account);
+
+/* return value is locale encoded file name */
+gchar *folder_get_path (Folder *folder);
+gchar *folder_item_get_path (FolderItem *item);
+
+gint folder_item_scan (FolderItem *item);
+void folder_item_scan_foreach (GHashTable *table);
+GSList *folder_item_get_msg_list (FolderItem *item,
+ gboolean use_cache);
+/* return value is locale charset */
+gchar *folder_item_fetch_msg (FolderItem *item,
+ gint num);
+gint folder_item_fetch_all_msg (FolderItem *item);
+MsgInfo *folder_item_get_msginfo (FolderItem *item,
+ gint num);
+gint folder_item_add_msg (FolderItem *dest,
+ const gchar *file,
+ MsgFlags *flags,
+ gboolean remove_source);
+gint folder_item_add_msgs (FolderItem *dest,
+ GSList *file_list,
+ gboolean remove_source,
+ gint *first);
+gint folder_item_move_msg (FolderItem *dest,
+ MsgInfo *msginfo);
+gint folder_item_move_msgs (FolderItem *dest,
+ GSList *msglist);
+gint folder_item_copy_msg (FolderItem *dest,
+ MsgInfo *msginfo);
+gint folder_item_copy_msgs (FolderItem *dest,
+ GSList *msglist);
+gint folder_item_remove_msg (FolderItem *item,
+ MsgInfo *msginfo);
+gint folder_item_remove_msgs (FolderItem *item,
+ GSList *msglist);
+gint folder_item_remove_all_msg (FolderItem *item);
+gboolean folder_item_is_msg_changed (FolderItem *item,
+ MsgInfo *msginfo);
+/* return value is locale chaset */
+gchar *folder_item_get_cache_file (FolderItem *item);
+gchar *folder_item_get_mark_file (FolderItem *item);
+
+gint folder_item_close (FolderItem *item);
+
+#endif /* __FOLDER_H__ */