#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;
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);
};
/**
*
* 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:
* modest_folder_view_get_selected:
* @self: a #ModestFolderView
*
- * returns a new reference to the #TnyFolder that is already selected
+ * gets a new reference to the #TnyFolderStore that is already
+ * selected. The caller must free this reference
*
- * Returns: the selected folder or NULL if none is selected
+ * Returns: the selected #TnyFolderStore or NULL if none is selected
**/
-TnyFolder* modest_folder_view_get_selected (ModestFolderView *self);
+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);
+
+
+/**
+ * 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);
+
G_END_DECLS
#endif /* __MODEST_FOLDER_VIEW_H__ */