![]() |
![]() |
![]() |
Evolution-Data-Server Manual: Address Book Client (libebook) | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
EBookViewEBookView — Represents a search against an EBook. |
EBookView; void e_book_view_start (EBookView *book_view
); void e_book_view_stop (EBookView *book_view
); struct _EBook * e_book_view_get_book (EBookView *book_view
);
"contacts-added" : Run Last "contacts-changed" : Run Last "contacts-removed" : Run Last "sequence-complete" : Run Last "status-message" : Run Last
Event notifications and callbacks from EBookView go to the EBookViewListener. Contrast EBookView with EBook, which represents the addressbook itself.
void e_book_view_start (EBookView *book_view
);
Tells book_view
to start processing events.
|
an EBookView |
void e_book_view_stop (EBookView *book_view
);
Tells book_view
to stop processing events.
|
an EBookView |
"contacts-added"
signalvoid user_function (EBookView *ebookview, gpointer arg1, gpointer user_data) : Run Last
Fired when more contacts are found. Each contact in the list will be unref'd when done, and the list freed, so simply reference any contacts you want to keep.
|
the object which received the signal. |
|
a GList of EContact objects that were added to the view |
|
user data set when the signal handler was connected. |
"contacts-changed"
signalvoid user_function (EBookView *ebookview, gpointer arg1, gpointer user_data) : Run Last
Fired when contacts are changed. Each contact in the list will be unref'd when done, and the list freed, so simply reference any contacts you want to keep.
|
the object which received the signal. |
|
a GList of EContact objects that were modified |
|
user data set when the signal handler was connected. |
"contacts-removed"
signalvoid user_function (EBookView *ebookview, gpointer arg1, gpointer user_data) : Run Last
Fired when contacts are removed from the view. The IDs and the list will be freed, so copy any IDs you want to keep.
|
the object which received the signal. |
|
a GList of contact IDs (char*) that were removed from the view |
|
user data set when the signal handler was connected. |
"sequence-complete"
signalvoid user_function (EBookView *ebookview, gint arg1, gpointer user_data) : Run Last
Fired when there are currently no more contacts to send. This is fired once after the initial set of contacts-added signals, and after every future change.
|
the object which received the signal. |
|
an EBookViewStatus |
|
user data set when the signal handler was connected. |
"status-message"
signalvoid user_function (EBookView *ebookview, gchar *arg1, gpointer user_data) : Run Last
Fired with a status message reporting the progress of the view.
|
the object which received the signal. |
|
a const char* message |
|
user data set when the signal handler was connected. |