inital gtk2 patch
[claws.git] / src / folder.h
index fc8f2230d6d5de35c06f92c78c66b4225492f304..7a75f683fc3764a3b2e0bec29db2177f716c2d4c 100644 (file)
@@ -1,6 +1,6 @@
 /*
  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
- * Copyright (C) 1999-2002 Hiroyuki Yamamoto
+ * Copyright (C) 1999-2003 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
@@ -110,11 +110,8 @@ typedef enum
 typedef enum
 {
        FOLDER_TREE_CHANGED = 1 << 0,
-/*
-       maybe enhance with:
-       FOLDER_NEW_FOLDERITEM
-       FOLDER_REMOVE_FOLDERITEM
-*/
+       FOLDER_NEW_FOLDERITEM = 1 << 1,
+       FOLDER_REMOVE_FOLDERITEM = 1 << 2,
 } FolderUpdateFlags;
 
 typedef enum
@@ -192,17 +189,20 @@ struct _FolderClass
                                                 const gchar    *name);
        gint            (*remove_folder)        (Folder         *folder,
                                                 FolderItem     *item);
+       gint            (*close)                (Folder         *folder,
+                                                FolderItem     *item);
        gint            (*get_num_list)         (Folder         *folder,
                                                 FolderItem     *item,
-                                                GSList        **list);
+                                                GSList        **list,
+                                                gboolean       *old_uids_valid);
        void            (*update_mark)          (Folder         *folder,
                                                 FolderItem     *item);
        void            (*finished_copy)        (Folder         *folder,
                                                 FolderItem     *item);
        void            (*finished_remove)      (Folder         *folder,
-                                                FolderItem item);
-       gboolean        (*check_msgnum_validity)(Folder         *folder,
-                                                FolderItem item);
+                                                FolderItem     *item);
+       gboolean        (*scan_required)        (Folder         *folder,
+                                                FolderItem     *item);
 
        /* Message functions */
        MsgInfo         *(*get_msginfo)         (Folder         *folder,
@@ -211,16 +211,25 @@ struct _FolderClass
        GSList          *(*get_msginfos)        (Folder         *folder,
                                                 FolderItem     *item,
                                                 MsgNumberList  *msgnum_list);
-       gchar           *(*fetch_msg)           (Folder         *folder,
+       /* return value is locale charset */
+       gchar           *(*fetch_msg)           (Folder         *folder,
                                                 FolderItem     *item,
                                                 gint            num);
        gint            (*add_msg)              (Folder         *folder,
                                                 FolderItem     *dest,
                                                 const gchar    *file,
-                                               gboolean         remove_source);
+                                                MsgFlags       *flags);
+       gint            (*add_msgs)             (Folder         *folder,
+                                                FolderItem     *dest,
+                                                GSList         *file_list,
+                                                GRelation      *relation);
        gint            (*copy_msg)             (Folder         *folder,
                                                 FolderItem     *dest,
                                                 MsgInfo        *msginfo);
+       gint            (*copy_msgs)            (Folder         *folder,
+                                                FolderItem     *dest,
+                                                MsgInfoList    *msglist,
+                                                GRelation      *relation);
        gint            (*remove_msg)           (Folder         *folder,
                                                 FolderItem     *item,
                                                 gint            num);
@@ -260,8 +269,8 @@ struct _FolderItem
 {
        SpecialFolderItemType stype;
 
-       gchar *name;
-       gchar *path;
+       gchar *name; /* UTF-8 */
+       gchar *path; /* UTF-8 */
 
        time_t mtime;
 
@@ -290,6 +299,8 @@ struct _FolderItem
        FolderSortKey sort_key;
        FolderSortType sort_type;
 
+       GNode *node;
+
        FolderItem *parent;
 
        Folder *folder;
@@ -319,9 +330,7 @@ struct _FolderUpdateData
 {
        Folder                  *folder;
        FolderUpdateFlags        update_flags;
-/*
-       FolderItem              *item
-*/
+       FolderItem              *item;
 };
 
 struct _FolderItemUpdateData
@@ -346,13 +355,14 @@ void        folder_destroy                (Folder         *folder);
 void        folder_local_folder_destroy        (LocalFolder    *lfolder);
 void        folder_remote_folder_destroy(RemoteFolder  *rfolder);
 
-FolderItem *folder_item_new    (Folder         *folder,
-                                const gchar    *name,
-                                const gchar    *path);
-void        folder_item_append (FolderItem     *parent,
-                                FolderItem     *item);
-void        folder_item_remove (FolderItem     *item);
-void        folder_item_destroy        (FolderItem     *item);
+FolderItem *folder_item_new            (Folder         *folder,
+                                        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);
 
 void        folder_set_ui_func (Folder         *folder,
                                 FolderUIFunc    func,
@@ -398,10 +408,11 @@ FolderItem *folder_get_default_processing (void);
 void folder_set_missing_folders                (void);
 void folder_unref_account_all          (PrefsAccount   *account);
 
+/* return value is locale encoded file name */
 gchar *folder_item_get_path            (FolderItem     *item);
 
 gint   folder_item_open                        (FolderItem     *item);
-void   folder_item_close               (FolderItem     *item);
+gint   folder_item_close               (FolderItem     *item);
 gint   folder_item_scan                        (FolderItem     *item);
 void   folder_item_scan_foreach                (GHashTable     *table);
 MsgInfo *folder_item_get_msginfo       (FolderItem     *item,
@@ -409,21 +420,26 @@ MsgInfo *folder_item_get_msginfo  (FolderItem     *item,
 MsgInfo *folder_item_get_msginfo_by_msgid(FolderItem   *item,
                                         const gchar    *msgid);
 GSList *folder_item_get_msg_list       (FolderItem     *item);
+/* return value is locale charset */
 gchar *folder_item_fetch_msg           (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   folder_item_move_to             (FolderItem     *src,
                                         FolderItem     *dest,
                                         FolderItem    **new_item);
 gint   folder_item_move_msg            (FolderItem     *dest,
                                         MsgInfo        *msginfo);
-gint   folder_item_move_msgs_with_dest (FolderItem     *dest,
+gint   folder_item_move_msgs           (FolderItem     *dest,
                                         GSList         *msglist);
 gint   folder_item_copy_msg            (FolderItem     *dest,
                                         MsgInfo        *msginfo);
-gint   folder_item_copy_msgs_with_dest (FolderItem     *dest,
+gint   folder_item_copy_msgs           (FolderItem     *dest,
                                         GSList         *msglist);
 gint   folder_item_remove_msg          (FolderItem     *item,
                                         gint            num);
@@ -435,9 +451,10 @@ void       folder_item_change_msg_flags    (FolderItem     *item,
                                         MsgPermFlags    newflags);
 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);
-gchar * folder_item_get_identifier(FolderItem * item);
+gchar * folder_item_get_identifier     (FolderItem * item);
 
 GHashTable *folder_persist_prefs_new   (Folder *folder);
 void folder_persist_prefs_free         (GHashTable *pptable);