CalObjInstance

typedef struct {
	gchar *uid;			/* UID of the object */
	time_t start;			/* Start time of instance */
	time_t end;			/* End time of instance */
} CalObjInstance;

cal_obj_instance_list_free ()

void                cal_obj_instance_list_free          (GList *list);

Frees a list of CalObjInstance structures.

cal_obj_uid_list_free ()

void                cal_obj_uid_list_free               (GList *list);

Frees a list of unique identifiers for calendar objects.

e_cal_util_new_top_level ()

icalcomponent *     e_cal_util_new_top_level            (void);

Creates a new VCALENDAR component.

e_cal_util_new_component ()

icalcomponent *     e_cal_util_new_component            (icalcomponent_kind kind);

Creates a new icalcomponent of the specified kind.

e_cal_util_parse_ics_string ()

icalcomponent *     e_cal_util_parse_ics_string         (const gchar *string);

Parses an iCalendar string and returns a new icalcomponent representing that string. Note that this function deals with multiple VCALENDAR's in the string, something that Mozilla used to do and which libical does not support.

e_cal_util_parse_ics_file ()

icalcomponent *     e_cal_util_parse_ics_file           (const gchar *filename);

Parses the given file, and, if it contains a valid iCalendar object, parse it and return a new icalcomponent.

e_cal_util_generate_alarms_for_comp ()

ECalComponentAlarms * e_cal_util_generate_alarms_for_comp
                                                        (ECalComponent *comp,
                                                         time_t start,
                                                         time_t end,
                                                         ECalComponentAlarmAction *omit,
                                                         ECalRecurResolveTimezoneFn resolve_tzid,
                                                         gpointer user_data,
                                                         icaltimezone *default_timezone);

Generates alarm instances for a calendar component. Returns the instances structure, or NULL if no alarm instances occurred in the specified time range.

e_cal_util_generate_alarms_for_list ()

gint                e_cal_util_generate_alarms_for_list (GList *comps,
                                                         time_t start,
                                                         time_t end,
                                                         ECalComponentAlarmAction *omit,
                                                         GSList **comp_alarms,
                                                         ECalRecurResolveTimezoneFn resolve_tzid,
                                                         gpointer user_data,
                                                         icaltimezone *default_timezone);

Iterates through all the components in the comps list and generates alarm instances for them; putting them in the comp_alarms list.

e_cal_util_priority_to_string ()

const gchar *       e_cal_util_priority_to_string       (gint priority);

Converts an iCalendar PRIORITY value to a translated string. Any unknown priority value (i.e. not 0-9) will be returned as "" (undefined).

e_cal_util_priority_from_string ()

gint                e_cal_util_priority_from_string     (const gchar *string);

Converts a translated priority string to an iCalendar priority value.

e_cal_util_add_timezones_from_component ()

void                e_cal_util_add_timezones_from_component
                                                        (icalcomponent *vcal_comp,
                                                         icalcomponent *icalcomp);

Adds VTIMEZONE components to a VCALENDAR for all tzid's in the given icalcomp.

e_cal_util_component_is_instance ()

gboolean            e_cal_util_component_is_instance    (icalcomponent *icalcomp);

Checks whether an icalcomponent is an instance of a recurring appointment.

e_cal_util_component_has_alarms ()

gboolean            e_cal_util_component_has_alarms     (icalcomponent *icalcomp);

Checks whether an icalcomponent has any alarm.

e_cal_util_component_has_organizer ()

gboolean            e_cal_util_component_has_organizer  (icalcomponent *icalcomp);

Checks whether an icalcomponent has an organizer.

e_cal_util_component_has_recurrences ()

gboolean            e_cal_util_component_has_recurrences
                                                        (icalcomponent *icalcomp);

Checks if an icalcomponent has recurrence dates or rules.

e_cal_util_component_has_rdates ()

gboolean            e_cal_util_component_has_rdates     (icalcomponent *icalcomp);

Checks if an icalcomponent has recurrence dates.

e_cal_util_component_has_rrules ()

gboolean            e_cal_util_component_has_rrules     (icalcomponent *icalcomp);

Checks if an icalcomponent has recurrence rules.

e_cal_util_component_has_attendee ()

gboolean            e_cal_util_component_has_attendee   (icalcomponent *icalcomp);

Checks if an icalcomponent has any attendees.

e_cal_util_event_dates_match ()

gboolean            e_cal_util_event_dates_match        (icalcomponent *icalcomp1,
                                                         icalcomponent *icalcomp2);

Compare the dates of two icalcomponent's to check if they match.

CAL_STATIC_CAPABILITY_NO_ALARM_REPEAT

#define CAL_STATIC_CAPABILITY_NO_ALARM_REPEAT		"no-alarm-repeat"

CAL_STATIC_CAPABILITY_NO_AUDIO_ALARMS

#define CAL_STATIC_CAPABILITY_NO_AUDIO_ALARMS		"no-audio-alarms"

CAL_STATIC_CAPABILITY_NO_DISPLAY_ALARMS

#define CAL_STATIC_CAPABILITY_NO_DISPLAY_ALARMS		"no-display-alarms"

CAL_STATIC_CAPABILITY_NO_EMAIL_ALARMS

#define CAL_STATIC_CAPABILITY_NO_EMAIL_ALARMS		"no-email-alarms"

CAL_STATIC_CAPABILITY_NO_PROCEDURE_ALARMS

#define CAL_STATIC_CAPABILITY_NO_PROCEDURE_ALARMS "no-procedure-alarms"

CAL_STATIC_CAPABILITY_NO_TASK_ASSIGNMENT

#define CAL_STATIC_CAPABILITY_NO_TASK_ASSIGNMENT "no-task-assignment"

CAL_STATIC_CAPABILITY_NO_THISANDFUTURE

#define CAL_STATIC_CAPABILITY_NO_THISANDFUTURE		"no-thisandfuture"

CAL_STATIC_CAPABILITY_NO_THISANDPRIOR

#define CAL_STATIC_CAPABILITY_NO_THISANDPRIOR		"no-thisandprior"

CAL_STATIC_CAPABILITY_NO_TRANSPARENCY

#define CAL_STATIC_CAPABILITY_NO_TRANSPARENCY		"no-transparency"

CAL_STATIC_CAPABILITY_NO_ALARM_AFTER_START

#define CAL_STATIC_CAPABILITY_NO_ALARM_AFTER_START "no-alarm-after-start"

Flag indicating that the backend does not support alarm after start the event

Since 3.8

CAL_STATIC_CAPABILITY_ALARM_DESCRIPTION

#define CAL_STATIC_CAPABILITY_ALARM_DESCRIPTION		"alarm-description"

Flag indicating that the backend supports alarm description

Since 3.8

CAL_STATIC_CAPABILITY_BULK_ADDS

#define CAL_STATIC_CAPABILITY_BULK_ADDS			"bulk-adds"

Flag indicating that the backend supports bulk additions.

Since 3.6

CAL_STATIC_CAPABILITY_BULK_MODIFIES

#define CAL_STATIC_CAPABILITY_BULK_MODIFIES		"bulk-modifies"

Flag indicating that the backend supports bulk modifications.

Since 3.6

CAL_STATIC_CAPABILITY_BULK_REMOVES

#define CAL_STATIC_CAPABILITY_BULK_REMOVES		"bulk-removes"

Flag indicating that the backend supports bulk removals.

Since 3.6

CAL_STATIC_CAPABILITY_REMOVE_ONLY_THIS

#define CAL_STATIC_CAPABILITY_REMOVE_ONLY_THIS		"remove-only-this"

FIXME: Document me.

Since 3.2

CAL_STATIC_CAPABILITY_ONE_ALARM_ONLY

#define CAL_STATIC_CAPABILITY_ONE_ALARM_ONLY		"one-alarm-only"

CAL_STATIC_CAPABILITY_ORGANIZER_MUST_ATTEND

#define CAL_STATIC_CAPABILITY_ORGANIZER_MUST_ATTEND "organizer-must-attend"

CAL_STATIC_CAPABILITY_ORGANIZER_NOT_EMAIL_ADDRESS

#define CAL_STATIC_CAPABILITY_ORGANIZER_NOT_EMAIL_ADDRESS "organizer-not-email-address"

CAL_STATIC_CAPABILITY_REMOVE_ALARMS

#define CAL_STATIC_CAPABILITY_REMOVE_ALARMS		"remove-alarms"

CAL_STATIC_CAPABILITY_CREATE_MESSAGES

#define CAL_STATIC_CAPABILITY_CREATE_MESSAGES		"create-messages"

Since 2.26

CAL_STATIC_CAPABILITY_SAVE_SCHEDULES

#define CAL_STATIC_CAPABILITY_SAVE_SCHEDULES		"save-schedules"

CAL_STATIC_CAPABILITY_NO_CONV_TO_ASSIGN_TASK

#define CAL_STATIC_CAPABILITY_NO_CONV_TO_ASSIGN_TASK "no-conv-to-assign-task"

CAL_STATIC_CAPABILITY_NO_CONV_TO_RECUR

#define CAL_STATIC_CAPABILITY_NO_CONV_TO_RECUR		"no-conv-to-recur"

CAL_STATIC_CAPABILITY_NO_GEN_OPTIONS

#define CAL_STATIC_CAPABILITY_NO_GEN_OPTIONS		"no-general-options"

CAL_STATIC_CAPABILITY_REQ_SEND_OPTIONS

#define CAL_STATIC_CAPABILITY_REQ_SEND_OPTIONS		"require-send-options"

CAL_STATIC_CAPABILITY_RECURRENCES_NO_MASTER

#define CAL_STATIC_CAPABILITY_RECURRENCES_NO_MASTER "recurrences-no-master-object"

CAL_STATIC_CAPABILITY_ORGANIZER_MUST_ACCEPT

#define CAL_STATIC_CAPABILITY_ORGANIZER_MUST_ACCEPT "organizer-must-accept"

CAL_STATIC_CAPABILITY_DELEGATE_SUPPORTED

#define CAL_STATIC_CAPABILITY_DELEGATE_SUPPORTED "delegate-support"

CAL_STATIC_CAPABILITY_NO_ORGANIZER

#define CAL_STATIC_CAPABILITY_NO_ORGANIZER		"no-organizer"

CAL_STATIC_CAPABILITY_DELEGATE_TO_MANY

#define CAL_STATIC_CAPABILITY_DELEGATE_TO_MANY		"delegate-to-many"

CAL_STATIC_CAPABILITY_HAS_UNACCEPTED_MEETING

#define CAL_STATIC_CAPABILITY_HAS_UNACCEPTED_MEETING "has-unaccepted-meeting"

CAL_STATIC_CAPABILITY_REFRESH_SUPPORTED

#define CAL_STATIC_CAPABILITY_REFRESH_SUPPORTED		"refresh-supported"

Since 2.30

e_cal_util_construct_instance ()

icalcomponent *     e_cal_util_construct_instance       (icalcomponent *icalcomp,
                                                         struct icaltimetype rid);

This checks that rid indicates a valid recurrence of icalcomp, and if so, generates a copy of comp containing a RECURRENCE-ID of rid.

e_cal_util_remove_instances ()

void                e_cal_util_remove_instances         (icalcomponent *icalcomp,
                                                         struct icaltimetype rid,
                                                         ECalObjModType mod);

Removes one or more instances from comp according to rid and mod.

FIXME: should probably have a return value indicating whether icalcomp still has any instances

e_cal_util_get_system_timezone_location ()

gchar *             e_cal_util_get_system_timezone_location
                                                        (void);

Since 2.28

e_cal_util_get_system_timezone ()

icaltimezone *      e_cal_util_get_system_timezone      (void);

Since 2.28

e_cal_util_get_component_occur_times ()

void                e_cal_util_get_component_occur_times
                                                        (ECalComponent *comp,
                                                         time_t *start,
                                                         time_t *end,
                                                         ECalRecurResolveTimezoneFn tz_cb,
                                                         gpointer tz_cb_data,
                                                         const icaltimezone *default_timezone,
                                                         icalcomponent_kind kind);

Find out when the component starts and stops, being careful about recurrences.

Since 2.32

enum CalMode

typedef enum {
	CAL_MODE_INVALID = -1,
	CAL_MODE_LOCAL   = 1 << 0,
	CAL_MODE_REMOTE  = 1 << 1,
	CAL_MODE_ANY     = 0x07
} CalMode;

cal_mode_to_corba()

#define             cal_mode_to_corba(mode)

E_CALENDAR_ERROR

#define E_CALENDAR_ERROR e_calendar_error_quark()

e_calendar_error_quark ()

GQuark              e_calendar_error_quark              (void);

enum ECalChangeType

typedef enum {
	E_CAL_CHANGE_ADDED = 1 << 0,
	E_CAL_CHANGE_MODIFIED = 1 << 1,
	E_CAL_CHANGE_DELETED = 1 << 2
} ECalChangeType;

ECalChange

typedef struct {
	ECalComponent *comp;
	ECalChangeType type;
} ECalChange;

FIXME Document me!

Since 3.6

enum ECalendarStatus

typedef enum {
	E_CALENDAR_STATUS_OK,
	E_CALENDAR_STATUS_INVALID_ARG,
	E_CALENDAR_STATUS_BUSY,
	E_CALENDAR_STATUS_REPOSITORY_OFFLINE,
	E_CALENDAR_STATUS_NO_SUCH_CALENDAR,
	E_CALENDAR_STATUS_OBJECT_NOT_FOUND,
	E_CALENDAR_STATUS_INVALID_OBJECT,
	E_CALENDAR_STATUS_URI_NOT_LOADED,
	E_CALENDAR_STATUS_URI_ALREADY_LOADED,
	E_CALENDAR_STATUS_PERMISSION_DENIED,
	E_CALENDAR_STATUS_UNKNOWN_USER,
	E_CALENDAR_STATUS_OBJECT_ID_ALREADY_EXISTS,
	E_CALENDAR_STATUS_PROTOCOL_NOT_SUPPORTED,
	E_CALENDAR_STATUS_CANCELLED,
	E_CALENDAR_STATUS_COULD_NOT_CANCEL,
	E_CALENDAR_STATUS_AUTHENTICATION_FAILED,
	E_CALENDAR_STATUS_AUTHENTICATION_REQUIRED,
	E_CALENDAR_STATUS_DBUS_EXCEPTION,
	E_CALENDAR_STATUS_OTHER_ERROR,
	E_CALENDAR_STATUS_INVALID_SERVER_VERSION,
	E_CALENDAR_STATUS_NOT_SUPPORTED
} ECalendarStatus;

E_CALENDAR_STATUS_CORBA_EXCEPTION

#define E_CALENDAR_STATUS_CORBA_EXCEPTION E_CALENDAR_STATUS_DBUS_EXCEPTION

enum EDataCalObjType

typedef enum {
	Event = 1 << 0,
	Todo = 1 << 1,
	Journal = 1 << 2,
	AnyType = 0x07
} EDataCalObjType;

FIXME Document me!

Since 3.6

enum EDataCalObjModType

typedef enum {
	This = 1 << 0,
	ThisAndPrior = 1 << 1,
	ThisAndFuture = 1 << 2,
	All = 0x07
} EDataCalObjModType;

FIXME Document me!

Since 3.6

CalObjModType

typedef ECalObjModType CalObjModType;

CALOBJ_MOD_THIS

#define CALOBJ_MOD_THIS          E_CAL_OBJ_MOD_THIS

CALOBJ_MOD_THISANDPRIOR

#define CALOBJ_MOD_THISANDPRIOR  E_CAL_OBJ_MOD_THIS_AND_PRIOR

CALOBJ_MOD_THISANDFUTURE

#define CALOBJ_MOD_THISANDFUTURE E_CAL_OBJ_MOD_THIS_AND_FUTURE

CALOBJ_MOD_ALL

#define CALOBJ_MOD_ALL           E_CAL_OBJ_MOD_ALL

CALOBJ_MOD_ONLY_THIS

#define CALOBJ_MOD_ONLY_THIS     E_CAL_OBJ_MOD_ONLY_THIS