Top | ![]() |
![]() |
![]() |
![]() |
EDataBook * | e_data_book_new () |
struct _EBookBackend * | e_data_book_ref_backend () |
GDBusConnection * | e_data_book_get_connection () |
const gchar * | e_data_book_get_object_path () |
gboolean | e_data_book_set_locale () |
void | e_data_book_respond_open () |
void | e_data_book_respond_refresh () |
void | e_data_book_respond_create_contacts () |
void | e_data_book_respond_modify_contacts () |
void | e_data_book_respond_remove_contacts () |
void | e_data_book_respond_get_contact () |
void | e_data_book_respond_get_contact_list () |
void | e_data_book_respond_get_contact_list_uids () |
void | e_data_book_report_error () |
void | e_data_book_report_backend_property_changed () |
gchar * | e_data_book_string_slist_to_comma_string () |
This class communicates with EBookClients over the bus and accesses an EBookBackend to satisfy client requests.
EDataBook * e_data_book_new (struct _EBookBackend *backend
,GDBusConnection *connection
,const gchar *object_path
,GError **error
);
Creates a new EDataBook and exports the AddressBook D-Bus interface
on connection
at object_path
. The EDataBook handles incoming remote
method invocations and forwards them to the backend
. If the AddressBook
interface fails to export, the function sets error
and returns NULL
.
backend |
an EBookBackend. |
[type EBookBackend] |
connection |
a GDBusConnection |
|
object_path |
object path for the D-Bus interface |
|
error |
return location for a GError, or |
struct _EBookBackend *
e_data_book_ref_backend (EDataBook *book
);
Returns the EBookBackend to which incoming remote method invocations are being forwarded.
The returned EBookBackend is referenced for thread-safety and should
be unreferenced with g_object_unref()
when finished with it.
Since: 3.10
GDBusConnection *
e_data_book_get_connection (EDataBook *book
);
Returns the GDBusConnection on which the AddressBook D-Bus interface is exported.
Since: 3.8
const gchar *
e_data_book_get_object_path (EDataBook *book
);
Returns the object path at which the AddressBook D-Bus interface is exported.
Since: 3.8
gboolean e_data_book_set_locale (EDataBook *book
,const gchar *locale
,GCancellable *cancellable
,GError **error
);
Set's the locale for this addressbook, this can result in renormalization of locale sensitive data.
book |
an EDataBook |
|
locale |
the new locale to set for this book |
|
cancellable |
a GCancellable. |
[allow-none] |
error |
a location to store any error which might occur. |
[allow-none] |
Since: 3.12
void e_data_book_respond_open (EDataBook *book
,guint32 opid
,GError *error
);
Notifies listeners of the completion of the open method call.
book |
An EDataBook |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
void e_data_book_respond_refresh (EDataBook *book
,guint32 opid
,GError *error
);
Notifies listeners of the completion of the refresh method call.
book |
An EDataBook |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
Since: 3.2
void e_data_book_respond_create_contacts (EDataBook *book
,guint32 opid
,GError *error
,const GSList *contacts
);
Finishes a call to create a list contacts.
Since: 3.4
void e_data_book_respond_modify_contacts (EDataBook *book
,guint32 opid
,GError *error
,const GSList *contacts
);
Finishes a call to modify a list of contacts.
Since: 3.4
void e_data_book_respond_remove_contacts (EDataBook *book
,guint32 opid
,GError *error
,const GSList *ids
);
Finishes a call to remove a list of contacts.
book |
An EDataBook |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
|
ids |
A list of removed contact UID-s, or |
[allow-none][element-type utf8] |
Since: 3.4
void e_data_book_respond_get_contact (EDataBook *book
,guint32 opid
,GError *error
,const EContact *contact
);
Notifies listeners of the completion of the get_contact method call.
Only one of error
and contact
can be set.
void e_data_book_respond_get_contact_list (EDataBook *book
,guint32 opid
,GError *error
,const GSList *contacts
);
Finishes a call to get list of EContact, which satisfy certain criteria.
Since: 3.2
void e_data_book_respond_get_contact_list_uids (EDataBook *book
,guint32 opid
,GError *error
,const GSList *uids
);
Finishes a call to get list of UIDs which satisfy certain criteria.
book |
An EDataBook |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
|
uids |
A list of picked UIDs, or |
[allow-none][element-type utf8] |
Since: 3.2
void e_data_book_report_error (EDataBook *book
,const gchar *message
);
Notifies the clients about an error, which happened out of any client-initiate operation.
Since: 3.2
void e_data_book_report_backend_property_changed (EDataBook *book
,const gchar *prop_name
,const gchar *prop_value
);
Notifies the clients about a property change.
book |
An EDataBook |
|
prop_name |
Property name which changed |
|
prop_value |
The new property value |
Since: 3.2
gchar *
e_data_book_string_slist_to_comma_string
(const GSList *strings
);
Takes a list of strings and converts it to a comma-separated string of
values; free returned pointer with g_free()
Since: 3.2