X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;f=src%2Fmodest-mail-operation.h;h=23884793f95c9ab18ac20c9929e23de46919d6c8;hb=785b875268eefe1b1ac5af5360c17b5f769baa34;hp=f646929892eb76d2b7ff50cf7df0e0e054e1328d;hpb=10135c887c0c30ddefa85716b06d3e5795a17651;p=modest diff --git a/src/modest-mail-operation.h b/src/modest-mail-operation.h index f646929..2388479 100644 --- a/src/modest-mail-operation.h +++ b/src/modest-mail-operation.h @@ -32,8 +32,8 @@ #include #include -#include #include +#include G_BEGIN_DECLS @@ -76,6 +76,9 @@ typedef enum { MODEST_MAIL_OPERATION_TYPE_INFO, MODEST_MAIL_OPERATION_TYPE_RUN_QUEUE, MODEST_MAIL_OPERATION_TYPE_SYNC_FOLDER, + MODEST_MAIL_OPERATION_TYPE_SHUTDOWN, + MODEST_MAIL_OPERATION_TYPE_QUEUE_WAKEUP, + MODEST_MAIL_OPERATION_TYPE_UPDATE_FOLDER_COUNTS, MODEST_MAIL_OPERATION_TYPE_UNKNOWN, } ModestMailOperationTypeOperation; @@ -228,6 +231,20 @@ typedef void (*CreateFolderUserCallback) (ModestMailOperation *mail_op, TnyFolder *new_folder, gpointer user_data); +/** + * SyncFolderCallback: + * + * @self: a #ModestMailOperation + * @folder: the #TnyFolder to sync + * @user_data: generic data passed to user defined function. + * + * This is the callback of the sync_folder operation. + */ +typedef void (*SyncFolderCallback) (ModestMailOperation *self, + TnyFolder *folder, + gpointer user_data); + + /* This struct represents the internal state of a mail operation in a given time */ typedef struct { @@ -378,6 +395,8 @@ void modest_mail_operation_send_new_mail (ModestMailOperation *self, const gchar *html_body, const GList *attachments_list, const GList *images_list, + const gchar *references, + const gchar *in_reply_to, TnyHeaderFlags priority_flags); @@ -417,6 +436,8 @@ void modest_mail_operation_save_to_drafts (ModestMailOperation *self, const GList *attachments_list, const GList *images_list, TnyHeaderFlags priority_flags, + const gchar *references, + const gchar *in_reply_to, SaveToDraftstCallback callback, gpointer user_data); /** @@ -450,10 +471,20 @@ void modest_mail_operation_update_account (ModestMailOperation *self, const gchar *account_name, gboolean poke_all, gboolean interactive, - RetrieveAllCallback retrieve_all_cb, UpdateAccountCallback callback, gpointer user_data); +/** + * modest_mail_operation_update_folder_counts: + * @self: a #ModestMailOperation + * @account_name: the id of a Modest account + * + * Asynchronously refreshes the folder counts of the given store + * account. + */ +void modest_mail_operation_update_folder_counts (ModestMailOperation *self, + const gchar *account_name); + /* Functions that perform store operations */ /** @@ -574,39 +605,44 @@ void modest_mail_operation_xfer_msgs (ModestMailOperation *self, gpointer user_data); /** - * modest_mail_operation_remove_msg: - * @self: a #ModestMailOperation - * @header: the #TnyHeader of the message to move - * @remove_to_trash: TRUE to move it to trash or FALSE to delete it - * permanently - * - * Deletes a message. This operation is synchronous, so the - * #ModestMailOperation should not be added to any - * #ModestMailOperationQueue - **/ -void modest_mail_operation_remove_msg (ModestMailOperation *self, - TnyHeader *header, - gboolean remove_to_trash); - -/** - * modest_mail_operation_remove_msg: + * modest_mail_operation_remove_msgs: * @self: a #ModestMailOperation * @headers: the #TnyList of the messages to delete * @remove_to_trash: TRUE to move it to trash or FALSE to delete it * permanently * - * Deletes a list of messages. This operation is synchronous, so the - * #ModestMailOperation should not be added to any - * #ModestMailOperationQueue + * Deletes a list of messages. **/ void modest_mail_operation_remove_msgs (ModestMailOperation *self, TnyList *headers, gboolean remove_to_trash); /** + * modest_mail_operation_get_msg_and_parts: + * @self: a #ModestMailOperation + * @header_list: the #TnyHeader of the message to get + * @progress_feedback: a #gboolean. If %TRUE, we'll get progress bar feedback. + * @user_callback: a #GetMsgAsyncUserCallback function to call after tinymail callback execution. + * @user_data: generic user data which will be passed to @user_callback function. + * + * Gets a message from header using an user defined @callback function + * pased as argument. This operation is asynchronous, so the + * #ModestMailOperation should be added to #ModestMailOperationQueue + * + * This operation also retrieves to cache all parts of the message. This is needed for + * forward operation. + **/ +void modest_mail_operation_get_msg_and_parts (ModestMailOperation *self, + TnyHeader *header, + TnyList *parts, + gboolean progress_feedback, + GetMsgAsyncUserCallback user_callback, + gpointer user_data); +/** * modest_mail_operation_get_msg: * @self: a #ModestMailOperation * @header_list: the #TnyHeader of the message to get + * @progress_feedback: a #gboolean. If %TRUE, we'll get progress bar feedback. * @user_callback: a #GetMsgAsyncUserCallback function to call after tinymail callback execution. * @user_data: generic user data which will be passed to @user_callback function. * @@ -615,10 +651,30 @@ void modest_mail_operation_remove_msgs (ModestMailOperation *self, * #ModestMailOperation should be added to #ModestMailOperationQueue **/ void modest_mail_operation_get_msg (ModestMailOperation *self, - TnyHeader *header, + TnyHeader *header, + gboolean progress_feedback, GetMsgAsyncUserCallback user_callback, gpointer user_data); /** + * modest_mail_operation_find_msg: + * @self: a #ModestMailOperation + * @msg_uid: a string + * @progress_feedback: a #gboolean. If %TRUE, we'll get progress bar feedback. + * @user_callback: a #GetMsgAsyncUserCallback function to call after tinymail callback execution. + * @user_data: generic user data which will be passed to @user_callback function. + * + * Gets a message from a uid using an user defined @callback function + * pased as argument. This operation is asynchronous, so the + * #ModestMailOperation should be added to #ModestMailOperationQueue + **/ +void modest_mail_operation_find_msg (ModestMailOperation *self, + TnyFolder *folder, + const gchar *msg_uid, + gboolean progress_feedback, + GetMsgAsyncUserCallback user_callback, + gpointer user_data); + +/** * modest_mail_operation_get_msgs_full: * @self: a #ModestMailOperation * @header_list: a #TnyList of #TnyHeader objects to get and process @@ -649,6 +705,18 @@ void modest_mail_operation_run_queue (ModestMailOperation *self, ModestTnySendQueue *queue); /** + * modest_mail_operation_queue_wakeup: + * @self: a #ModestMailOperation + * @queue: a #ModestTnySendQueue + * + * This mail operation is special. It should be running every time the send queue + * wakeup is running and we should notify end of the operation + * after wakeup has done msg-sent notification. + */ +void modest_mail_operation_queue_wakeup (ModestMailOperation *self, + ModestTnySendQueue *queue); + +/** * modest_mail_operation_sync_folder: * @self: a #ModestMailOperation * @folder: a #TnyFolder @@ -658,7 +726,20 @@ void modest_mail_operation_run_queue (ModestMailOperation *self, * running while we do that sync operation. */ void modest_mail_operation_sync_folder (ModestMailOperation *self, - TnyFolder *folder, gboolean expunge); + TnyFolder *folder, + gboolean expunge, + SyncFolderCallback callback, + gpointer user_data); + +/** + * modest_mail_operation_shutdown: + * @self: a #ModestMailOperation + * @account_store: a #ModestTnyAccountStore + * + * disconnects all accounts in the account store (doing the proper syncs). + */ +void modest_mail_operation_shutdown (ModestMailOperation *self, + ModestTnyAccountStore *account_store); /* Functions to control mail operations */ /**