* check for a valid foldername
[modest] / src / modest-account-mgr.h
index 65a8322..acbef4a 100644 (file)
@@ -49,7 +49,6 @@ G_BEGIN_DECLS
 typedef struct _ModestAccountMgr      ModestAccountMgr;
 typedef struct _ModestAccountMgrClass ModestAccountMgrClass;
 
-
 struct _ModestAccountMgr {
         GObject parent;
 };
@@ -57,11 +56,22 @@ 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 gchar* key, 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,
                                    gpointer user_data);
+
+       void (* account_busy_changed)   (ModestAccountMgr *obj, 
+                                        const gchar* account,
+                                        gboolean busy,
+                                        gpointer user_data);   
 };
 
 /**
@@ -108,6 +118,7 @@ gboolean        modest_account_mgr_add_account    (ModestAccountMgr *self,
  * @self: a ModestAccountMgr instance
  * @name: name (id) of the account, which is a valid UTF8 string that does not contain '/'
  * @hostname: the hostname
+ * @portnumber: the portnumber, or 0 for default
  * @username: the username
  * @password: the password
  * @proto:    the protocol (imap, smtp, ...) used for this account
@@ -122,11 +133,12 @@ gboolean        modest_account_mgr_add_account    (ModestAccountMgr *self,
 gboolean modest_account_mgr_add_server_account    (ModestAccountMgr *self,
                                                   const gchar *name,
                                                   const gchar *hostname,
+                                                  const guint portnumber,
                                                   const gchar *username,
                                                   const gchar *password,
-                                                  ModestProtocol proto,
-                                                  ModestSecureConnection security,
-                                                  ModestSecureAuthentication auth);
+                                                  ModestTransportStoreProtocol proto,
+                                                  ModestConnectionProtocol security,
+                                                  ModestAuthProtocol auth);
 
 
 /**
@@ -142,14 +154,13 @@ gboolean modest_account_mgr_add_server_account    (ModestAccountMgr *self,
  */
 gboolean modest_account_mgr_add_server_account_uri    (ModestAccountMgr *self,
                                                       const gchar *name,
-                                                      ModestProtocol proto,
+                                                      ModestTransportStoreProtocol proto,
                                                       const gchar* uri);
 
 /**
  * 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
@@ -160,9 +171,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:
@@ -174,30 +183,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);
 
-
 /**
- * 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_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,
-                                                    ModestProtocol     proto);
+void           modest_account_mgr_free_account_names    (GSList *account_names);
+                                                         
 
 /**
  * modest_account_mgr_account_exists:
@@ -421,6 +420,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__ */