![]() |
![]() |
![]() |
Evolution-Data-Server Manual: Address Book Client (libebook) | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
struct EBookClientView; struct _EBookClient * e_book_client_view_get_client (EBookClientView *view
); GDBusConnection * e_book_client_view_get_connection (EBookClientView *view
); const gchar * e_book_client_view_get_object_path (EBookClientView *view
); gboolean e_book_client_view_is_running (EBookClientView *view
); void e_book_client_view_set_fields_of_interest (EBookClientView *view
,const GSList *fields_of_interest
,GError **error
); void e_book_client_view_start (EBookClientView *view
,GError **error
); void e_book_client_view_stop (EBookClientView *view
,GError **error
); void e_book_client_view_set_flags (EBookClientView *view
,EBookClientViewFlags flags
,GError **error
);
"client" EBookClient* : Read / Write / Construct Only "connection" GDBusConnection* : Read / Write / Construct Only "direct-book" EDataBook* : Write / Construct Only "object-path" gchar* : Read / Write / Construct Only
"complete" :Run Last
"objects-added" :Run Last
"objects-modified" :Run Last
"objects-removed" :Run Last
"progress" :Run Last
struct EBookClientView;
Contains only private data the should be read and manipulated using the functions below.
Since 3.2
struct _EBookClient * e_book_client_view_get_client (EBookClientView *view
);
Returns the EBookClient associated with view
.
|
an EBookClientView |
Returns : |
an EBookClient. [transfer none] |
GDBusConnection * e_book_client_view_get_connection (EBookClientView *view
);
Returns the GDBusConnection used to create the D-Bus proxy.
|
an EBookClientView |
Returns : |
the GDBusConnection. [transfer none] |
Since 3.8
const gchar * e_book_client_view_get_object_path (EBookClientView *view
);
Returns the object path used to create the D-Bus proxy.
|
an EBookClientView |
Returns : |
the object path |
Since 3.8
void e_book_client_view_set_fields_of_interest (EBookClientView *view
,const GSList *fields_of_interest
,GError **error
);
Client can instruct server to which fields it is interested in only, thus
the server can return less data over the wire. The server can still return
complete objects, this is just a hint to it that the listed fields will
be used only. The UID field is returned always. Initial views has no fields
of interest and using NULL
for fields_of_interest
will unset any previous
changes.
Some backends can use summary information of its cache to create artifical objects, which will omit stored object parsing. If this cannot be done then it will simply return object as is stored in the cache.
|
An EBookClientView object |
|
List of field names in which the client is interested. [element-type utf8] |
|
return location for a GError, or NULL
|
void e_book_client_view_start (EBookClientView *view
,GError **error
);
Tells view
to start processing events.
|
an EBookClientView |
|
return location for a GError, or NULL
|
void e_book_client_view_stop (EBookClientView *view
,GError **error
);
Tells view
to stop processing events.
|
an EBookClientView |
|
return location for a GError, or NULL
|
void e_book_client_view_set_flags (EBookClientView *view
,EBookClientViewFlags flags
,GError **error
);
Sets the flags
which control the behaviour of view
.
|
an EBookClientView |
|
the EBookClientViewFlags for view
|
|
return location for a GError, or NULL
|
Since 3.4
"client"
property"client" EBookClient* : Read / Write / Construct Only
The EBookClient for the view.
"connection"
property"connection" GDBusConnection* : Read / Write / Construct Only
The GDBusConnection used to create the D-Bus proxy.
"direct-book"
property "direct-book" EDataBook* : Write / Construct Only
The EDataBook to fetch contact data from, if direct read access is enabled.
"object-path"
property"object-path" gchar* : Read / Write / Construct Only
The object path used to create the D-Bus proxy.
Default value: NULL
"complete"
signalvoid user_function (EBookClientView *ebookclientview,
GError *arg1,
gpointer user_data) : Run Last
"objects-added"
signalvoid user_function (EBookClientView *ebookclientview,
gpointer arg1,
gpointer user_data) : Run Last
"objects-modified"
signalvoid user_function (EBookClientView *ebookclientview,
gpointer arg1,
gpointer user_data) : Run Last
"objects-removed"
signalvoid user_function (EBookClientView *ebookclientview,
gpointer arg1,
gpointer user_data) : Run Last
"progress"
signalvoid user_function (EBookClientView *ebookclientview,
guint arg1,
gchar *arg2,
gpointer user_data) : Run Last