Top | ![]() |
![]() |
![]() |
![]() |
struct _ECalClient * | e_cal_client_view_ref_client () |
|
e_cal_client_view_get_connection () |
const |
e_cal_client_view_get_object_path () |
|
e_cal_client_view_is_running () |
|
e_cal_client_view_set_fields_of_interest () |
|
e_cal_client_view_start () |
|
e_cal_client_view_stop () |
|
e_cal_client_view_set_flags () |
struct _ECalClient * | e_cal_client_view_get_client () |
This class provides functionality for watching for changes on a
given calendar opened with an ECalClient. Use e_cal_client_get_view()
to create an ECalClientView.
struct _ECalClient *
e_cal_client_view_ref_client (ECalClientView *client_view
);
Returns the client_view
.
The returned ECalClient is referenced for thread-safety. Unreference
the ECalClient with g_object_unref()
Since: 3.10
GDBusConnection * e_cal_client_view_get_connection (ECalClientView *client_view
);
Returns the
Since: 3.8
constgchar * e_cal_client_view_get_object_path (ECalClientView *client_view
);
Returns the object path used to create the D-Bus proxy.
Since: 3.8
gboolean e_cal_client_view_is_running (ECalClientView *client_view
);
Retunrs: Whether view is running. Not running views are ignoring all events sent from the server.
Since: 3.2
void e_cal_client_view_set_fields_of_interest (ECalClientView *client_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/RID fields are returned always. Initial views has no
fields of interest and using NULL
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.
void e_cal_client_view_start (ECalClientView *client_view
,);
GError **error
Tells client_view
to start processing events.
Since: 3.2
void e_cal_client_view_stop (ECalClientView *client_view
,);
GError **error
Tells client_view
to stop processing events.
Since: 3.2
void e_cal_client_view_set_flags (ECalClientView *client_view
,ECalClientViewFlags flags
,);
GError **error
Sets the flags
which control the behaviour of client_view
.
client_view |
||
flags |
the ECalClientViewFlags for |
|
error |
return location for a |
Since: 3.6
struct _ECalClient *
e_cal_client_view_get_client (ECalClientView *client_view
);
e_cal_client_view_get_client
has been deprecated since version 3.10 and should not be used in newly-written code.
Use e_cal_client_view_ref_client()
instead.
Returns the client_view
.
Since: 3.2
Flags that control the behaviour of an ECalClientView.
Symbolic value for no flags |
||
If this flag is set then all objects matching the view's query will
be sent as notifications when starting the view, otherwise only future
changes will be reported. The default for a ECalClientView is |
Since: 3.6
struct ECalClientView { };
Contains only private data that should be read and manipulated using the functions below.
Since: 3.2
struct ECalClientViewClass { /* Signals */ void (*objects_added) (ECalClientView *client_view, const GSList *objects); void (*objects_modified) (ECalClientView *client_view, const GSList *objects); void (*objects_removed) (ECalClientView *client_view, const GSList *uids); void (*progress) (ECalClientView *client_view, guint percent, const gchar *message); void (*complete) (ECalClientView *client_view, const GError *error); };
Base class structure for the ECalClientView class
A signal emitted when new objects are added into the view |
||
A signal emitted when some objects are modified in the view |
||
A signal emitted when some objects are removed from the view |
||
A signal emitted when the backend notifies about the progress |
||
A signal emitted when the backend finished initial view population |