* Changes in the autotools stuff affecting a lot of platform dependent
[modest] / src / widgets / modest-folder-view.h
index f7fdf0c..ed7e973 100644 (file)
 #ifndef __MODEST_FOLDER_VIEW_H__
 #define __MODEST_FOLDER_VIEW_H__
 
-#include <tny-gtk-account-tree-model.h>
-#include <tny-account-store.h>
 #include <glib-object.h>
+#include <tny-gtk-account-list-model.h>
+#include <tny-account-store.h>
+#include <modest-tny-account-store.h>
 
 G_BEGIN_DECLS
 
@@ -44,6 +45,11 @@ G_BEGIN_DECLS
 #define MODEST_IS_FOLDER_VIEW_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE((klass),MODEST_TYPE_FOLDER_VIEW))
 #define MODEST_FOLDER_VIEW_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS((obj),MODEST_TYPE_FOLDER_VIEW,ModestFolderViewClass))
 
+typedef enum _ModestFolderViewStyle {
+       MODEST_FOLDER_VIEW_STYLE_SHOW_ALL,
+       MODEST_FOLDER_VIEW_STYLE_SHOW_ONE
+} ModestFolderViewStyle;
+
 typedef struct _ModestFolderView      ModestFolderView;
 typedef struct _ModestFolderViewClass ModestFolderViewClass;
 
@@ -55,15 +61,16 @@ struct _ModestFolderView {
 struct _ModestFolderViewClass {
        GtkTreeViewClass parent_class;
 
-       /* emitted when a folder is clicked */
-       void (*folder_selected) (ModestFolderView* self,
-                                TnyFolder *folder,
-                                gpointer user_data);
-                                
-       gboolean (*update_model) (ModestFolderView *self, 
-                                 TnyAccountStore *account_store);
-};
+       /* emitted when a folder is selected or unselected */
+       void     (*folder_selection_changed) (ModestFolderView* self,
+                                             TnyFolderStore *folder,
+                                             gboolean selected,
+                                             gpointer user_data);
 
+       void     (*folder_display_name_changed) (ModestFolderView* self,
+                                                const gchar *display_name,
+                                                gpointer user_data);
+};
 
 /**
  * modest_folder_view_get_type:
@@ -72,22 +79,19 @@ struct _ModestFolderViewClass {
  *  
  * Returns: the GType
  */
-GType        modest_folder_view_get_type    (void) G_GNUC_CONST;
+GType        modest_folder_view_get_type        (void) G_GNUC_CONST;
 
 
 
 /**
  * modest_folder_view_new:
- * @account_store: a ModestTnyAccountStore instance
- * @query: a folder store query for the folders to watch
+ * @query: a #TnyFolderStoreQuery that specifies the folders to show
  * 
- * create a new ModestFolderView instance, based on an account store
+ * create a new #ModestFolderView instance
  *  
- * Returns: a new GtkWidget (a GtkTreeView-subclass)
+ * Returns: a new #GtkWidget (a #GtkTreeView subclass)
  */
-GtkWidget* modest_folder_view_new         (ModestTnyAccountStore *account_store,
-                                          TnyFolderStoreQuery *query);
-
+GtkWidget*    modest_folder_view_new            (TnyFolderStoreQuery *query);
 
 /**
  * modest_folder_view_set_title:
@@ -97,23 +101,146 @@ GtkWidget* modest_folder_view_new         (ModestTnyAccountStore *account_store,
  * set the title for the folder view; if title is NULL, the title column
  * header will be hidden
  */
-void  modest_folder_view_set_title (ModestFolderView *self, const gchar *title);
+void          modest_folder_view_set_title       (ModestFolderView *self, 
+                                                 const gchar *title);
 
 
+/**
+ * modest_folder_view_get_selected:
+ * @self: a #ModestFolderView
+ * 
+ * gets a new reference to the #TnyFolderStore that is already
+ * selected. The caller must free this reference
+ * 
+ * Returns: the selected #TnyFolderStore or NULL if none is selected
+ **/
+TnyFolderStore*    modest_folder_view_get_selected    (ModestFolderView *self);
+
 
 /**
- * modest_folder_view_is_empty:
- * @self: a ModestFolderView instance
+ * modest_folder_view_update_model:
+ * @self: a #ModestFolderView
  * 
- * check to see of the view is empty. Note that when it is empty,
- * there will still be one item, telling "(empty)" or similar
- *  
- * Returns: TRUE if the tree view is empty, FALSE otherwise
- */
-gboolean     modest_folder_view_is_empty    (ModestFolderView *self);
+ * refresh the current model
+ * 
+ * Returns: TRUE if the model was succesfully updated
+ **/
+gboolean      modest_folder_view_update_model    (ModestFolderView *self,
+                                                 TnyAccountStore *account_store);
+
+/**
+ * modest_folder_view_set_style:
+ * @self: a #ModestFolderView
+ * @style: a #ModestFolderViewStyle
+ * 
+ * Sets the folder view style. There are currently two available,
+ * MODEST_FOLDER_VIEW_STYLE_SHOW_ALL shows all the active accounts,
+ * and MODEST_FOLDER_VIEW_STYLE_SHOW_ONE (Maemo style) shows the local
+ * account the mmc and only one of the available active server
+ * accounts
+
+ **/
+void         modest_folder_view_set_style         (ModestFolderView *self,
+                                                  ModestFolderViewStyle style);
+
+/**
+ * modest_folder_view_set_account_id_of_visible_server_account:
+ * @self: a #ModestFolderView
+ * @account_id: the remote server account id
+ * 
+ * sets the server account id (value returned by tny_account_get_id())
+ * to the string passed as argument. The remote server with the
+ * specified id will be the unique visible account if the folder view
+ * is configured in MODEST_FOLDER_VIEW_STYLE_SHOW_ONE
+ **/
+void         modest_folder_view_set_account_id_of_visible_server_account (ModestFolderView *self,
+                                                                         const gchar *account_id);
 
+/**
+ * modest_folder_view_get_account_id_of_visible_server_account:
+ * @self: a #ModestFolderView
+ * 
+ * gets the account id of the currently visible server account id
+ * 
+ * Return value: the visible server account id or NULL if none set
+ **/
+const gchar* modest_folder_view_get_account_id_of_visible_server_account (ModestFolderView *self);
+
+
+void         modest_folder_view_select_first_inbox_or_local  (ModestFolderView *self);
+
+/**
+ * modest_folder_view_copy_selection:
+ * @self: a #ModestFolderView
+ * 
+ * Stores a #TnyList of selected folders in the own clibpoard of 
+ * @self folder view.
+ **/
+void modest_folder_view_copy_selection (ModestFolderView *folder_view);
+
+/**
+ * modest_folder_view_cut_selection:
+ * @self: a #ModestFolderView
+ * 
+ * Stores a #TnyList of selected folders in the own clibpoard of 
+ * @self folder view and filter them into folders tree model to
+ * hide these rows in treeview.
+ **/
+void modest_folder_view_cut_selection (ModestFolderView *folder_view);
 
-const gchar* modest_folder_view_get_selected_account (ModestFolderView *self);
+
+/**
+ * modest_folder_view_select_folder
+ * @self: a #ModestFolderView
+ * @folder: a #TnyFolder
+ * @after_change: should we select first change to the view (TRUE), or just now (FALSE)
+ *
+ * select the given TnyFolder in the folder;
+ * return TRUE if it succeeded, FALSE otherwise.
+ **/
+gboolean modest_folder_view_select_folder (ModestFolderView *self, TnyFolder *folder, gboolean after_change);
+
+/**
+ * modest_folder_view_paste_selection:
+ * @self: a #ModestFolderView
+ * @folders: ouput parameter with a #TnyList of folders which will be returned.
+ * @delete: output parameter with indication about delete or not the selected folders. 
+ * 
+ * Gets the selected folders to copy/cut.
+ **/
+void modest_folder_view_paste_selection (ModestFolderView *folder_view, TnyList **folders, gboolean *delete);
+
+/*
+ * modest_folder_view_show_non_move_folders:
+ * @self: a #ModestFolderView
+ * @show: show or hide the folders
+ * 
+ * Whether to show folders where no messages can be moved to 
+ **/
+void modest_folder_view_show_non_move_folders (ModestFolderView *folder_view, gboolean show);
+
+/*
+ * modest_folder_view_copy_model:
+ * @folder_view_src: a #ModestFolderView
+ * @folder_view_dst: a #ModestFolderView
+ * 
+ * Get model from @folder_view_src and builds a new 
+ * #GtkTreeFilterModel object for that model. This copied
+ * model will be asigned to @folder_view_dst. 
+ **/
+void modest_folder_view_copy_model (ModestFolderView *folder_view_src, ModestFolderView *folder_view_dst);
+
+/*
+ * modest_folder_disable_next_folder_selection:
+ * @folder_view: a #ModestFolderView
+ * 
+ * Checks if folder_to_select private field is set and 
+ * unref it in this case, assigning it to NULL to avoid 
+ * next call to on_row_inserted_maybe_select_folder does 
+ * not select any folder.
+ * 
+ **/
+void modest_folder_view_disable_next_folder_selection (ModestFolderView *self);
 
 G_END_DECLS