| Evolution API Reference: libedataserver, utility library | ||||
|---|---|---|---|---|
EAccountList;
enum e_account_find_t;
EAccountList* e_account_list_new (GConfClient *gconf);
void e_account_list_construct (EAccountList *account_list,
GConfClient *gconf);
void e_account_list_save (EAccountList *account_list);
void e_account_list_add (EAccountList *,
EAccount *);
void e_account_list_change (EAccountList *,
EAccount *);
void e_account_list_remove (EAccountList *,
EAccount *);
const EAccount* e_account_list_get_default (EAccountList *);
void e_account_list_set_default (EAccountList *,
EAccount *);
const EAccount* e_account_list_find (EAccountList *,
e_account_find_t type,
const char *key);
void e_account_list_prune_proxies (EAccountList *);
void e_account_list_remove_account_proxies
(EAccountList *,
EAccount *);
int e_account_list_account_has_proxies (EAccountList *,
EAccount *);
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 *gconf);
Reads the list of accounts from gconf 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.
gconf : |
a GConfClient |
| Returns : | the list of accounts |
void e_account_list_construct (EAccountList *account_list, GConfClient *gconf);
account_list : |
|
gconf : |
void e_account_list_save (EAccountList *account_list);
Saves account_list to GConf. Signals will be emitted for changes.
account_list : |
an EAccountList |
void e_account_list_add (EAccountList *, EAccount *);
Add an account to the account list. Will emit the account-changed event.
Param1 : |
|
Param2 : |
void e_account_list_change (EAccountList *, EAccount *);
Signal that the details of an account have changed.
Param1 : |
|
Param2 : |
void e_account_list_remove (EAccountList *, EAccount *);
Remove an account from the account list, and emit the account-removed signal. If the account was the default account, then reset the default to the first account.
Param1 : |
|
Param2 : |
const EAccount* e_account_list_get_default (EAccountList *);
Get the default account. If no default is specified, or the default has become stale, then the first account is made the default.
Param1 : |
|
| Returns : | The account or NULL if no accounts are defined. |
void e_account_list_set_default (EAccountList *, EAccount *);
Set the account account to be the default account.
Param1 : |
|
Param2 : |
const EAccount* e_account_list_find (EAccountList *, e_account_find_t type, const char *key);
Perform a search of the 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.
Param1 : |
|
type : |
Type of search. |
key : |
Search key. |
| Returns : | The account or NULL if it doesn't exist. |
void e_account_list_remove_account_proxies
(EAccountList *,
EAccount *);
Param1 : |
|
Param2 : |
int e_account_list_account_has_proxies (EAccountList *, EAccount *);
Param1 : |
|
Param2 : |
|
| Returns : |
"account-added" signalvoid user_function (EAccountList *eaccountlist, EAccount *arg1, gpointer user_data) : Run Last
eaccountlist : |
the object which received the signal. |
arg1 : |
|
user_data : |
user data set when the signal handler was connected. |
"account-changed" signalvoid user_function (EAccountList *eaccountlist, EAccount *arg1, gpointer user_data) : Run Last
eaccountlist : |
the object which received the signal. |
arg1 : |
|
user_data : |
user data set when the signal handler was connected. |
"account-removed" signalvoid user_function (EAccountList *eaccountlist, EAccount *arg1, gpointer user_data) : Run Last
eaccountlist : |
the object which received the signal. |
arg1 : |
|
user_data : |
user data set when the signal handler was connected. |