1
<!-- ##### SECTION Title ##### -->
4
<!-- ##### SECTION Short_Description ##### -->
5
The primary Evolution addressbook client object.
7
<!-- ##### SECTION Long_Description ##### -->
9
Represents a complete addressbook. Event notifications and callbacks go to the
10
#EBookListener. Contrast with #EBookView, which represents a search of the addressbook.
13
<!-- ##### SECTION See_Also ##### -->
18
<!-- ##### SECTION Stability_Level ##### -->
21
<!-- ##### SECTION Image ##### -->
24
<!-- ##### STRUCT EBook ##### -->
26
#EBook has no publicly available members.
30
<!-- ##### SIGNAL EBook::auth-required ##### -->
32
Authentication is required to access this source. You should call
33
#e_book_authenticate_user or #e_book_async_authenticate_user.
36
@ebook: the object which received the signal.
38
<!-- ##### SIGNAL EBook::backend-died ##### -->
40
The backend for this address book has died.
43
@ebook: the object which received the signal.
45
<!-- ##### SIGNAL EBook::connection-status ##### -->
47
The connection status for this book is being reported.
50
@ebook: the object which received the signal.
51
@arg1: #TRUE if the connection is online, #FALSE otherwise.
53
<!-- ##### SIGNAL EBook::writable-status ##### -->
55
The writable status for this book is being reported.
58
@ebook: the object which received the signal.
59
@arg1: #TRUE if the book is writable, #FALSE otherwise.
61
<!-- ##### FUNCTION e_book_new ##### -->
71
<!-- ##### FUNCTION e_book_new_default_addressbook ##### -->
80
<!-- ##### FUNCTION e_book_new_from_uri ##### -->
90
<!-- ##### FUNCTION e_book_new_system_addressbook ##### -->
99
<!-- ##### FUNCTION e_book_set_default_addressbook ##### -->
109
<!-- ##### FUNCTION e_book_set_default_source ##### -->
119
<!-- ##### FUNCTION e_book_remove ##### -->
129
<!-- ##### FUNCTION e_book_open ##### -->
140
<!-- ##### FUNCTION e_book_get_supported_fields ##### -->
151
<!-- ##### FUNCTION e_book_get_supported_auth_methods ##### -->
162
<!-- ##### FUNCTION e_book_get_required_fields ##### -->
173
<!-- ##### FUNCTION e_book_get_source ##### -->
182
<!-- ##### FUNCTION e_book_is_online ##### -->
191
<!-- ##### FUNCTION e_book_is_opened ##### -->
200
<!-- ##### FUNCTION e_book_authenticate_user ##### -->
213
<!-- ##### FUNCTION e_book_get_contact ##### -->
225
<!-- ##### FUNCTION e_book_remove_contact ##### -->
236
<!-- ##### FUNCTION e_book_remove_contacts ##### -->
247
<!-- ##### FUNCTION e_book_add_contact ##### -->
258
<!-- ##### FUNCTION e_book_commit_contact ##### -->
269
<!-- ##### FUNCTION e_book_get_book_view ##### -->
283
<!-- ##### FUNCTION e_book_get_contacts ##### -->
295
<!-- ##### FUNCTION e_book_get_changes ##### -->
307
<!-- ##### FUNCTION e_book_free_change_list ##### -->
315
<!-- ##### FUNCTION e_book_get_uri ##### -->
324
<!-- ##### FUNCTION e_book_get_static_capabilities ##### -->
334
<!-- ##### FUNCTION e_book_check_static_capability ##### -->
344
<!-- ##### FUNCTION e_book_is_writable ##### -->
353
<!-- ##### FUNCTION e_book_cancel ##### -->
363
<!-- ##### FUNCTION e_book_cancel_async_op ##### -->
373
<!-- ##### FUNCTION e_book_get_self ##### -->
384
<!-- ##### FUNCTION e_book_set_self ##### -->
395
<!-- ##### FUNCTION e_book_is_self ##### -->
404
<!-- ##### FUNCTION e_book_get_addressbooks ##### -->
409
@addressbook_sources:
414
<!-- ##### MACRO e_return_error_if_fail ##### -->
423
<!-- ##### MACRO e_return_async_error_if_fail ##### -->
432
<!-- ##### MACRO e_return_async_error_val_if_fail ##### -->
441
<!-- ##### MACRO e_return_ex_async_error_if_fail ##### -->
450
<!-- ##### MACRO e_return_ex_async_error_val_if_fail ##### -->
459
<!-- ##### USER_FUNCTION EBookAsyncCallback ##### -->
469
<!-- ##### USER_FUNCTION EBookOpenProgressCallback ##### -->
480
<!-- ##### USER_FUNCTION EBookIdAsyncCallback ##### -->
491
<!-- ##### USER_FUNCTION EBookContactAsyncCallback ##### -->
502
<!-- ##### USER_FUNCTION EBookListAsyncCallback ##### -->
513
<!-- ##### USER_FUNCTION EBookBookViewAsyncCallback ##### -->
524
<!-- ##### USER_FUNCTION EBookEListAsyncCallback ##### -->
535
<!-- ##### USER_FUNCTION EBookCallback ##### -->
545
<!-- ##### USER_FUNCTION EBookOpenProgressCallback ##### -->
556
<!-- ##### USER_FUNCTION EBookIdCallback ##### -->
567
<!-- ##### USER_FUNCTION EBookEListCallback ##### -->
578
<!-- ##### USER_FUNCTION EBookListCallback ##### -->
589
<!-- ##### USER_FUNCTION EBookContactCallback ##### -->
600
<!-- ##### USER_FUNCTION EBookBookViewCallback ##### -->
611
<!-- ##### FUNCTION e_book_open_async ##### -->
623
<!-- ##### FUNCTION e_book_remove_async ##### -->
634
<!-- ##### FUNCTION e_book_get_supported_fields_async ##### -->
645
<!-- ##### FUNCTION e_book_get_supported_auth_methods_async ##### -->
656
<!-- ##### FUNCTION e_book_authenticate_user_async ##### -->
670
<!-- ##### FUNCTION e_book_get_contact_async ##### -->
682
<!-- ##### FUNCTION e_book_get_contacts_async ##### -->
694
<!-- ##### FUNCTION e_book_remove_contact_async ##### -->
706
<!-- ##### FUNCTION e_book_remove_contact_by_id_async ##### -->
718
<!-- ##### FUNCTION e_book_remove_contacts_async ##### -->
730
<!-- ##### FUNCTION e_book_add_contact_async ##### -->
742
<!-- ##### FUNCTION e_book_commit_contact_async ##### -->
754
<!-- ##### FUNCTION e_book_get_book_view_async ##### -->
768
<!-- ##### FUNCTION e_book_get_changes_async ##### -->
780
<!-- ##### FUNCTION e_book_get_required_fields_async ##### -->
791
<!-- ##### FUNCTION e_book_async_open ##### -->
803
<!-- ##### FUNCTION e_book_async_remove ##### -->
814
<!-- ##### FUNCTION e_book_async_get_supported_fields ##### -->
825
<!-- ##### FUNCTION e_book_async_get_supported_auth_methods ##### -->
836
<!-- ##### FUNCTION e_book_async_authenticate_user ##### -->
850
<!-- ##### FUNCTION e_book_async_get_contact ##### -->
862
<!-- ##### FUNCTION e_book_async_get_contacts ##### -->
874
<!-- ##### FUNCTION e_book_async_remove_contact ##### -->
886
<!-- ##### FUNCTION e_book_async_remove_contact_by_id ##### -->
898
<!-- ##### FUNCTION e_book_async_remove_contacts ##### -->
910
<!-- ##### FUNCTION e_book_async_add_contact ##### -->
922
<!-- ##### FUNCTION e_book_async_commit_contact ##### -->
934
<!-- ##### FUNCTION e_book_async_get_book_view ##### -->
948
<!-- ##### FUNCTION e_book_async_get_changes ##### -->
960
<!-- ##### FUNCTION e_book_async_get_required_fields ##### -->