aboutsummaryrefslogtreecommitdiffstats
path: root/camel/camel-folder.h
diff options
context:
space:
mode:
Diffstat (limited to 'camel/camel-folder.h')
-rw-r--r--camel/camel-folder.h62
1 files changed, 46 insertions, 16 deletions
diff --git a/camel/camel-folder.h b/camel/camel-folder.h
index cc9eaeb5ed..c4ddf71276 100644
--- a/camel/camel-folder.h
+++ b/camel/camel-folder.h
@@ -139,9 +139,9 @@ typedef struct {
gboolean (*is_open) (CamelFolder *folder,
CamelException *ex);
- CamelFolder * (*get_folder) (CamelFolder *folder,
- const gchar *folder_name,
- CamelException *ex);
+ CamelFolder * (*get_subfolder) (CamelFolder *folder,
+ const gchar *folder_name,
+ CamelException *ex);
gboolean (*create) (CamelFolder *folder,
CamelException *ex);
@@ -168,9 +168,9 @@ typedef struct {
void (*expunge) (CamelFolder *folder,
CamelException *ex);
- CamelMimeMessage * (*get_message) (CamelFolder *folder,
- gint number,
- CamelException *ex);
+ CamelMimeMessage * (*get_message_by_number) (CamelFolder *folder,
+ gint number,
+ CamelException *ex);
gint (*get_message_count) (CamelFolder *folder,
CamelException *ex);
@@ -207,7 +207,10 @@ GtkType camel_folder_get_type (void);
/* public methods */
-CamelFolder *camel_folder_get_folder (CamelFolder *folder,
+
+
+
+CamelFolder *camel_folder_get_subfolder (CamelFolder *folder,
gchar *folder_name,
CamelException *ex);
@@ -228,36 +231,63 @@ void camel_folder_close_async (CamelFolder *folder,
CamelException *ex);
gboolean camel_folder_create (CamelFolder *folder, CamelException *ex);
-gboolean camel_folder_delete (CamelFolder *folder, gboolean recurse, CamelException *ex);
-gboolean camel_folder_delete_messages (CamelFolder *folder, CamelException *ex);
CamelFolder *camel_folder_get_parent_folder (CamelFolder *folder, CamelException *ex);
CamelStore *camel_folder_get_parent_store (CamelFolder *folder, CamelException *ex);
-CamelFolderOpenMode camel_folder_get_mode (CamelFolder *folder, CamelException *ex);
GList *camel_folder_list_subfolders (CamelFolder *folder, CamelException *ex);
+
+
+/* delete operations */
+gboolean camel_folder_delete (CamelFolder *folder, gboolean recurse, CamelException *ex);
+gboolean camel_folder_delete_messages (CamelFolder *folder, CamelException *ex);
GList *camel_folder_expunge (CamelFolder *folder, gboolean want_list, CamelException *ex);
+
+
+/* folder name manipulation operations */
void camel_folder_set_name (CamelFolder *folder,
const gchar *name,
CamelException *ex);
-
const gchar *camel_folder_get_name (CamelFolder *folder, CamelException *ex);
-/* void camel_folder_set_full_name (CamelFolder *folder, const gchar *name); */
const gchar *camel_folder_get_full_name (CamelFolder *folder, CamelException *ex);
-CamelMimeMessage *camel_folder_get_message (CamelFolder *folder, gint number, CamelException *ex);
+
+
+/* various properties accessors */
gboolean camel_folder_exists (CamelFolder *folder, CamelException *ex);
-gint camel_folder_get_message_count (CamelFolder *folder, CamelException *ex);
-gint camel_folder_append_message (CamelFolder *folder, CamelMimeMessage *message, CamelException *ex);
const GList *camel_folder_list_permanent_flags (CamelFolder *folder, CamelException *ex);
-void camel_folder_copy_message_to (CamelFolder *folder, CamelMimeMessage *message, CamelFolder *dest_folder, CamelException *ex);
+CamelFolderOpenMode camel_folder_get_mode (CamelFolder *folder, CamelException *ex);
+
+
+
+/* message manipulation */
+gint camel_folder_append_message (CamelFolder *folder,
+ CamelMimeMessage *message, CamelException *ex);
+void camel_folder_copy_message_to (CamelFolder *folder,
+ CamelMimeMessage *message,
+ CamelFolder *dest_folder,
+ CamelException *ex);
+
+/* summary related operations */
gboolean camel_folder_has_summary_capability (CamelFolder *folder, CamelException *ex);
CamelFolderSummary *camel_folder_get_summary (CamelFolder *folder, CamelException *ex);
+/* number based access operations */
+CamelMimeMessage *camel_folder_get_message_by_number (CamelFolder *folder,
+ gint number, CamelException *ex);
+gint camel_folder_get_message_count (CamelFolder *folder, CamelException *ex);
+
+
+/* uid based access operations */
gboolean camel_folder_has_uid_capability (CamelFolder *folder, CamelException *ex);
const gchar * camel_folder_get_message_uid (CamelFolder *folder, CamelMimeMessage *message, CamelException *ex);
CamelMimeMessage *camel_folder_get_message_by_uid (CamelFolder *folder, const gchar *uid, CamelException *ex);
GList *camel_folder_get_uid_list (CamelFolder *folder, CamelException *ex);
+
+
+
+
+
#ifdef __cplusplus
}
#endif /* __cplusplus */