* Added new folder dialog

[modest] / src / widgets / modest-folder-view.h

diff --git a/src/widgets/modest-folder-view.h b/src/widgets/modest-folder-view.h
index 19bcd54..76186ce 100644 (file)
--- a/src/widgets/modest-folder-view.h
+++ b/src/widgets/modest-folder-view.h
@@ -57,13 +57,14 @@ struct _ModestFolderViewClass {
        GtkTreeViewClass parent_class;
 
        /* emitted when a folder is selected or unselected */
-       void (*folder_selection_changed) (ModestFolderView* self,
-                                         TnyFolder *folder,
-                                         gboolean selected,
-                                         gpointer user_data);
-       
-       gboolean (*update_model) (ModestFolderView *self, 
-                                 TnyAccountStore *account_store);
+       void     (*folder_selection_changed) (ModestFolderView* self,
+                                             TnyFolder *folder,
+                                             gboolean selected,
+                                             gpointer user_data);
+
+       void     (*folder_display_name_changed) (ModestFolderView* self,
+                                                const gchar *display_name,
+                                                gpointer user_data);
 };
 
 /**
@@ -73,21 +74,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,11 +96,47 @@ 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);
 
 
-/* FIXME: this is ugly */
-const gchar* modest_folder_view_get_selected_account (ModestFolderView *self);
+/**
+ * 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_update_model:
+ * @self: a #ModestFolderView
+ * 
+ * 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_get_selected_display_name:
+ * @self: a #ModestFolderView
+ * 
+ * returns a the display name of the currently selected
+ * #TnyFolder. Note that it could be different to the name returned by
+ * the #TnyFolder that could be get using
+ * modest_folder_view_get_selected, because it for example could
+ * contain the unread messages between brackets
+ * 
+ * Returns: the display name of the currently selected #TnyFolder or
+ * NULL if none is selected
+ **/
+const gchar* modest_folder_view_get_selected_display_name (ModestFolderView *self);
 
 G_END_DECLS