Top | ![]() |
![]() |
![]() |
![]() |
|
e_data_book_error_quark () |
|
e_data_book_create_error () |
|
e_data_book_create_error_fmt () |
const |
e_data_book_status_to_string () |
|
e_data_book_new () |
struct _EBookBackend * | e_data_book_ref_backend () |
|
e_data_book_get_connection () |
const |
e_data_book_get_object_path () |
|
e_data_book_set_locale () |
|
e_data_book_respond_open () |
|
e_data_book_respond_refresh () |
|
e_data_book_respond_create_contacts () |
|
e_data_book_respond_remove_contacts () |
|
e_data_book_respond_modify_contacts () |
|
e_data_book_respond_get_contact () |
|
e_data_book_respond_get_contact_list () |
|
e_data_book_respond_get_contact_list_uids () |
|
e_data_book_report_error () |
|
e_data_book_report_backend_property_changed () |
|
e_data_book_string_slist_to_comma_string () |
This class communicates with
GError * e_data_book_create_error (EDataBookStatus status
,const
);gchar *custom_msg
status |
EDataBookStatus code |
|
custom_msg |
Custom message to use for the error. When NULL,
then uses a default message based on the |
NULL, when the status
is E_DATA_BOOK_STATUS_SUCCESS,
or a newly allocated GError, which should be freed
with g_error_free()
Since: 2.32
GError * e_data_book_create_error_fmt (EDataBookStatus status
,const
,gchar *custom_msg_fmt...
);
Similar as e_data_book_create_error()
, only here, instead of custom_msg,
is used a printf()
status |
||
custom_msg_fmt |
Custom message to use for the error. When NULL,
then uses a default message based on the |
|
... |
arguments for the |
Since: 2.32
constgchar * e_data_book_status_to_string (EDataBookStatus status
);
Get localized human readable description of the given status code.
Since: 2.32
EDataBook * e_data_book_new (struct _EBookBackend *backend
,,
GDBusConnection *connectionconst
,gchar *object_path);
GError **error
Creates a new connection
at object_path
. The backend
. If the AddressBook
interface fails to export, the function sets error
and returns NULL
backend |
an EBookBackend |
|
connection |
a |
|
object_path |
object path for the D-Bus interface |
|
error |
return location for a |
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()
Since: 3.10
GDBusConnection * e_data_book_get_connection ();
EDataBook *book
Returns the
Since: 3.8
constgchar * 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 *bookconst
,gchar *locale,
GCancellable *cancellable);
GError **error
Set's the locale for this addressbook, this can result in renormalization of locale sensitive data.
book |
an |
|
locale |
the new locale to set for this book |
|
cancellable |
a |
[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.
void e_data_book_respond_refresh (,
EDataBook *book,
guint32 opid);
GError *error
Notifies listeners of the completion of the refresh method call.
book |
An |
|
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 *errorconst
);GSList *contacts
Finishes a call to create a list contacts.
book |
An |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
|
contacts |
A list of created |
[allow-none][element-type EContact] |
Since: 3.4
void e_data_book_respond_remove_contacts (,
EDataBook *book,
guint32 opid,
GError *errorconst
);GSList *ids
Finishes a call to remove a list of contacts.
book |
An |
|
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 gchar *] |
Since: 3.4
void e_data_book_respond_modify_contacts (,
EDataBook *book,
guint32 opid,
GError *errorconst
);GSList *contacts
Finishes a call to modify a list of contacts.
book |
An |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
|
contacts |
A list of modified |
[allow-none][element-type EContact] |
Since: 3.4
void e_data_book_respond_get_contact (,
EDataBook *book,
guint32 opid,
GError *errorconst
);gchar *vcard
Notifies listeners of the completion of the get_contact method call.
Only one of error
and vcard
can be set.
void e_data_book_respond_get_contact_list (,
EDataBook *book,
guint32 opid,
GError *errorconst
);GSList *cards
Finishes a call to get list of vCards which satisfy certain criteria.
book |
An |
|
opid |
An operation ID |
|
error |
Operation error, if any, automatically freed if passed it |
|
cards |
A list of vCard strings, or |
[allow-none][element-type gchar *] |
Since: 3.2
void e_data_book_respond_get_contact_list_uids (,
EDataBook *book,
guint32 opid,
GError *errorconst
);GSList *uids
Finishes a call to get list of UIDs which satisfy certain criteria.
book |
An |
|
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 gchar *] |
Since: 3.2
void e_data_book_report_error (,
EDataBook *bookconst
);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 *bookconst
,gchar *prop_nameconst
);gchar *prop_value
Notifies the clients about a property change.
book |
An |
|
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