Top | ![]() |
![]() |
![]() |
![]() |
This is the main user facing interface used for representing an event or other component in a given calendar.
gchar * e_cal_component_gen_uid (void
);
Generates a unique identifier suitable for calendar components.
ECalComponent * e_cal_component_new (void
);
Creates a new empty calendar component object. Once created, you should set it from an
existing e_cal_component_set_icalcomponent()
or with a
new empty component type by using e_cal_component_set_new_vtype()
.
ECalComponent * e_cal_component_new_from_string (const
);gchar *calobj
Creates a new calendar component object from the given iCalendar string.
ECalComponent * e_cal_component_new_from_icalcomponent ();
icalcomponent *icalcomp
Creates a new icalcomp
as
an inner icalcomp
, and if the call
to e_cal_component_set_icalcomponent()
fails, then icalcomp
is freed.
An icalcomp
assigned on success,
NULL if the icalcomp
cannot be assigned to
Since: 3.4
ECalComponent * e_cal_component_clone ();
ECalComponent *comp
Creates a new calendar component object by copying the information from another one.
void e_cal_component_set_new_vtype (,
ECalComponent *compECalComponentVType type
);
Clears any existing component data from a calendar component object and
creates a new
icalcomponent * e_cal_component_get_icalcomponent ();
ECalComponent *comp
Queries the
gboolean e_cal_component_set_icalcomponent (,
ECalComponent *comp);
icalcomponent *icalcomp
Sets the contents of a calendar component object from an comp
already had an
Supported component types are VEVENT, VTODO, VJOURNAL, VFREEBUSY, and VTIMEZONE.
void e_cal_component_rescan ();
ECalComponent *comp
Rescans the
void e_cal_component_strip_errors ();
ECalComponent *comp
Strips all error messages from the calendar component. Those error messages are added to the iCalendar string representation whenever an invalid is used for one of its fields.
ECalComponentVType
e_cal_component_get_vtype (ECalComponent *comp
);
Queries the type of a calendar component object.
gchar * e_cal_component_get_as_string ();
ECalComponent *comp
Gets the iCalendar string representation of a calendar component. You should
call e_cal_component_commit_sequence()
before this function to ensure that the
component's sequence number is consistent with the state of the object.
void e_cal_component_commit_sequence ();
ECalComponent *comp
Increments the sequence number property in a calendar component object if it needs it. This needs to be done when any of a number of properties listed in RFC 2445 change values, such as the start and end dates of a component.
This function must be called before calling e_cal_component_get_as_string()
to
ensure that the component is fully consistent.
void e_cal_component_abort_sequence ();
ECalComponent *comp
Aborts the sequence change needed in the given calendar component,
which means it will not require a sequence commit (via
e_cal_component_commit_sequence()
) even if the changes done require a
sequence increment.
void e_cal_component_get_uid (,
ECalComponent *compconst
);gchar **uid
Queries the unique identifier of a calendar component object.
void e_cal_component_set_uid (,
ECalComponent *compconst
);gchar *uid
Sets the unique identifier string of a calendar component object.
ECalComponentId *
e_cal_component_get_id (ECalComponent *comp
);
Get the ID of the component as a ECalComponentId. The return value should
be freed with e_cal_component_free_id()
when you have finished with it.
ECalComponentId * e_cal_component_id_new (const
,gchar *uidconst
);gchar *rid
Creates a new ECalComponentId from uid
and rid
, which should be
freed with e_cal_component_free_id()
.
Since: 3.10
ECalComponentId *
e_cal_component_id_copy (const ECalComponentId *id
);
Returns a newly-allocated copy of id
, which should be freed with
e_cal_component_free_id()
.
Since: 3.10
guint e_cal_component_id_hash (const ECalComponentId *id
);
Generates a hash value for id
.
Since: 3.10
gboolean e_cal_component_id_equal (const ECalComponentId *id1
,const ECalComponentId *id2
);
Compares two ECalComponentId structs for equality.
Since: 3.10
void e_cal_component_get_categories (,
ECalComponent *compconst
);gchar **categories
Queries the categories of the given calendar component. The categories
are returned in the categories
argument, which, on success, will contain
a comma-separated list of all categories set in the component.
void e_cal_component_set_categories (,
ECalComponent *compconst
);gchar *categories
Sets the list of categories for a calendar component.
void e_cal_component_get_categories_list (,
ECalComponent *comp);
GSList **categ_list
Queries the list of categories of a calendar component object. Each element in the returned categ_list is a string with the corresponding category.
comp |
A calendar component object. |
|
categ_list |
Return value for the
list of strings, where each string is a category. This should be freed using
|
[out][transfer full][element-type utf8] |
void e_cal_component_set_categories_list (,
ECalComponent *comp);
GSList *categ_list
Sets the list of categories of a calendar component object.
void e_cal_component_get_classification (,
ECalComponent *compECalComponentClassification *classif
);
Queries the classification of a calendar component object. If the classification property is not set on this component, this function returns E_CAL_COMPONENT_CLASS_NONE.
void e_cal_component_set_classification (,
ECalComponent *compECalComponentClassification classif
);
Sets the classification property of a calendar component object. To unset
the property, specify E_CAL_COMPONENT_CLASS_NONE for classif
.
void e_cal_component_get_comment_list (,
ECalComponent *comp);
GSList **text_list
Queries the comments of a calendar component object. The comment property can appear several times inside a calendar component, and so a list of ECalComponentText is returned.
comp |
A calendar component object. |
|
text_list |
Return
value for the comment properties and their parameters, as a list of
ECalComponentText structures. This should be freed using the
|
[out][transfer full][element-type ECalComponentText] |
void e_cal_component_set_comment_list (,
ECalComponent *comp);
GSList *text_list
Sets the comments of a calendar component object. The comment property can appear several times inside a calendar component, and so a list of ECalComponentText structures is used.
comp |
A calendar component object. |
|
text_list |
List of ECalComponentText structures. |
[element-type ECalComponentText] |
void e_cal_component_get_completed (,
ECalComponent *compstruct icaltimetype **t
);
Queries the date at which a calendar compoment object was completed.
comp |
A calendar component object. |
|
t |
Return value for the completion date. This should be freed using the
|
[out] |
void e_cal_component_set_completed (,
ECalComponent *compstruct icaltimetype *t
);
Sets the date at which a calendar component object was completed.
void e_cal_component_get_contact_list (,
ECalComponent *comp);
GSList **text_list
Queries the contact of a calendar component object. The contact property can appear several times inside a calendar component, and so a list of ECalComponentText is returned.
comp |
A calendar component object. |
|
text_list |
Return
value for the contact properties and their parameters, as a list of
ECalComponentText structures. This should be freed using the
|
[out][transfer full][element-type ECalComponentText] |
void e_cal_component_set_contact_list (,
ECalComponent *comp);
GSList *text_list
Sets the contact of a calendar component object. The contact property can appear several times inside a calendar component, and so a list of ECalComponentText structures is used.
comp |
A calendar component object. |
|
text_list |
List of ECalComponentText structures. |
[element-type ECalComponentText] |
void e_cal_component_get_created (,
ECalComponent *compstruct icaltimetype **t
);
Queries the date in which a calendar component object was created in the calendar store.
comp |
A calendar component object. |
|
t |
Return value for the creation date. This should be freed using the
|
[out] |
void e_cal_component_set_created (,
ECalComponent *compstruct icaltimetype *t
);
Sets the date in which a calendar component object is created in the calendar store. This should only be used inside a calendar store application, i.e. not by calendar user agents.
void e_cal_component_get_description_list (,
ECalComponent *comp);
GSList **text_list
Queries the description of a calendar component object. Journal components may have more than one description, and as such this function returns a list of ECalComponentText structures. All other types of components can have at most one description.
comp |
A calendar component object. |
|
text_list |
Return
value for the description properties and their parameters, as a list of
ECalComponentText structures. This should be freed using the
|
[out][transfer full][element-type ECalComponentText] |
void e_cal_component_set_description_list (,
ECalComponent *comp);
GSList *text_list
Sets the description of a calendar component object. Journal components may have more than one description, and as such this function takes in a list of ECalComponentText structures. All other types of components can have at most one description.
comp |
A calendar component object. |
|
text_list |
List of ECalComponentText structures. |
[element-type ECalComponentText] |
void e_cal_component_get_dtend (,
ECalComponent *compECalComponentDateTime *dt
);
Queries the date/time end of a calendar component object.
comp |
A calendar component object. |
|
dt |
Return value for the date/time end. This should be freed with the
|
[out] |
void e_cal_component_set_dtend (,
ECalComponent *compECalComponentDateTime *dt
);
Sets the date/time end property of a calendar component object.
void e_cal_component_get_dtstamp (,
ECalComponent *compstruct icaltimetype *t
);
Queries the date/timestamp property of a calendar component object, which is the last time at which the object was modified by a calendar user agent.
void e_cal_component_set_dtstamp (,
ECalComponent *compstruct icaltimetype *t
);
Sets the date/timestamp of a calendar component object. This should be called whenever a calendar user agent makes a change to a component's properties.
void e_cal_component_get_dtstart (,
ECalComponent *compECalComponentDateTime *dt
);
Queries the date/time start of a calendar component object.
comp |
A calendar component object. |
|
dt |
Return value for the date/time start. This should be freed with the
|
[out] |
void e_cal_component_set_dtstart (,
ECalComponent *compECalComponentDateTime *dt
);
Sets the date/time start property of a calendar component object.
void e_cal_component_get_due (,
ECalComponent *compECalComponentDateTime *dt
);
Queries the due date/time of a calendar component object.
comp |
A calendar component object. |
|
dt |
Return value for the due date/time. This should be freed with the
|
[out] |
void e_cal_component_set_due (,
ECalComponent *compECalComponentDateTime *dt
);
Sets the due date/time property of a calendar component object.
void e_cal_component_get_exdate_list (,
ECalComponent *comp);
GSList **exdate_list
Queries the list of exception date properties in a calendar component object.
comp |
A calendar component object. |
|
exdate_list |
Return value for the list of exception dates, as a list of
ECalComponentDateTime structures. This should be freed using the
|
[out][transfer full][element-type ECalComponentDateTime] |
void e_cal_component_set_exdate_list (,
ECalComponent *comp);
GSList *exdate_list
Sets the list of exception dates in a calendar component object.
comp |
A calendar component object. |
|
exdate_list |
List of ECalComponentDateTime structures. |
[element-type ECalComponentDateTime] |
gboolean e_cal_component_has_exdates ();
ECalComponent *comp
Queries whether a calendar component object has any exception dates defined for it.
void e_cal_component_get_exrule_list (,
ECalComponent *comp);
GSList **recur_list
Queries the list of exception rule properties of a calendar component object.
comp |
A calendar component object. |
|
recur_list |
List of
exception rules as struct |
[out][element-type icalrecurrencetype][transfer full] |
void e_cal_component_get_exrule_property_list (,
ECalComponent *comp);
GSList **recur_list
Queries the list of exception rule properties of a calendar component object.
void e_cal_component_set_exrule_list (,
ECalComponent *comp);
GSList *recur_list
Sets the list of exception rules in a calendar component object.
gboolean e_cal_component_has_exrules ();
ECalComponent *comp
Queries whether a calendar component object has any exception rules defined for it.
gboolean e_cal_component_has_exceptions ();
ECalComponent *comp
Queries whether a calendar component object has any exception dates or exception rules.
void e_cal_component_get_geo (,
ECalComponent *compstruct icalgeotype **geo
);
Gets the geographic position property of a calendar component object.
comp |
A calendar component object. |
|
geo |
Return value for the geographic position property. This should be
freed using the |
[out] |
void e_cal_component_set_geo (,
ECalComponent *compstruct icalgeotype *geo
);
Sets the geographic position property on a calendar component object.
void e_cal_component_get_last_modified (,
ECalComponent *compstruct icaltimetype **t
);
Queries the time at which a calendar component object was last modified in the calendar store.
void e_cal_component_set_last_modified (,
ECalComponent *compstruct icaltimetype *t
);
Sets the time at which a calendar component object was last stored in the calendar store. This should not be called by plain calendar user agents.
void e_cal_component_get_organizer (,
ECalComponent *compECalComponentOrganizer *organizer
);
Queries the organizer property of a calendar component object
void e_cal_component_set_organizer (,
ECalComponent *compECalComponentOrganizer *organizer
);
Sets the organizer of a calendar component object
gboolean e_cal_component_has_organizer ();
ECalComponent *comp
Check whether a calendar component object has an organizer or not.
gint e_cal_component_get_percent_as_int ();
ECalComponent *comp
Get percent complete as an integer value
Since: 2.28
void e_cal_component_set_percent_as_int (,
ECalComponent *comp);
gint percent
Sets percent complete as integer. The percent
can be between 0 and 100, inclusive.
A special value -1 can be used to remove the percent complete property.
Since: 2.28
void e_cal_component_get_percent (,
ECalComponent *comp);
gint **percent
Queries the percent-complete property of a calendar component object.
comp |
A calendar component object. |
|
percent |
Return value for the percent-complete property. This should be
freed using the |
[out] |
void e_cal_component_set_percent (,
ECalComponent *comp);
gint *percent
Sets the percent-complete property of a calendar component object.
void e_cal_component_get_priority (,
ECalComponent *comp);
gint **priority
Queries the priority property of a calendar component object.
comp |
A calendar component object. |
|
priority |
Return value for the priority property. This should be freed using
the |
[out] |
void e_cal_component_set_priority (,
ECalComponent *comp);
gint *priority
Sets the priority property of a calendar component object.
void e_cal_component_get_recurid (,
ECalComponent *compECalComponentRange *recur_id
);
Queries the recurrence id property of a calendar component object.
gchar * e_cal_component_get_recurid_as_string ();
ECalComponent *comp
Gets the recurrence ID property as a string.
void e_cal_component_set_recurid (,
ECalComponent *compECalComponentRange *recur_id
);
Sets the recurrence id property of a calendar component object.
void e_cal_component_get_rdate_list (,
ECalComponent *comp);
GSList **period_list
Queries the list of recurrence date properties in a calendar component object.
comp |
A calendar component object. |
|
period_list |
Return value for the list of recurrence dates, as a list of
ECalComponentPeriod structures. This should be freed using
|
[out][transfer full][element-type ECalComponentPeriod] |
void e_cal_component_set_rdate_list (,
ECalComponent *comp);
GSList *period_list
Sets the list of recurrence dates in a calendar component object.
comp |
A calendar component object. |
|
period_list |
List of ECalComponentPeriod structures. |
[element-type ECalComponentPeriod] |
gboolean e_cal_component_has_rdates ();
ECalComponent *comp
Queries whether a calendar component object has any recurrence dates defined for it.
void e_cal_component_get_rrule_list (,
ECalComponent *comp);
GSList **recur_list
Queries the list of recurrence rule properties of a calendar component object.
comp |
A calendar component object. |
|
recur_list |
List of
recurrence rules as struct |
[out][transfer full][element-type icalrecurrencetype] |
void e_cal_component_get_rrule_property_list (,
ECalComponent *comp);
GSList **recur_list
Queries a list of recurrence rule properties of a calendar component object.
void e_cal_component_set_rrule_list (,
ECalComponent *comp);
GSList *recur_list
Sets the list of recurrence rules in a calendar component object.
gboolean e_cal_component_has_rrules ();
ECalComponent *comp
Queries whether a calendar component object has any recurrence rules defined for it.
gboolean e_cal_component_has_recurrences ();
ECalComponent *comp
Queries whether a calendar component object has any recurrence dates or recurrence rules.
gboolean e_cal_component_has_simple_recurrence ();
ECalComponent *comp
Checks whether the given calendar component object has simple recurrence rules or more complicated ones.
gboolean e_cal_component_is_instance ();
ECalComponent *comp
Checks whether a calendar component object is an instance of a recurring event.
void e_cal_component_get_sequence (,
ECalComponent *comp);
gint **sequence
Queries the sequence number of a calendar component object.
comp |
A calendar component object. |
|
sequence |
Return value for the sequence number. This should be freed using
|
[out] |
void e_cal_component_set_sequence (,
ECalComponent *comp);
gint *sequence
Sets the sequence number of a calendar component object. Normally this function should not be called, since the sequence number is incremented automatically at the proper times.
void e_cal_component_get_status (,
ECalComponent *comp);
icalproperty_status *status
Queries the status property of a calendar component object.
void e_cal_component_set_status (,
ECalComponent *comp);
icalproperty_status status
Sets the status property of a calendar component object.
void e_cal_component_get_summary (,
ECalComponent *compECalComponentText *summary
);
Queries the summary of a calendar component object.
void e_cal_component_set_summary (,
ECalComponent *compECalComponentText *summary
);
Sets the summary of a calendar component object.
void e_cal_component_get_transparency (,
ECalComponent *compECalComponentTransparency *transp
);
Queries the time transparency of a calendar component object.
void e_cal_component_set_transparency (,
ECalComponent *compECalComponentTransparency transp
);
Sets the time transparency of a calendar component object.
void e_cal_component_get_url (,
ECalComponent *compconst
);gchar **url
Queries the uniform resource locator property of a calendar component object.
void e_cal_component_set_url (,
ECalComponent *compconst
);gchar *url
Sets the uniform resource locator property of a calendar component object.
void e_cal_component_get_attendee_list (,
ECalComponent *comp);
GSList **attendee_list
Queries the attendee properties of the calendar component object
comp |
A calendar component object. |
|
attendee_list |
Return value for the attendee property. This should be freed using
|
[out][transfer full][element-type ECalComponentAttendee] |
void e_cal_component_set_attendee_list (,
ECalComponent *comp);
GSList *attendee_list
Sets the attendees of a calendar component object
gboolean e_cal_component_has_attendees ();
ECalComponent *comp
Queries a calendar component object for the existence of attendees.
void e_cal_component_get_location (,
ECalComponent *compconst
);gchar **location
Queries the location property of a calendar component object.
void e_cal_component_set_location (,
ECalComponent *compconst
);gchar *location
Sets the location property of a calendar component object.
void e_cal_component_get_attachment_list (,
ECalComponent *comp);
GSList **attachment_list
Queries the attachment properties of the calendar component object. When done,
the attachment_list
should be freed by calling g_slist_free()
void e_cal_component_set_attachment_list (,
ECalComponent *comp);
GSList *attachment_list
This currently handles only attachments that are URIs in the file system - not inline binaries.
Sets the attachments of a calendar component object
gboolean e_cal_component_has_attachments ();
ECalComponent *comp
Queries the component to see if it has attachments.
gint e_cal_component_get_num_attachments ();
ECalComponent *comp
Get the number of attachments to this calendar component object.
gboolean e_cal_component_event_dates_match (,
ECalComponent *comp1);
ECalComponent *comp2
Checks if the DTSTART and DTEND properties of the 2 components match. Note that the events may have different recurrence properties which are not taken into account here.
void e_cal_component_free_categories_list ();
GSList *categ_list
Frees a list of category strings.
void e_cal_component_free_datetime (ECalComponentDateTime *dt
);
Frees a date/time structure.
void e_cal_component_free_range (ECalComponentRange *range
);
Frees an ECalComponentRange structure.
void e_cal_component_free_exdate_list ();
GSList *exdate_list
Frees a list of ECalComponentDateTime structures as returned by the
e_cal_component_get_exdate_list()
function.
exdate_list |
List of ECalComponentDateTime structures. |
[element-type ECalComponentDateTime] |
void e_cal_component_free_geo (struct icalgeotype *geo
);
Frees a struct
void e_cal_component_free_icaltimetype (struct icaltimetype *t
);
Frees a struct
void e_cal_component_free_percent ();
gint *percent
Frees a percent value as returned by the e_cal_component_get_percent()
function.
void e_cal_component_free_priority ();
gint *priority
Frees a priority value as returned by the e_cal_component_get_priority()
function.
void e_cal_component_free_period_list ();
GSList *period_list
Frees a list of ECalComponentPeriod structures.
void e_cal_component_free_recur_list ();
GSList *recur_list
Frees a list of struct
void e_cal_component_free_sequence ();
gint *sequence
Frees a sequence number value.
void e_cal_component_free_text_list ();
GSList *text_list
Frees a list of ECalComponentText structures. This function should only be
used to free lists of text values as returned by the other getter functions
of
void e_cal_component_free_attendee_list ();
GSList *attendee_list
Frees a list of ECalComponentAttendee structures.
gboolean e_cal_component_has_alarms ();
ECalComponent *comp
Checks whether the component has any alarms.
void e_cal_component_add_alarm (,
ECalComponent *comp);
ECalComponentAlarm *alarm
Adds an alarm subcomponent to a calendar component. You should have created
the alarm
by using e_cal_component_alarm_new()
; it is invalid to use a
e_cal_component_get_alarm()
. After
adding the alarm, the alarm
structure is no longer valid because the
internal structures may change and you should get rid of it by using
e_cal_component_alarm_free()
.
void e_cal_component_remove_alarm (,
ECalComponent *compconst
);gchar *auid
Removes an alarm subcomponent from a calendar component. If the alarm that
corresponds to the specified auid
had been fetched with
e_cal_component_get_alarm()
, then those alarm structures will be invalid; you
should get rid of them with e_cal_component_alarm_free()
before using this
function.
void e_cal_component_remove_all_alarms ();
ECalComponent *comp
Remove all alarms from the calendar component
GList * e_cal_component_get_alarm_uids ();
ECalComponent *comp
Builds a list of the unique identifiers of the alarm subcomponents inside a calendar component.
List of unique identifiers for
alarms. This should be freed using cal_obj_uid_list_free()
.
[element-type utf8][transfer full]
ECalComponentAlarm * e_cal_component_get_alarm (,
ECalComponent *compconst
);gchar *auid
Queries a particular alarm subcomponent of a calendar component.
The alarm subcomponent that corresponds to the specified auid
,
or NULL
e_cal_component_alarm_free()
.
void e_cal_component_alarms_free (ECalComponentAlarms *alarms
);
Frees a ECalComponentAlarms structure.
ECalComponentAlarm * e_cal_component_alarm_new (void
);
Create a new alarm object.
ECalComponentAlarm * e_cal_component_alarm_clone ();
ECalComponentAlarm *alarm
Creates a new alarm subcomponent by copying the information from another one.
A newly-created alarm subcomponent with the same values as the
original one. Should be freed with e_cal_component_alarm_free()
.
void e_cal_component_alarm_free ();
ECalComponentAlarm *alarm
Frees an alarm structure.
constgchar * e_cal_component_alarm_get_uid ();
ECalComponentAlarm *alarm
Queries the unique identifier of an alarm subcomponent.
void e_cal_component_alarm_get_action (,
ECalComponentAlarm *alarmECalComponentAlarmAction *action
);
Queries the action type of an alarm.
void e_cal_component_alarm_set_action (,
ECalComponentAlarm *alarmECalComponentAlarmAction action
);
Sets the action type for an alarm.
void e_cal_component_alarm_get_attach (,
ECalComponentAlarm *alarm);
icalattach **attach
Queries the attachment property of an alarm.
void e_cal_component_alarm_set_attach (,
ECalComponentAlarm *alarm);
icalattach *attach
Sets the attachment property of an alarm.
void e_cal_component_alarm_get_description (,
ECalComponentAlarm *alarmECalComponentText *description
);
Queries the description property of an alarm.
void e_cal_component_alarm_set_description (,
ECalComponentAlarm *alarmECalComponentText *description
);
Sets the description property of an alarm.
void e_cal_component_alarm_get_repeat (,
ECalComponentAlarm *alarmECalComponentAlarmRepeat *repeat
);
Queries the repeat/duration properties of an alarm.
void e_cal_component_alarm_set_repeat (,
ECalComponentAlarm *alarmECalComponentAlarmRepeat repeat
);
Sets the repeat/duration values for an alarm.
void e_cal_component_alarm_get_trigger (,
ECalComponentAlarm *alarmECalComponentAlarmTrigger *trigger
);
Queries the trigger time for an alarm.
void e_cal_component_alarm_set_trigger (,
ECalComponentAlarm *alarmECalComponentAlarmTrigger trigger
);
Sets the trigger time of an alarm.
void e_cal_component_alarm_get_attendee_list (,
ECalComponentAlarm *alarm);
GSList **attendee_list
Gets the list of attendees associated with an alarm.
void e_cal_component_alarm_set_attendee_list (,
ECalComponentAlarm *alarm);
GSList *attendee_list
Sets the list of attendees for an alarm.
gboolean e_cal_component_alarm_has_attendees ();
ECalComponentAlarm *alarm
Queries an alarm to see if it has attendees associated with it.
Types of calendar components to be stored by a ECalComponent, as per RFC 2445. We don't put the alarm component type here since we store alarms as separate structures inside the other "real" components.
Field identifiers for a calendar component.
typedef struct { /* Actual date/time value */ struct icaltimetype *value; /* Timezone ID */ const gchar *tzid; } ECalComponentDateTime;
Time with timezone property
typedef struct { ECalComponentPeriodType type; struct icaltimetype start; union { struct icaltimetype end; struct icaldurationtype duration; } u; } ECalComponentPeriod;
Period of time, can have explicit start/end times or start/duration instead
typedef struct { ECalComponentRangeType type; ECalComponentDateTime datetime; } ECalComponentRange;
Describes a range
ECalComponentRangeType |
||
ECalComponentDateTime |
an ECalComponentDateTime of the range |
typedef struct { /* Description string */ const gchar *value; /* Alternate representation URI */ const gchar *altrep; } ECalComponentText;
For the text properties
typedef struct { const gchar *value; const gchar *member; icalparameter_cutype cutype; icalparameter_role role; icalparameter_partstat status; gboolean rsvp; const gchar *delto; const gchar *delfrom; const gchar *sentby; const gchar *cn; const gchar *language; } ECalComponentAttendee;
Describes an attendee
typedef struct { const gchar *value; const gchar *sentby; const gchar *cn; const gchar *language; } ECalComponentOrganizer;
Describes an organizer
typedef struct { /* UID of the alarm that triggered */ gchar *auid; /* Trigger time, i.e. "5 minutes before the appointment" */ time_t trigger; /* Actual event occurrence to which this trigger corresponds */ time_t occur_start; time_t occur_end; } ECalComponentAlarmInstance;
An alarm occurrence, i.e. a trigger instance
typedef struct { /* The actual component */ ECalComponent *comp; /* List of ECalComponentAlarmInstance structures */ GSList *alarms; } ECalComponentAlarms;
Alarm trigger instances for a particular component
The actual alarm component |
||
List of ECalComponentAlarmInstance structures. |
[element-type ECalComponentAlarmInstance] |
Whether a trigger is relative to the start or end of an event occurrence, or whether it is specified to occur at an absolute time.
typedef struct { ECalComponentAlarmTriggerType type; union { struct icaldurationtype rel_duration; struct icaltimetype abs_time; } u; } ECalComponentAlarmTrigger;
When the alarm is supposed to be triggered