X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fwidgets%2Fmodest-msg-view-window.h;h=d2c9f0bcc2477dea5a25a1e9036b736abc437e6d;hp=8a8877ac3a9800ccccbfbf50109e6ccad1a3e6b6;hb=87596c5aa5517ac7ba37e50664a969fcaaea72f9;hpb=1e269a39bd6e1c33e72e98b72f59f810d8f64e8a diff --git a/src/widgets/modest-msg-view-window.h b/src/widgets/modest-msg-view-window.h index 8a8877a..d2c9f0b 100644 --- a/src/widgets/modest-msg-view-window.h +++ b/src/widgets/modest-msg-view-window.h @@ -51,8 +51,11 @@ typedef struct { typedef struct { ModestWindowClass parent_class; - /* insert signal callback declarations, eg. */ - /* void (* my_event) (ModestEditMsgWindow* obj); */ + + void (*msg_changed) (ModestMsgViewWindow *self, + GtkTreeModel *model, + GtkTreeRowReference *row_reference, + gpointer user_data); } ModestMsgViewWindowClass; /** @@ -75,7 +78,9 @@ GType modest_msg_view_window_get_type (void) G_GNUC_CONST; * * 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 (TnyMsg *msg, + const gchar *account, + const gchar *msg_uid); /** * modest_msg_view_window_new_with_header_model: @@ -91,18 +96,57 @@ ModestWindow* modest_msg_view_window_new (TnyMsg *msg, const gchar *ac * * 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 *account, + const gchar *msg_uid, + GtkTreeModel *model, + GtkTreeRowReference *row_reference); + +/** + * 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 */ -TnyMsg* modest_msg_view_window_get_message (ModestMsgViewWindow *window); +TnyMsg* modest_msg_view_window_get_message (ModestMsgViewWindow *window); + +/** + * modest_msg_view_window_get_message_uid: + * @msg: an #ModestMsgViewWindow instance + * + * gets the unique identifier for the message in this msg view. The + * returned value *must* not be freed + * + * Returns: the id of the #TnyMsg being shown, or NULL in case of error + */ +const gchar* modest_msg_view_window_get_message_uid (ModestMsgViewWindow *window); + +/** + * modest_msg_view_window_select_first_message: + * @window: a #ModestMsgViewWindow instance + * + * select the first message obtained from the header view this view + * was called from + * + * Returns: %TRUE if a new message is shown. + */ +gboolean modest_msg_view_window_select_first_message (ModestMsgViewWindow *window); /** * modest_msg_view_window_select_next_message: @@ -126,6 +170,112 @@ 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: + * @window: a #ModestMsgViewWindow + * + * toggles the current fullscreen status + */ +void modest_msg_view_window_toggle_fullscreen (ModestMsgViewWindow *window); + +/** + * 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. + */ +GList * modest_msg_view_window_get_attachments (ModestMsgViewWindow *win); + +/** + * modest_msg_view_window_save_attachments: + * @window: a #ModestMsgViewWindow + * @mime_parts: a #GList 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, + GList *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_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 + * + * 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); + G_END_DECLS #endif /* __MODEST_MSG_VIEW_WINDOW_H__ */