2007-07-31 Philip Van Hoof <pvanhoof@gnome.org>
[modest] / src / modest-account-mgr.h
index 969a0a2..f93a712 100644 (file)
@@ -56,11 +56,24 @@ struct _ModestAccountMgr {
 struct _ModestAccountMgrClass {
        GObjectClass parent_class;
 
-       void (* account_removed)   (ModestAccountMgr *obj, const gchar* account,
-                                   gboolean server_account, gpointer user_data);
-       void (* account_changed)   (ModestAccountMgr *obj, const gchar* account,
-                                   const GSList* keys, gboolean server_account,
+       void (* account_inserted)  (ModestAccountMgr *obj, 
+                                   const gchar* account,
                                    gpointer user_data);
+
+       void (* account_removed)   (ModestAccountMgr *obj, 
+                                   const gchar* account,
+                                   gpointer user_data);
+
+       void (* account_changed)   (ModestAccountMgr *obj, 
+                                   const gchar* account,
+                                   const GSList* key, 
+                                   gboolean server_account,
+                                   gpointer user_data);
+
+       void (* account_busy_changed)   (ModestAccountMgr *obj, 
+                                        const gchar* account,
+                                        gboolean busy,
+                                        gpointer user_data);   
 };
 
 /**
@@ -150,7 +163,6 @@ gboolean modest_account_mgr_add_server_account_uri    (ModestAccountMgr *self,
  * modest_account_mgr_remove_account:
  * @self: a ModestAccountMgr instance
  * @name: the name of the account to remove
- * @server_account: TRUE if the account to remove is a server account
  * @err: a #GError ptr, or NULL to ignore.
  * 
  * remove an existing account. the account with @name should already exist; note
@@ -161,9 +173,7 @@ gboolean modest_account_mgr_add_server_account_uri    (ModestAccountMgr *self,
  * @err gives details in case of error
  */
 gboolean        modest_account_mgr_remove_account         (ModestAccountMgr *self,
-                                                          const gchar* name,
-                                                          gboolean server_account);
-
+                                                          const gchar* name);
 
 /**
  * modest_account_mgr_account_names:
@@ -175,32 +185,20 @@ gboolean        modest_account_mgr_remove_account         (ModestAccountMgr *sel
  * Returns: a newly allocated list of account names, or NULL in case of error or
  * if there are no accounts. The caller must free the returned GSList.
  *
- * TODO: I believe that the caller must free the strings in the GSList items too, 
- * because this is implemented via gconf_client_all_dirs() which also requires a deep free, 
- * though that's not documented. murrayc.
  */
 GSList*                modest_account_mgr_account_names    (ModestAccountMgr *self,
                                                     gboolean only_enabled);
 
-#if 0
-/* Not used. */
 /**
- * modest_account_mgr_search_server_account:
- * @self: a ModestAccountMgr instance
- * @account_name: get only server accounts for @account_name, or NULL for any
- * @type: get only server accounts from protocol type @type, or MODEST_PROTOCOL_TYPE_UNKNOWN
- * @proto: get only server account with protocol @proto, or MODEST_PROTOCOL_TRANSPORT_STORE_UNKNOWN for any
+ * modest_account_mgr_free_account_names:
+ * @account_name: a gslist of account names
  * 
- * List all the server account names, optionally narrowing the result down to one account.
+ * list all account names
  *
- * Returns: a newly allocated list of server account names, or NULL in case of
- * error or if there are no server accounts. The caller must free the returned GSList
+ * free the list of account names
  */
-GSList*  modest_account_mgr_search_server_accounts  (ModestAccountMgr *self,
-                                                    const gchar*       account_name,
-                                                    ModestProtocolType type,
-                                                    ModestTransportStoreProtocol     proto);
-#endif
+void           modest_account_mgr_free_account_names    (GSList *account_names);
+                                                         
 
 /**
  * modest_account_mgr_account_exists:
@@ -424,6 +422,43 @@ gboolean        modest_account_mgr_unset           (ModestAccountMgr *self,
                                                    const gchar *key,
                                                    gboolean server_account);
 
+/**
+ * modest_account_mgr_has_accounts:
+ * @self: a ModestAccountMgr instance
+ * @enabled: TRUE to search for enabled accounts only
+ * 
+ * Checks if any accounts exist
+ *
+ * Returns: TRUE if accounts exist, FALSE otherwise
+ */
+
+gboolean modest_account_mgr_has_accounts (ModestAccountMgr* self, gboolean enabled);
+
+/**
+ * modest_account_mgr_set_account_busy
+ * @self: a ModestAccountMgr instance
+ * @account_name: name of the account
+ * @busy: whether to set busy or not busy
+ * 
+ * Changes the busy flag of an account
+ *
+ */
+
+void modest_account_mgr_set_account_busy(ModestAccountMgr* self, const gchar* account_name, 
+                                                                                                                                               gboolean busy);
+
+/**
+ * modest_account_mgr_account_is_busy
+ * @self: a ModestAccountMgr instance
+ * @account_name: name of the account
+ * 
+ * Returns: If the account is currently busy or not
+ *
+ */
+gboolean
+modest_account_mgr_account_is_busy(ModestAccountMgr* self, const gchar* account_name);
+
+
 G_END_DECLS
 
 #endif /* __MODEST_ACCOUNT_MGR_H__ */