Top | ![]() |
![]() |
![]() |
![]() |
ESourceList * e_source_list_new_for_gconf (GConfClient *client
,const gchar *path
);
ESourceList *
e_source_list_new_for_gconf_default (const gchar *path
);
ESourceGroup * e_source_list_peek_group_by_uid (ESourceList *list
,const gchar *uid
);
ESourceGroup * e_source_list_peek_group_by_base_uri (ESourceList *list
,const gchar *base_uri
);
Returns the first ESourceGroup having the given base URI.
The base URI is usually just the URI scheme, such as "http://".
If no such group is present in list
, the function returns NULL
.
Since 2.28
ESourceGroup * e_source_list_peek_group_by_properties (ESourceList *list
,const gchar *property_name
,...
);
Peeks group by its properties. Parameters are pairs of strings property_name, property_value, terminated by NULL! ESourceGroup is returned only if matches all the properties. Values are compared case insensitively.
Since 2.28
ESource * e_source_list_peek_source_by_uid (ESourceList *list
,const gchar *uid
);
ESource *
e_source_list_peek_default_source (ESourceList *list
);
Attempts to find a default ESource in list
by looking for
a source with a property named "default", or else a source with a
property named "system". If no such ESource exists, the function
returns NULL
.
Since 2.32
gboolean e_source_list_add_group (ESourceList *list
,ESourceGroup *group
,gint position
);
gboolean e_source_list_remove_group (ESourceList *list
,ESourceGroup *group
);
Removes the first ESourceGroup with a unique ID matching group
(possibly group
itself) from list
. The function returns TRUE
if a
matching group was found, otherwise FALSE
.
gboolean e_source_list_remove_group_by_uid (ESourceList *list
,const gchar *uid
);
Removes the first ESourceGroup with the given unique ID from list
.
The function returns TRUE
if a matching group was found, otherwise
FALSE
.
ESourceGroup * e_source_list_ensure_group (ESourceList *list
,const gchar *name
,const gchar *base_uri
,gboolean ret_it
);
Ensures an ESourceGroup with the given base URI exists in list
, and
renames its to the given name. If ret_it
is TRUE
, the matching group
will be returned and should be unreferenced with g_object_unref()
.
list |
an ESourceList |
|
name |
a localized group name |
|
base_uri |
a group base URI |
|
ret_it |
whether to return the group |
Since 2.28
gboolean e_source_list_remove_group_by_base_uri (ESourceList *list
,const gchar *base_uri
);
Removes the first ESourceGroup having the given base URI from list
.
The base URI is usually just the URI scheme, such as "http://". The
function returns TRUE
if a matching group was found, otherwise FALSE
.
Since 2.28
gboolean e_source_list_remove_source_by_uid (ESourceList *list
,const gchar *uid
);
Removes the first ESource with the given unique ID from list
. The
function returns TRUE
if a matching source was found, otherwise FALSE
.
gboolean e_source_list_sync (ESourceList *list
,GError **error
);
Writes the contents of list
to GConf. If an error occurs, such as
the GConf daemon not responding, the function sets error
and returns
FALSE
.
gboolean
e_source_list_is_gconf_updated (ESourceList *list
);
Returns TRUE
if the GConf data for list
is up-to-date, FALSE
if
e_source_list_sync()
should be called.
“changed”
signalvoid user_function (ESourceList *esourcelist, gpointer user_data)
Flags: Run Last
“group-added”
signalvoid user_function (ESourceList *esourcelist, ESourceGroup *arg1, gpointer user_data)
Flags: Run Last
“group-removed”
signalvoid user_function (ESourceList *esourcelist, ESourceGroup *arg1, gpointer user_data)
Flags: Run Last