|  |  |  | Evolution-Data-Server Manual: Utilities (libedataserver) |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
struct EAccountList; enum e_account_find_t; EAccountList * e_account_list_new (GConfClient *client); void e_account_list_construct (EAccountList *account_list,GConfClient *client); void e_account_list_save (EAccountList *account_list); void e_account_list_add (EAccountList *account_list,EAccount *account); void e_account_list_change (EAccountList *account_list,EAccount *account); void e_account_list_remove (EAccountList *account_list,EAccount *account); const EAccount * e_account_list_get_default (EAccountList *account_list); void e_account_list_set_default (EAccountList *account_list,EAccount *account); const EAccount * e_account_list_find (EAccountList *account_list,e_account_find_t type,const gchar *key); void e_account_list_prune_proxies (EAccountList *account_list); void e_account_list_remove_account_proxies (EAccountList *account_list,EAccount *account); gboolean e_account_list_account_has_proxies (EAccountList *account_list,EAccount *account);
struct EAccountList;
Contains only private data that should be read and manipulated using the functions below.
typedef enum _e_account_find_t {
	E_ACCOUNT_FIND_NAME,
	E_ACCOUNT_FIND_UID,
	E_ACCOUNT_FIND_ID_NAME,
	E_ACCOUNT_FIND_ID_ADDRESS,
	E_ACCOUNT_FIND_PARENT_UID
} e_account_find_t;
EAccountList *	     e_account_list_new                  (GConfClient *client);
Reads the list of accounts from client and listens for changes.
Will emit account_added, account_changed, and account_removed
signals according to notifications from GConf.
You can modify the list using e_list_append(), e_list_remove(), and
e_iterator_delete(). After adding, removing, or changing accounts,
you must call e_account_list_save() to push the changes back to
GConf.
| 
 | a GConfClient | 
| Returns : | the list of accounts | 
void e_account_list_construct (EAccountList *account_list,GConfClient *client);
void                e_account_list_save                 (EAccountList *account_list);
Saves account_list to GConf. Signals will be emitted for changes.
| 
 | an EAccountList | 
void e_account_list_add (EAccountList *account_list,EAccount *account);
Adds account to account_list and emits the
"account-added" signal.
| 
 | an EAccountList | 
| 
 | an EAccount | 
void e_account_list_change (EAccountList *account_list,EAccount *account);
Emits the "account-changed" signal.
| 
 | an EAccountList | 
| 
 | an EAccount | 
void e_account_list_remove (EAccountList *account_list,EAccount *account);
Removes account from account list, and emits the
"account-removed" signal.  If account was the default
account, then the first account in account_list becomes the new default.
| 
 | an EAccountList | 
| 
 | an EAccount | 
const EAccount *    e_account_list_get_default          (EAccountList *account_list);
Get the default EAccount. If no default is specified, or the default has become stale, then the first account is made the default.
| 
 | an EAccountList | 
| Returns : | the default EAccount, or NULLif no accounts are defined. | 
void e_account_list_set_default (EAccountList *account_list,EAccount *account);
Set the account to be the default account in account_list.
| 
 | an EAccountList | 
| 
 | an EAccount | 
const EAccount * e_account_list_find (EAccountList *account_list,e_account_find_t type,const gchar *key);
Perform a search of account_list on a single key.
type must be set from one of the following search types:
E_ACCOUNT_FIND_NAME - Find an account by account name.
E_ACCOUNT_FIND_ID_NAME - Find an account by the owner's identity name.
E_ACCOUNT_FIND_ID_ADDRESS - Find an account by the owner's identity address.
| 
 | an EAccountList | 
| 
 | type of search | 
| 
 | the search key | 
| Returns : | The account or NULLif it doesn't exist. | 
void e_account_list_remove_account_proxies (EAccountList *account_list,EAccount *account);
gboolean e_account_list_account_has_proxies (EAccountList *account_list,EAccount *account);
"account-added" signalvoid                user_function                      (EAccountList *eaccountlist,
                                                        EAccount     *arg1,
                                                        gpointer      user_data)         : Run Last
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"account-changed" signalvoid                user_function                      (EAccountList *eaccountlist,
                                                        EAccount     *arg1,
                                                        gpointer      user_data)         : Run Last
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"account-removed" signalvoid                user_function                      (EAccountList *eaccountlist,
                                                        EAccount     *arg1,
                                                        gpointer      user_data)         : Run Last
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. |