X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fmodest-tny-msg.h;h=5166b88ebb1ecacb324aa62fe5343d22df97be5e;hp=1a696a05728ae8be818e6a2b18a7560ef219a00c;hb=f12789961e471f75c7ba2461e7420262c6023376;hpb=b94b783d9801be57422fdf478ae5bdafbc7200a7 diff --git a/src/modest-tny-msg.h b/src/modest-tny-msg.h index 1a696a0..5166b88 100644 --- a/src/modest-tny-msg.h +++ b/src/modest-tny-msg.h @@ -31,6 +31,75 @@ #define __MODEST_TNY_MSG_H__ /** + * ModestTnyMsgForwardType: + * + * How the original message will be forwarded to the recipient + */ +typedef enum _ModestTnyMsgForwardType { + MODEST_TNY_MSG_FORWARD_TYPE_INLINE = 1, + MODEST_TNY_MSG_FORWARD_TYPE_ATTACHMENT +} ModestTnyMsgForwardType; + +/** + * ModestTnyMsgReplyType: + * + * How the original message will be forwarded to the recipient + */ +typedef enum _ModestTnyMsgReplyType { + MODEST_TNY_MSG_REPLY_TYPE_CITE = 1, + MODEST_TNY_MSG_REPLY_TYPE_QUOTE +} ModestTnyMsgReplyType; + +/** + * ModestTnyMsgReplyMode: + * + * Who will be the recipients of the replied message + */ +typedef enum _ModestTnyMsgReplyMode { + MODEST_TNY_MSG_REPLY_MODE_SENDER, + MODEST_TNY_MSG_REPLY_MODE_LIST, + MODEST_TNY_MSG_REPLY_MODE_ALL +} ModestTnyMsgReplyMode; + +/** + * modest_tny_msg_new: + * @mailto: recipient for the message + * @mailfrom: sender of this message + * @cc: Cc: address for the message + * @bcc: Bcc: address for the message + * @subject: subject for the messdage + * @body: body for the message + * @attachments: a list of attachments (local URIs) + * + * create a new TnyMsg with the given parameters + * + * Returns: a new TnyMsg (free with g_object_unref) + */ +TnyMsg* modest_tny_msg_new (const gchar* mailto, const gchar* mailfrom, const gchar *cc, + const gchar *bcc, const gchar* subject, const gchar *body, + GSList *attachments); + +/** + * modest_tny_msg_new_html_plain: + * @mailto: recipient for the message + * @mailfrom: sender of this message + * @cc: Cc: address for the message + * @bcc: Bcc: address for the message + * @subject: subject for the message + * @html_body: body for the message in HTML + * @plain_body: body for the message in plain text + * @attachments: a list of attachments (local URIs) + * + * create a new TnyMsg with the given parameters + * + * Returns: a new TnyMsg (free with g_object_unref) + */ +TnyMsg* modest_tny_msg_new_html_plain (const gchar* mailto, const gchar* mailfrom, const gchar *cc, + const gchar *bcc, const gchar* subject, + const gchar *html_body, const gchar *plain_body, + GSList *attachments); + +/** * modest_tny_msg_find_body_part: * @self: a message * @want_html: prefer HTML-part when there are multiple body parts? @@ -40,7 +109,7 @@ * * Returns: the TnyMsgMimePart for the found part, or NULL if no matching part is found */ -TnyMimePart *modest_tny_msg_find_body_part (TnyMsg * self, gboolean want_html); +TnyMimePart* modest_tny_msg_find_body_part (TnyMsg * self, gboolean want_html); /** @@ -54,6 +123,42 @@ TnyMimePart *modest_tny_msg_find_body_part (TnyMsg * self, gboolean want_html); * Returns: the body of the message as text, or NULL if it is not found * the text should be freed with **/ -gchar* modest_tny_msg_get_body (TnyMsg *self, gboolean want_html); +gchar* modest_tny_msg_get_body (TnyMsg *self, gboolean want_html); + + +/** + * modest_tny_msg_create_forward_msg: + * @msg: a valid #TnyMsg instance + * @from: the sender of the forwarded mail + * @signature: signature to attach to the reply + * @forward_type: the type of formatting used to create the forwarded message + * + * Creates a forwarded message from an existing one + * + * Returns: a new #TnyMsg, or NULL in case of error + **/ +TnyMsg* modest_tny_msg_create_forward_msg (TnyMsg *msg, + const gchar *from, + const gchar *signature, + ModestTnyMsgForwardType forward_type); + +/** + * modest_tny_msg_create_reply_msg: + * @msg: a valid #TnyMsg instance + * @from: the sender of the forwarded mail + * @signature: signature to add to the reply message + * @reply_type: the type of formatting used to create the reply message + * @reply_mode: the mode of reply: to the sender only, to a mail list or to all + * + * Creates a new message to reply to an existing one + * + * Returns: Returns: a new #TnyMsg, or NULL in case of error + **/ +TnyMsg* modest_tny_msg_create_reply_msg (TnyMsg *msg, + const gchar *from, + const gchar *signature, + ModestTnyMsgReplyType reply_type, + ModestTnyMsgReplyMode reply_mode); + #endif /* __MODEST_TNY_MSG_H__ */