Top | ![]() |
![]() |
![]() |
![]() |
#define | CAL_BACKEND_PROPERTY_CAL_EMAIL_ADDRESS |
#define | CAL_BACKEND_PROPERTY_ALARM_EMAIL_ADDRESS |
#define | CAL_BACKEND_PROPERTY_DEFAULT_OBJECT |
#define | E_CAL_CLIENT_ERROR |
enum | ECalClientError |
struct | ECalClient |
struct | ECalClientClass |
constgchar * e_cal_client_error_to_string (ECalClientError code
);
Get localized human readable description of the given error code.
Since: 3.2
EClient * e_cal_client_connect_sync (ESource *source
,ECalClientSourceType source_type
,,
guint32 wait_for_connected_seconds,
GCancellable *cancellable);
GError **error
Creates a new ECalClient for source
and source_type
. If an error
occurs, the function will set error
and return FALSE
The wait_for_connected_seconds
argument had been added since 3.16,
to let the caller decide how long to wait for the backend to fully
connect to its (possibly remote) data store. This is required due
to a change in the authentication process, which is fully asynchronous
and done on the client side, while not every client is supposed to
response to authentication requests. In case the backend will not connect
within the set interval, then it is opened in an offline mode. A special
value -1 can be used to not wait for the connected state at all.
Unlike with e_cal_client_new()
, there is no need to call
e_client_open_sync()
after obtaining the ECalClient.
For error handling convenience, any error message returned by this
function will have a descriptive prefix that includes the display
name of source
.
source |
an ESource |
|
source_type |
source type of the calendar |
|
wait_for_connected_seconds |
timeout, in seconds, to wait for the backend to be fully connected |
|
cancellable |
optional |
[allow-none] |
error |
return location for a |
Since: 3.8
void e_cal_client_connect (ESource *source
,ECalClientSourceType source_type
,,
guint32 wait_for_connected_seconds,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously creates a new ECalClient for source
and source_type
.
The wait_for_connected_seconds
argument had been added since 3.16,
to let the caller decide how long to wait for the backend to fully
connect to its (possibly remote) data store. This is required due
to a change in the authentication process, which is fully asynchronous
and done on the client side, while not every client is supposed to
response to authentication requests. In case the backend will not connect
within the set interval, then it is opened in an offline mode. A special
value -1 can be used to not wait for the connected state at all.
Unlike with e_cal_client_new()
, there is no need to call e_client_open()
after obtaining the ECalClient.
When the operation is finished, callback
will be called. You can then
call e_cal_client_connect_finish()
to get the result of the operation.
source |
an ESource |
|
source_type |
source tpe of the calendar |
|
wait_for_connected_seconds |
timeout, in seconds, to wait for the backend to be fully connected |
|
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.8
EClient * e_cal_client_connect_finish (,
GAsyncResult *result);
GError **error
Finishes the operation started with e_cal_client_connect()
. If an
error occurs in connecting to the D-Bus service, the function sets
error
and returns NULL
For error handling convenience, any error message returned by this
function will have a descriptive prefix that includes the display
name of the ESource passed to e_cal_client_connect()
.
Since: 3.8
ECalClientSourceType
e_cal_client_get_source_type (ECalClient *client
);
Gets the source type of the calendar client.
Since: 3.2
constgchar * e_cal_client_get_local_attachment_store (ECalClient *client
);
Queries the URL where the calendar attachments are serialized in the local filesystem. This enable clients to operate with the reference to attachments rather than the data itself unless it specifically uses the attachments for open/sending operations.
Since: 3.2
void e_cal_client_set_default_timezone (ECalClient *client
,);
icaltimezone *zone
Sets the default timezone to use to resolve DATE and floating DATE-TIME values. This will typically be from the user's timezone setting. Call this before using any other object fetching functions.
Since: 3.2
icaltimezone * e_cal_client_get_default_timezone (ECalClient *client
);
Returns the default timezone previously set with
e_cal_client_set_default_timezone()
. The returned pointer is owned by
the client
and should not be freed.
Since: 3.2
gboolean e_cal_client_check_one_alarm_only (ECalClient *client
);
Checks if a calendar supports only one alarm per component.
Since: 3.2
gboolean e_cal_client_check_save_schedules (ECalClient *client
);
Checks whether the calendar saves schedules.
Since: 3.2
gboolean e_cal_client_check_organizer_must_attend (ECalClient *client
);
Checks if a calendar forces organizers of meetings to be also attendees.
Since: 3.2
gboolean e_cal_client_check_organizer_must_accept (ECalClient *client
);
Checks whether a calendar requires organizer to accept their attendance to meetings.
Since: 3.2
gboolean e_cal_client_check_recurrences_no_master (ECalClient *client
);
Checks if the calendar has a master object for recurrences.
Since: 3.2
void e_cal_client_free_icalcomp_slist ();
GSList *icalcomps
Frees each element of the icalcomps
list and the list itself.
Each element is an object of type
Since: 3.2
void e_cal_client_free_ecalcomp_slist ();
GSList *ecalcomps
Frees each element of the ecalcomps
list and the list itself.
Each element is an object of type
Since: 3.2
icaltimezone * e_cal_client_resolve_tzid_cb (const
,gchar *tzid);
gpointer data
Resolves TZIDs for the recurrence generator.
tzid |
ID of the timezone to resolve. |
|
data |
Closure data for the callback, in this case ECalClient. |
Since: 3.2
icaltimezone * e_cal_client_resolve_tzid_sync (const
,gchar *tzid,
gpointer cal_client,
GCancellable *cancellable);
GError **error
Resolves TZIDs for the recurrence generator.
tzid |
ID of the timezone to resolve. |
|
cal_client |
User data for the callback, in this case ECalClient. |
|
cancellable |
optional |
|
error |
return location for a |
Since: 3.20
void e_cal_client_generate_instances (ECalClient *client
,,
time_t start,
time_t end,
GCancellable *cancellableECalRecurInstanceFn cb
,,
gpointer cb_data);
GDestroyNotify destroy_cb_data
Does a combination of e_cal_client_get_object_list()
and
e_cal_client_recur_generate_instances()
e_cal_client_generate_instances_sync()
, this returns immediately and the
cb
callback is called asynchronously.
The callback function should do a g_object_ref()
client |
A calendar client. |
|
start |
Start time for query. |
|
end |
End time for query. |
|
cancellable |
a |
|
cb |
Callback for each generated instance. |
|
cb_data |
Closure data for the callback. |
|
destroy_cb_data |
Function to call when the processing is done, to free
|
Since: 3.2
void e_cal_client_generate_instances_sync (ECalClient *client
,,
time_t start,
time_t endECalRecurInstanceFn cb
,);
gpointer cb_data
Does a combination of e_cal_client_get_object_list()
and
e_cal_client_recur_generate_instances()
The callback function should do a g_object_ref()
client |
A calendar client |
|
start |
Start time for query |
|
end |
End time for query |
|
cb |
Callback for each generated instance. |
[closure cb_data][scope call] |
cb_data |
Closure data for the callback. |
[closure] |
Since: 3.2
void e_cal_client_generate_instances_for_object (ECalClient *client
,,
icalcomponent *icalcomp,
time_t start,
time_t end,
GCancellable *cancellableECalRecurInstanceFn cb
,,
gpointer cb_data);
GDestroyNotify destroy_cb_data
Does a combination of e_cal_client_get_object_list()
and
e_cal_client_recur_generate_instances()
e_cal_client_generate_instances()
, but for a single object. Unlike
e_cal_client_generate_instances_for_object_sync()
, this returns immediately
and the cb
callback is called asynchronously.
The callback function should do a g_object_ref()
client |
A calendar client. |
|
icalcomp |
Object to generate instances from. |
|
start |
Start time for query. |
|
end |
End time for query. |
|
cancellable |
a |
|
cb |
Callback for each generated instance. |
|
cb_data |
Closure data for the callback. |
|
destroy_cb_data |
Function to call when the processing is done, to
free |
Since: 3.2
void e_cal_client_generate_instances_for_object_sync (ECalClient *client
,,
icalcomponent *icalcomp,
time_t start,
time_t endECalRecurInstanceFn cb
,);
gpointer cb_data
Does a combination of e_cal_client_get_object_list()
and
e_cal_client_recur_generate_instances()
e_cal_client_generate_instances_sync()
, but for a single object.
The callback function should do a g_object_ref()
client |
A calendar client |
|
icalcomp |
Object to generate instances from |
|
start |
Start time for query |
|
end |
End time for query |
|
cb |
Callback for each generated instance. |
[closure cb_data][scope call] |
cb_data |
Closure data for the callback. |
[closure] |
Since: 3.2
gchar * e_cal_client_get_component_as_string (ECalClient *client
,);
icalcomponent *icalcomp
Gets a calendar component as an iCalendar string, with a toplevel VCALENDAR component and all VTIMEZONEs needed for the component.
the component as a complete iCalendar string, or NULL on
failure. The string should be freed with g_free()
Since: 3.2
void e_cal_client_get_default_object (ECalClient *client
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Retrives an e_cal_client_get_default_object_finish()
from the callback
.
client |
an ECalClient |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_default_object_finish (ECalClient *client
,,
GAsyncResult *result,
icalcomponent **out_icalcomp);
GError **error
Finishes previous call of e_cal_client_get_default_object()
and
sets out_icalcomp
to an out_icalcomp
should be
freed with icalcomponent_free()
client |
an ECalClient |
|
result |
a |
|
out_icalcomp |
Return value for the default calendar object. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_default_object_sync (ECalClient *client
,,
icalcomponent **out_icalcomp,
GCancellable *cancellable);
GError **error
Retrives an out_icalcomp
should be freed with
icalcomponent_free()
client |
an ECalClient |
|
out_icalcomp |
Return value for the default calendar object. |
[out] |
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_object (ECalClient *client
,const
,gchar *uidconst
,gchar *rid,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Queries a calendar for a calendar component object based on its unique
identifier. The call is finished by e_cal_client_get_object_finish()
from the callback
.
Use e_cal_client_get_objects_for_uid()
to get list of all
objects for the given uid, which includes master object and
all detached instances.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component. |
|
rid |
Recurrence identifier. |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_object_finish (ECalClient *client
,,
GAsyncResult *result,
icalcomponent **out_icalcomp);
GError **error
Finishes previous call of e_cal_client_get_object()
and
sets out_icalcomp
to queried component. This function always returns
master object for a case of rid
being NULL or an empty string.
This component should be freed with icalcomponent_free()
Use e_cal_client_get_objects_for_uid()
to get list of all
objects for the given uid, which includes master object and
all detached instances.
client |
an ECalClient |
|
result |
a |
|
out_icalcomp |
Return value for the calendar component object. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_object_sync (ECalClient *client
,const
,gchar *uidconst
,gchar *rid,
icalcomponent **out_icalcomp,
GCancellable *cancellable);
GError **error
Queries a calendar for a calendar component object based
on its unique identifier. This function always returns
master object for a case of rid
being NULL or an empty string.
This component should be freed with icalcomponent_free()
Use e_cal_client_get_objects_for_uid_sync()
to get list of all
objects for the given uid, which includes master object and
all detached instances.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component. |
|
rid |
Recurrence identifier. |
|
out_icalcomp |
Return value for the calendar component object. |
[out] |
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_objects_for_uid (ECalClient *client
,const
,gchar *uid,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Queries a calendar for all calendar components with the given unique
ID. This will return any recurring event and all its detached recurrences.
For non-recurring events, it will just return the object with that ID.
The call is finished by e_cal_client_get_objects_for_uid_finish()
from
the callback
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_objects_for_uid_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_ecalcomps);
GError **error
Finishes previous call of e_cal_client_get_objects_for_uid()
and
sets out_ecalcomps
to a list of e_cal_client_free_ecalcomp_slist()
.
client |
an ECalClient |
|
result |
a |
|
out_ecalcomps |
Return location for the list of objects obtained from the backend. |
[out][transfer full][element-type ECalComponent] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_objects_for_uid_sync (ECalClient *client
,const
,gchar *uid,
GSList **out_ecalcomps,
GCancellable *cancellable);
GError **error
Queries a calendar for all calendar components with the given unique
ID. This will return any recurring event and all its detached recurrences.
For non-recurring events, it will just return the object with that ID.
This list should be freed with e_cal_client_free_ecalcomp_slist()
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
out_ecalcomps |
Return location for the list of objects obtained from the backend. |
[out][transfer full][element-type ECalComponent] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_object_list (ECalClient *client
,const
,gchar *sexp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Gets a list of objects from the calendar that match the query specified
by the sexp
argument, returning matching objects as a list of e_cal_client_get_object_list_finish()
from
the callback
.
client |
an ECalClient |
|
sexp |
an S-expression representing the query |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_object_list_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_icalcomps);
GError **error
Finishes previous call of e_cal_client_get_object_list()
and
sets out_icalcomps
to a matching list of e_cal_client_free_icalcomp_slist()
.
client |
an ECalClient |
|
result |
a |
|
out_icalcomps |
list of matching
|
[out][element-type icalcomponent] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_object_list_sync (ECalClient *client
,const
,gchar *sexp,
GSList **out_icalcomps,
GCancellable *cancellable);
GError **error
Gets a list of objects from the calendar that match the query specified
by the sexp
argument. The objects will be returned in the out_icalcomps
argument, which is a list of e_cal_client_free_icalcomp_slist()
.
client |
an ECalClient |
|
sexp |
an S-expression representing the query |
|
out_icalcomps |
list of matching
|
[out][element-type icalcomponent] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_object_list_as_comps (ECalClient *client
,const
,gchar *sexp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Gets a list of objects from the calendar that match the query specified
by the sexp
argument, returning matching objects as a list of e_cal_client_get_object_list_as_comps_finish()
from
the callback
.
client |
an ECalClient |
|
sexp |
an S-expression representing the query |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_object_list_as_comps_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_ecalcomps);
GError **error
Finishes previous call of e_cal_client_get_object_list_as_comps()
and
sets out_ecalcomps
to a matching list of e_cal_client_free_ecalcomp_slist()
.
client |
an ECalClient |
|
result |
a |
|
out_ecalcomps |
list of matching
|
[out][element-type ECalComponent] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_object_list_as_comps_sync (ECalClient *client
,const
,gchar *sexp,
GSList **out_ecalcomps,
GCancellable *cancellable);
GError **error
Gets a list of objects from the calendar that match the query specified
by the sexp
argument. The objects will be returned in the out_ecalcomps
argument, which is a list of e_cal_client_free_ecalcomp_slist()
.
client |
an ECalClient |
|
sexp |
an S-expression representing the query |
|
out_ecalcomps |
list of matching
|
[out][element-type ECalComponent] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_free_busy (ECalClient *client
,,
time_t start,
time_t endconst
,GSList *users,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Begins retrieval of free/busy information from the calendar server
as a list of e_cal_client_get_free_busy_finish()
from
the callback
.
client |
an ECalClient |
|
start |
Start time for query |
|
end |
End time for query |
|
users |
List of users to retrieve free/busy information for. |
[element-type utf8] |
cancellable |
a |
[allow-none] |
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_free_busy_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_freebusy);
GError **error
Finishes previous call of e_cal_client_get_free_busy()
.
The out_freebusy
contains all VFREEBUSY
client |
an ECalClient |
|
result |
a |
|
out_freebusy |
a |
[element-type ECalComponent] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_free_busy_sync (ECalClient *client
,,
time_t start,
time_t endconst
,GSList *users,
GSList **out_freebusy,
GCancellable *cancellable);
GError **error
Gets free/busy information from the calendar server.
The out_freebusy
contains all VFREEBUSY
client |
an ECalClient |
|
start |
Start time for query |
|
end |
End time for query |
|
users |
List of users to retrieve free/busy information for. |
[element-type utf8] |
out_freebusy |
a |
[element-type ECalComponent] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_create_object (ECalClient *client
,,
icalcomponent *icalcomp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Requests the calendar backend to create the object specified by the icalcomp
argument. Some backends would assign a specific UID to the newly created object,
but this function does not modify the original icalcomp
if its UID changes.
The call is finished by e_cal_client_create_object_finish()
from
the callback
.
client |
an ECalClient |
|
icalcomp |
The component to create |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_create_object_finish (ECalClient *client
,,
GAsyncResult *result,
gchar **out_uid);
GError **error
Finishes previous call of e_cal_client_create_object()
and
sets out_uid
to newly assigned UID for the created object.
This out_uid
should be freed with g_free()
client |
an ECalClient |
|
result |
a |
|
out_uid |
Return value for the UID assigned to the new component by the calendar backend. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_create_object_sync (ECalClient *client
,,
icalcomponent *icalcomp,
gchar **out_uid,
GCancellable *cancellable);
GError **error
Requests the calendar backend to create the object specified by the
icalcomp
argument. Some backends would assign a specific UID to the newly
created object, in those cases that UID would be returned in the out_uid
argument. This function does not modify the original icalcomp
if its UID
changes. Returned out_uid
should be freed with g_free()
client |
an ECalClient |
|
icalcomp |
The component to create |
|
out_uid |
Return value for the UID assigned to the new component by the calendar backend. |
[out] |
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_create_objects (ECalClient *client
,,
GSList *icalcomps,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Requests the calendar backend to create the objects specified by the icalcomps
argument. Some backends would assign a specific UID to the newly created object,
but this function does not modify the original icalcomps
if their UID changes.
The call is finished by e_cal_client_create_objects_finish()
from
the callback
.
client |
an ECalClient |
|
icalcomps |
The components to create. |
[element-type icalcomponent] |
cancellable |
a |
[allow-none] |
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.6
gboolean e_cal_client_create_objects_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_uids);
GError **error
Finishes previous call of e_cal_client_create_objects()
and
sets out_uids
to newly assigned UIDs for the created objects.
This out_uids
should be freed with e_client_util_free_string_slist()
.
client |
an ECalClient |
|
result |
a |
|
out_uids |
Return value for the UIDs assigned to the new components by the calendar backend. |
[out][element-type utf8] |
error |
a |
[out] |
Since: 3.6
gboolean e_cal_client_create_objects_sync (ECalClient *client
,,
GSList *icalcomps,
GSList **out_uids,
GCancellable *cancellable);
GError **error
Requests the calendar backend to create the objects specified by the
icalcomps
argument. Some backends would assign a specific UID to the
newly created objects, in those cases these UIDs would be returned in
the out_uids
argument. This function does not modify the original
icalcomps
if their UID changes. Returned out_uids
should be freed
with e_client_util_free_string_slist()
.
client |
an ECalClient |
|
icalcomps |
The components to create. |
[element-type icalcomponent] |
out_uids |
Return value for the UIDs assigned to the new components by the calendar backend. |
[out][element-type utf8] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.6
void e_cal_client_modify_object (ECalClient *client
,,
icalcomponent *icalcompECalObjModType mod
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Requests the calendar backend to modify an existing object. If the object does not exist on the calendar, an error will be returned.
For recurrent appointments, the mod
argument specifies what to modify,
if all instances (E_CAL_OBJ_MOD_ALL), a single instance (E_CAL_OBJ_MOD_THIS),
or a specific set of instances (E_CAL_OBJ_MOD_THIS_AND_PRIOR and
E_CAL_OBJ_MOD_THIS_AND_FUTURE).
The call is finished by e_cal_client_modify_object_finish()
from
the callback
.
client |
an ECalClient |
|
icalcomp |
Component to modify |
|
mod |
Type of modification |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_modify_object_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_modify_object()
.
Since: 3.2
gboolean e_cal_client_modify_object_sync (ECalClient *client
,,
icalcomponent *icalcompECalObjModType mod
,,
GCancellable *cancellable);
GError **error
Requests the calendar backend to modify an existing object. If the object does not exist on the calendar, an error will be returned.
For recurrent appointments, the mod
argument specifies what to modify,
if all instances (E_CAL_OBJ_MOD_ALL), a single instance (E_CAL_OBJ_MOD_THIS),
or a specific set of instances (E_CAL_OBJ_MOD_THISNADPRIOR and
E_CAL_OBJ_MOD_THIS_AND_FUTURE).
client |
an ECalClient |
|
icalcomp |
Component to modify |
|
mod |
Type of modification |
|
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_modify_objects (ECalClient *client
,,
GSList *compsECalObjModType mod
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Requests the calendar backend to modify existing objects. If an object does not exist on the calendar, an error will be returned.
For recurrent appointments, the mod
argument specifies what to modify,
if all instances (E_CAL_OBJ_MOD_ALL), a single instance (E_CAL_OBJ_MOD_THIS),
or a specific set of instances (E_CAL_OBJ_MOD_THISNADPRIOR and
E_CAL_OBJ_MOD_THIS_AND_FUTURE).
The call is finished by e_cal_client_modify_objects_finish()
from
the callback
.
client |
an ECalClient |
|
comps |
Components to modify. |
[element-type icalcomponent] |
mod |
Type of modification |
|
cancellable |
a |
[allow-none] |
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.6
gboolean e_cal_client_modify_objects_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_modify_objects()
.
Since: 3.6
gboolean e_cal_client_modify_objects_sync (ECalClient *client
,,
GSList *compsECalObjModType mod
,,
GCancellable *cancellable);
GError **error
Requests the calendar backend to modify existing objects. If an object does not exist on the calendar, an error will be returned.
For recurrent appointments, the mod
argument specifies what to modify,
if all instances (E_CAL_OBJ_MOD_ALL), a single instance (E_CAL_OBJ_MOD_THIS),
or a specific set of instances (E_CAL_OBJ_MOD_THISNADPRIOR and
E_CAL_OBJ_MOD_THIS_AND_FUTURE).
client |
an ECalClient |
|
comps |
Components to modify. |
[element-type icalcomponent] |
mod |
Type of modification |
|
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.6
void e_cal_client_remove_object (ECalClient *client
,const
,gchar *uidconst
,gchar *ridECalObjModType mod
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
This function allows the removal of instances of a recurrent
appointment. By using a combination of the uid
, rid
and mod
arguments, you can remove specific instances. If what you want
is to remove all instances, use NULL
rid
and E_CAL_OBJ_MOD_ALL
for the mod
.
The call is finished by e_cal_client_remove_object_finish()
from
the callback
.
client |
an ECalClient |
|
uid |
UID of the object to remove |
|
rid |
Recurrence ID of the specific recurrence to remove |
|
mod |
Type of the removal |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_remove_object_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_remove_object()
.
Since: 3.2
gboolean e_cal_client_remove_object_sync (ECalClient *client
,const
,gchar *uidconst
,gchar *ridECalObjModType mod
,,
GCancellable *cancellable);
GError **error
This function allows the removal of instances of a recurrent
appointment. By using a combination of the uid
, rid
and mod
arguments, you can remove specific instances. If what you want
is to remove all instances, use NULL
rid
and E_CAL_OBJ_MODE_ALL
for the mod
.
client |
an ECalClient |
|
uid |
UID of the object to remove |
|
rid |
Recurrence ID of the specific recurrence to remove |
|
mod |
Type of the removal |
|
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_remove_objects (ECalClient *client
,const
,GSList *idsECalObjModType mod
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
This function allows the removal of instances of recurrent appointments.
ECalComponentId objects can identify specific instances (if rid is not
NULL
NULL
mod
.
The call is finished by e_cal_client_remove_objects_finish()
from
the callback
.
client |
an ECalClient |
|
ids |
A list of ECalComponentId objects identifying the objects to remove. |
[element-type ECalComponentId] |
mod |
Type of the removal |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.6
gboolean e_cal_client_remove_objects_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_remove_objects()
.
Since: 3.6
gboolean e_cal_client_remove_objects_sync (ECalClient *client
,const
,GSList *idsECalObjModType mod
,,
GCancellable *cancellable);
GError **error
This function allows the removal of instances of recurrent
appointments. ECalComponentId objects can identify specific instances
(if rid is not NULL
NULL
mod
.
client |
an ECalClient |
|
ids |
a list of ECalComponentId objects identifying the objects to remove. |
[element-type ECalComponentId] |
mod |
Type of the removal |
|
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.6
void e_cal_client_receive_objects (ECalClient *client
,,
icalcomponent *icalcomp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Makes the backend receive the set of iCalendar objects specified in the
icalcomp
argument. This is used for iTIP confirmation/cancellation
messages for scheduled meetings.
The call is finished by e_cal_client_receive_objects_finish()
from
the callback
.
client |
an ECalClient |
|
icalcomp |
An |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_receive_objects_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_receive_objects()
.
Since: 3.2
gboolean e_cal_client_receive_objects_sync (ECalClient *client
,,
icalcomponent *icalcomp,
GCancellable *cancellable);
GError **error
Makes the backend receive the set of iCalendar objects specified in the
icalcomp
argument. This is used for iTIP confirmation/cancellation
messages for scheduled meetings.
client |
an ECalClient |
|
icalcomp |
An |
|
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_send_objects (ECalClient *client
,,
icalcomponent *icalcomp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Requests a calendar backend to send meeting information stored in icalcomp
.
The backend can modify this component and request a send to particular users.
The call is finished by e_cal_client_send_objects_finish()
from
the callback
.
client |
an ECalClient |
|
icalcomp |
An icalcomponent to be sent |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_send_objects_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_users,
icalcomponent **out_modified_icalcomp);
GError **error
Finishes previous call of e_cal_client_send_objects()
and
populates out_users
with a list of users to send out_modified_icalcomp
to.
The out_users
list should be freed with e_client_util_free_string_slist()
and the out_modified_icalcomp
should be freed with icalcomponent_free()
client |
an ECalClient |
|
result |
a |
|
out_users |
List of users to send
the |
[out][element-type utf8] |
out_modified_icalcomp |
Return value for the icalcomponent to be sent. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_send_objects_sync (ECalClient *client
,,
icalcomponent *icalcomp,
GSList **out_users,
icalcomponent **out_modified_icalcomp,
GCancellable *cancellable);
GError **error
Requests a calendar backend to send meeting information stored in icalcomp
.
The backend can modify this component and request a send to users in the
out_users
list.
The out_users
list should be freed with e_client_util_free_string_slist()
and the out_modified_icalcomp
should be freed with icalcomponent_free()
client |
an ECalClient |
|
icalcomp |
An icalcomponent to be sent |
|
out_users |
List of users to send the
|
[out][element-type utf8] |
out_modified_icalcomp |
Return value for the icalcomponent to be sent. |
[out] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_attachment_uris (ECalClient *client
,const
,gchar *uidconst
,gchar *rid,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Queries a calendar for a specified component's object attachment uris.
The call is finished by e_cal_client_get_attachment_uris_finish()
from
the callback
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
rid |
Recurrence identifier |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_attachment_uris_finish (ECalClient *client
,,
GAsyncResult *result,
GSList **out_attachment_uris);
GError **error
Finishes previous call of e_cal_client_get_attachment_uris()
and
sets out_attachment_uris
to uris for component's attachments.
The list should be freed with e_client_util_free_string_slist()
.
client |
an ECalClient |
|
result |
a |
|
out_attachment_uris |
Return location for the list of attachment URIs. |
[out][element-type utf8] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_attachment_uris_sync (ECalClient *client
,const
,gchar *uidconst
,gchar *rid,
GSList **out_attachment_uris,
GCancellable *cancellable);
GError **error
Queries a calendar for a specified component's object attachment URIs.
The list should be freed with e_client_util_free_string_slist()
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
rid |
Recurrence identifier |
|
out_attachment_uris |
Return location for the list of attachment URIs. |
[out][element-type utf8] |
cancellable |
a |
[allow-none] |
error |
a |
[out] |
Since: 3.2
void e_cal_client_discard_alarm (ECalClient *client
,const
,gchar *uidconst
,gchar *ridconst
,gchar *auid,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Removes alarm auid
from a given component identified by uid
and rid
.
The call is finished by e_cal_client_discard_alarm_finish()
from
the callback
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
rid |
Recurrence identifier |
|
auid |
Alarm identifier to remove |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_discard_alarm_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_discard_alarm()
.
Since: 3.2
gboolean e_cal_client_discard_alarm_sync (ECalClient *client
,const
,gchar *uidconst
,gchar *ridconst
,gchar *auid,
GCancellable *cancellable);
GError **error
Removes alarm auid
from a given component identified by uid
and rid
.
client |
an ECalClient |
|
uid |
Unique identifier for a calendar component |
|
rid |
Recurrence identifier |
|
auid |
Alarm identifier to remove |
|
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_view (ECalClient *client
,const
,gchar *sexp,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Query client
with sexp
, creating an ECalClientView.
The call is finished by e_cal_client_get_view_finish()
from the callback
.
client |
an ECalClient |
|
sexp |
an S-expression representing the query. |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_view_finish (ECalClient *client
,,
GAsyncResult *resultECalClientView **out_view
,);
GError **error
Finishes previous call of e_cal_client_get_view()
.
If successful, then the out_view
is set to newly allocated ECalClientView,
which should be freed with g_object_unref()
client |
an ECalClient |
|
result |
a |
|
out_view |
an ECalClientView. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_view_sync (ECalClient *client
,const
,gchar *sexpECalClientView **out_view
,,
GCancellable *cancellable);
GError **error
Query client
with sexp
, creating an ECalClientView.
If successful, then the out_view
is set to newly allocated ECalClientView,
which should be freed with g_object_unref()
client |
an ECalClient |
|
sexp |
an S-expression representing the query. |
|
out_view |
an ECalClientView. |
[out] |
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_get_timezone (ECalClient *client
,const
,gchar *tzid,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Retrieves a timezone object from the calendar backend.
The call is finished by e_cal_client_get_timezone_finish()
from
the callback
.
client |
an ECalClient |
|
tzid |
ID of the timezone to retrieve |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_get_timezone_finish (ECalClient *client
,,
GAsyncResult *result,
icaltimezone **out_zone);
GError **error
Finishes previous call of e_cal_client_get_timezone()
and
sets out_zone
to a retrieved timezone object from the calendar backend.
This object is owned by the client
, thus do not free it.
client |
an ECalClient |
|
result |
a |
|
out_zone |
Return value for the timezone. |
[out] |
error |
a |
[out] |
Since: 3.2
gboolean e_cal_client_get_timezone_sync (ECalClient *client
,const
,gchar *tzid,
icaltimezone **out_zone,
GCancellable *cancellable);
GError **error
Retrieves a timezone object from the calendar backend.
This object is owned by the client
, thus do not free it.
client |
an ECalClient |
|
tzid |
ID of the timezone to retrieve |
|
out_zone |
Return value for the timezone. |
[out] |
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
void e_cal_client_add_timezone (ECalClient *client
,,
icaltimezone *zone,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Add a VTIMEZONE object to the given calendar client.
The call is finished by e_cal_client_add_timezone_finish()
from
the callback
.
client |
an ECalClient |
|
zone |
The timezone to add |
|
cancellable |
a |
|
callback |
callback to call when a result is ready |
|
user_data |
user data for the |
Since: 3.2
gboolean e_cal_client_add_timezone_finish (ECalClient *client
,,
GAsyncResult *result);
GError **error
Finishes previous call of e_cal_client_add_timezone()
.
Since: 3.2
gboolean e_cal_client_add_timezone_sync (ECalClient *client
,,
icaltimezone *zone,
GCancellable *cancellable);
GError **error
Add a VTIMEZONE object to the given calendar client.
client |
an ECalClient |
|
zone |
The timezone to add |
|
cancellable |
a |
|
error |
a |
[out] |
Since: 3.2
ECalClient * e_cal_client_new (ESource *source
,ECalClientSourceType source_type
,);
GError **error
e_cal_client_new
has been deprecated since version 3.8 and should not be used in newly-written code.
It covertly makes synchronous D-Bus calls, with no
way to cancel. Use e_cal_client_connect()
instead,
which combines e_cal_client_new()
and e_client_open()
into one step.
Creates a new ECalClient corresponding to the given source. There are
only two operations that are valid on this calendar at this point:
e_client_open()
, and e_client_remove()
.
Since: 3.2
GError * e_cal_client_error_create (ECalClientError code
,const
);gchar *custom_msg
e_cal_client_error_create
has been deprecated since version 3.8 and should not be used in newly-written code.
Just use the
code |
an ECalClientError code to create |
|
custom_msg |
custom message to use for the error; can be |
a new code
. If the custom_msg
is NULL, then the error message is
the one returned from e_cal_client_error_to_string()
for the code
,
otherwise the given message is used.
Returned pointer should be freed with g_error_free()
Since: 3.2
#define CAL_BACKEND_PROPERTY_CAL_EMAIL_ADDRESS
FIXME: Document me.
Since: 3.2
#define CAL_BACKEND_PROPERTY_ALARM_EMAIL_ADDRESS
FIXME: Document me.
Since: 3.2
#define CAL_BACKEND_PROPERTY_DEFAULT_OBJECT
FIXME: Document me.
Since: 3.2
#define E_CAL_CLIENT_ERROR e_cal_client_error_quark ()
FIXME: Document me.
Since: 3.2
No such calendar |
||
Object not found |
||
Invalid object |
||
Unknown user |
||
Object ID already exists |
||
Invalid range |
Since: 3.2
struct ECalClient { };
Contains only private data that should be read and manipulated using the functions below.
Since: 3.2
struct ECalClientClass { /* Signals */ void (*free_busy_data) (ECalClient *client, const GSList *free_busy_ecalcomps); };
Base class structure for the ECalClient class