X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fwidgets%2Fmodest-msg-view-window.h;h=bad28f4e3ec21591c7219eba4e4f1a654b2a9051;hp=9249d19af5b3fe4b38bb18fe28345766d3b3383b;hb=8f4797391e5962158a0a085646f1d24da887ee3d;hpb=5a5108804dcac3687462958bd3ca208694e0e9a4 diff --git a/src/widgets/modest-msg-view-window.h b/src/widgets/modest-msg-view-window.h index 9249d19..bad28f4 100644 --- a/src/widgets/modest-msg-view-window.h +++ b/src/widgets/modest-msg-view-window.h @@ -31,8 +31,14 @@ #define __MODEST_MSG_VIEW_WINDOW_H__ #include +#include +#ifdef MODEST_TOOLKIT_HILDON2 +#include +#endif #include +#include #include +#include G_BEGIN_DECLS @@ -46,13 +52,29 @@ G_BEGIN_DECLS typedef struct { - ModestWindow parent; +#ifdef MODEST_TOOLKIT_HILDON2 + ModestHildon2Window parent; +#else + ModestWindow parent; +#endif } ModestMsgViewWindow; typedef struct { +#ifdef MODEST_TOOLKIT_HILDON2 + ModestHildon2WindowClass parent_class; +#else ModestWindowClass parent_class; - /* insert signal callback declarations, eg. */ - /* void (* my_event) (ModestEditMsgWindow* obj); */ +#endif + + void (*msg_changed) (ModestMsgViewWindow *self, + GtkTreeModel *model, + GtkTreeRowReference *row_reference, + gpointer user_data); + + gboolean (*scroll_child) (ModestMsgViewWindow *self, + GtkScrollType scroll_type, + gboolean horizontal, + gpointer userdata); } ModestMsgViewWindowClass; /** @@ -66,39 +88,140 @@ GType modest_msg_view_window_get_type (void) G_GNUC_CONST; /** - * modest_msg_view_window_new: + * modest_msg_view_window_new_for_attachment: * @msg: an #TnyMsg instance - * @account: the account name + * @modest_account_name: the account name + * @mailbox: the mailbox (if any) * - * instantiates a new #ModestMsgViewWindow widget. The account name is used to + * instantiates a new #ModestMsgViewWindow widget to view a message that is an + * attachment in another message. + * The account name is used to + * set the proper account when choosing reply/forward from the msg view window + * + * Returns: a new #ModestMsgViewWindow, or NULL in case of error + */ +ModestWindow* modest_msg_view_window_new_for_attachment (TnyMsg *msg, + const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid); + +/** + * modest_msg_view_window_new_with_other_body: + * @msg: an #TnyMsg instance + * @modest_account_name: the account name + * @mailbox: the mailbox (if any) + * + * instantiates a new #ModestMsgViewWindow widget to view a message that is a different body + * in another message. + * The account name is used to * set the proper account when choosing reply/forward from the msg view window * * Returns: a new #ModestMsgViewWindow, or NULL in case of error */ -ModestWindow* modest_msg_view_window_new (TnyMsg *msg, const gchar *account); +ModestWindow* modest_msg_view_window_new_with_other_body (TnyMsg *msg, + TnyMimePart *other_body, + const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid); + +/** + * modest_msg_view_window_is_other_body: + * @self: a #ModestMsgViewWindow + * + * tells if the view window is showing other body + * + * Returns: %TRUE if showing "not first body" + */ +gboolean modest_msg_view_window_is_other_body (ModestMsgViewWindow *self); /** * modest_msg_view_window_new_with_header_model: * @msg: an #TnyMsg instance - * @account: the account name + * @modest_account_name: the account name + * @mailbox: the mailbox (if any) * @model: a #GtkTreeModel, with the format used by #ModestHeaderView - * @iter: a #GtkTreeIter, pointing to the position of @msg in @model. + * @row_reference: a #GtkTreeRowReference, pointing to the position of @msg in @model. * * instantiates a new #ModestMsgViewWindow widget. The account name is used to * set the proper account when choosing reply/forward from the msg view window. * This constructor also passes a reference to the @model of the header view - * to allow selecting previous/next messages. + * to allow selecting previous/next messages in the message list when appropriate. * * Returns: a new #ModestMsgViewWindow, or NULL in case of error */ -ModestWindow* modest_msg_view_window_new_with_header_model (TnyMsg *msg, const gchar *account, GtkTreeModel *model, GtkTreeIter iter); +ModestWindow* modest_msg_view_window_new_with_header_model (TnyMsg *msg, + const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid, + GtkTreeModel *model, + GtkTreeRowReference *row_reference); +/** + * modest_msg_view_window_new_from_header_view: + * @header_view: an #ModestHeaderView instance + * @modest_account_name: the account name + * @mailbox: the mailbox (if any) + * @msg_uid: the initial uid reserved by this window + * @row_reference: a #GtkTreeRowReference, pointing to the selected position @model. + * + * instantiates a new #ModestMsgViewWindow widget. The account name is used to + * set the proper account when choosing reply/forward from the msg view window. + * It's different from new_with_header_model, as it creates the window and then + * loads the message in that window. + * + * Returns: a new #ModestMsgViewWindow, or NULL in case of error + */ +ModestWindow* modest_msg_view_window_new_from_header_view (ModestHeaderView *header_view, + const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid, + GtkTreeRowReference *row_reference); + + +/** + * modest_msg_view_window_new_from_uid: + */ +ModestWindow * +modest_msg_view_window_new_from_uid (const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid); + +/** + * modest_msg_view_window_new_for_search_result: + * @msg: an #TnyMsg instance + * @modest_account_name: the account name + * + * instantiates a new #ModestMsgViewWindow widget. The account name is used to + * set the proper account when choosing reply/forward from the msg view window. + * This constructor marks the window as being for a search result, which should + * cause some UI to be disabled, such as the previous/next buttons. + * + * Returns: a new #ModestMsgViewWindow, or NULL in case of error + */ +ModestWindow * +modest_msg_view_window_new_for_search_result (TnyMsg *msg, + const gchar *modest_account_name, + const gchar *mailbox, + const gchar *msg_uid); + +/** + * modest_msg_view_window_get_header: + * @window: an #ModestMsgViewWindow instance + * + * get the message header in this msg view. Header instance is get + * from tree_model of headers list. + * + * Returns: a new #TnyHeader instance, or NULL in case of error + */ +TnyHeader* +modest_msg_view_window_get_header (ModestMsgViewWindow *self); /** * modest_msg_view_window_get_message: * @window: an #ModestMsgViewWindow instance * - * get the message in this msg view + * get a new reference to the message in this msg view. The caller + * must free this new reference * * Returns: a new #TnyMsg instance, or NULL in case of error */ @@ -138,12 +261,152 @@ gboolean modest_msg_view_window_select_next_message (ModestMsgViewWindow gboolean modest_msg_view_window_select_previous_message (ModestMsgViewWindow *window); /** - * modest_msg_view_window_toggle_fullscreen: + * modest_msg_view_window_view_attachment: + * @window: a #ModestMsgViewWindow + * @mime_part: a #TnyMimePart + * + * Opens @mime_part, or the currently selected attachment if @mime_part is %NULL. + * If it's a message, it opens it for viewing. Otherwise it opens a temporary file + * with the contents of the attachment. + */ +void modest_msg_view_window_view_attachment (ModestMsgViewWindow *window, + TnyMimePart *mime_part); + +/** + * modest_msg_view_window_get_attachments: + * @window: a #ModestMsgViewWindow + * + * Get selected attachments from #ModetMsgView private object. + */ +TnyList * modest_msg_view_window_get_attachments (ModestMsgViewWindow *win); + +/** + * modest_msg_view_window_save_attachments: + * @window: a #ModestMsgViewWindow + * @mime_parts: a #TnyList of #TnyMimePart + * + * Save the #TnyMimePart attachments in @mime_parts, or currently selected attachments + * if @mime_parts is %NULL, offering a dialog to the user to choose the location. + */ +void modest_msg_view_window_save_attachments (ModestMsgViewWindow *window, + TnyList *mime_parts); + +/** + * modest_msg_view_window_remove_attachments: + * @window: a #ModestMsgViewWindow + * @get_all: a #gboolean. If %TRUE, purges all attachmnents, if %FALSE, + * purges only selected ones. + * + * Removes selected attachments. + */ +void modest_msg_view_window_remove_attachments (ModestMsgViewWindow *window, + gboolean get_all); + + +/** + * modest_msg_view_window_toolbar_on_transfer_mode: + * @window: a #ModestMsgViewWindow + * + * Check if toolbar is in transfer mode, which determines whether a + * transfer operation is being processed. + */ +gboolean modest_msg_view_window_toolbar_on_transfer_mode (ModestMsgViewWindow *self); + + +/** + * modest_msg_view_window_last_message_selected: + * @window: a #ModestMsgViewWindow + * + * Check message currently viewed is the last message into folder . +*/ +gboolean modest_msg_view_window_last_message_selected (ModestMsgViewWindow *window); + + +/** + * modest_msg_view_window_first_message_selected: + * @window: a #ModestMsgViewWindow + * + * Check message currently viewed is the last message into folder . +*/ +gboolean modest_msg_view_window_first_message_selected (ModestMsgViewWindow *window); + +/** + * modest_msg_view_window_has_headers_model: + * @window: a #ModestMsgViewWindow + * + * Check if window has been created with a full headers model. +*/ +gboolean modest_msg_view_window_has_headers_model (ModestMsgViewWindow *window); + +/** + * modest_msg_view_window_is_search_result: + * @window: a #ModestMsgViewWindow + * + * Check if window has been created to show a search result. + */ +gboolean modest_msg_view_window_is_search_result (ModestMsgViewWindow *window); + + +/** + * modest_msg_view_window_get_folder_type: + * @window: a #ModestMsgViewWindow + * + * Gets folder type of message currently viewed . +*/ +TnyFolderType +modest_msg_view_window_get_folder_type (ModestMsgViewWindow *window); + +/** + * modest_msg_view_window_transfer_mode_enabled: * @window: a #ModestMsgViewWindow * - * toggles the current fullscreen status + * Determines if some transfer operation is in progress. + * + * Returns: TRUE if transfer mode is enabled, FASE otherwise. +*/ +gboolean +modest_msg_view_window_transfer_mode_enabled (ModestMsgViewWindow *self); + +/** + * modest_msg_view_window_add_to_contacts: + * @self: a #ModestMsgViewWindow + * + * activates the add to contacts use case. In Diablo and gnome it gets the + * clipboard selection current value and tries to add it to the addressbook. + * In fremantle, it shows the add to contacts dialog to select the recipient + * to add. */ -void modest_msg_view_window_toggle_fullscreen (ModestMsgViewWindow *window); +void +modest_msg_view_window_add_to_contacts (ModestMsgViewWindow *self); + +/** + * modest_msg_view_window_get_msg_view: + * @self: a #ModestMsgViewWindow + * + * Tells that external images should be fetched in this window. + */ +void +modest_msg_view_window_fetch_images (ModestMsgViewWindow *self); + +/** + * modest_msg_view_window_has_blocked_external_images: + * @self: a #ModestMsgViewWindow + * + * checks if the msg currently shown has blocked external images. + * + * Returns: %TRUE if external images are blocked, %FALSE otherwise + */ +gboolean modest_msg_view_window_has_blocked_external_images (ModestMsgViewWindow *self); + +/** + * modest_msg_view_window_reload: + * @self: a #ModestMsgViewWindow + * + * Reloads currently loaded message. This is intended to show the message in case it + * has some update on the previously visible result. + */ +void modest_msg_view_window_reload (ModestMsgViewWindow *self); + G_END_DECLS #endif /* __MODEST_MSG_VIEW_WINDOW_H__ */