calendar/libecal/e-cal.h

   1 /* Evolution calendar ecal
   2  *
   3  * Copyright (C) 2001 Ximian, Inc.
   4  *
   5  * Authors: Federico Mena-Quintero <federico@ximian.com>
   6  *
   7  * This program is free software; you can redistribute it and/or
   8  * modify it under the terms of version 2 of the GNU General Public
   9  * License as published by the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
  19  */
  20
  21 #ifndef E_CAL_H
  22 #define E_CAL_H
  23
  24 #include <glib-object.h>
  25 #include <libecal/e-cal-recur.h>
  26 #include <libecal/e-cal-util.h>
  27 #include <libecal/e-cal-view.h>
  28 #include <libecal/e-cal-types.h>
  29
  30 G_BEGIN_DECLS
  31
  32 \f
  33
  34 #define E_TYPE_CAL            (e_cal_get_type ())
  35 #define E_CAL(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), E_TYPE_CAL, ECal))
  36 #define E_CAL_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), E_TYPE_CAL, ECalClass))
  37 #define E_IS_CAL(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), E_TYPE_CAL))
  38 #define E_IS_CAL_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), E_TYPE_CAL))
  39
  40 #define E_CAL_OPEN_STATUS_ENUM_TYPE     (e_cal_open_status_enum_get_type ())
  41 #define E_CAL_SET_MODE_STATUS_ENUM_TYPE (e_cal_set_mode_status_enum_get_type ())
  42 #define CAL_MODE_ENUM_TYPE                   (cal_mode_enum_get_type ())
  43
  44 typedef struct _ECal ECal;
  45 typedef struct _ECalClass ECalClass;
  46 typedef struct _ECalPrivate ECalPrivate;
  47
  48 /* Open status for the cal_opened signal */
  49 typedef enum {
  50         E_CAL_OPEN_SUCCESS,
  51         E_CAL_OPEN_ERROR,
  52         E_CAL_OPEN_NOT_FOUND,
  53         E_CAL_OPEN_PERMISSION_DENIED,
  54         E_CAL_OPEN_METHOD_NOT_SUPPORTED
  55 } ECalOpenStatus;
  56
  57 /* Set mode status for the e_cal_set_mode function */
  58 typedef enum {
  59         E_CAL_SET_MODE_SUCCESS,
  60         E_CAL_SET_MODE_ERROR,
  61         E_CAL_SET_MODE_NOT_SUPPORTED
  62 } ECalSetModeStatus;
  63
  64 /* Whether the ecal is not loaded, is being loaded, or is already loaded */
  65 typedef enum {
  66         E_CAL_LOAD_NOT_LOADED,
  67         E_CAL_LOAD_LOADING,
  68         E_CAL_LOAD_LOADED
  69 } ECalLoadState;
  70
  71 struct _ECal {
  72         GObject object;
  73
  74         /*< private >*/
  75         ECalPrivate *priv;
  76 };
  77
  78 struct _ECalClass {
  79         GObjectClass parent_class;
  80
  81         /* Notification signals */
  82
  83         void (* cal_opened) (ECal *ecal, ECalOpenStatus status);
  84         void (* cal_set_mode) (ECal *ecal, ECalSetModeStatus status, CalMode mode);
  85
  86         void (* backend_error) (ECal *ecal, const char *message);
  87
  88         void (* categories_changed) (ECal *ecal, GPtrArray *categories);
  89
  90         void (* forget_password) (ECal *ecal, const char *key);
  91
  92         void (* backend_died) (ECal *ecal);
  93 };
  94
  95 typedef gchar * (* ECalAuthFunc) (ECal *ecal,
  96                                       const gchar *prompt,
  97                                       const gchar *key,
  98                                       gpointer user_data);
  99
 100 GType e_cal_get_type (void);
 101
 102 GType e_cal_open_status_enum_get_type (void);
 103 GType e_cal_set_mode_status_enum_get_type (void);
 104 GType cal_mode_enum_get_type (void);
 105
 106 ECal *e_cal_new (const char *uri, CalObjType type);
 107
 108 void e_cal_set_auth_func (ECal *ecal, ECalAuthFunc func, gpointer data);
 109
 110 gboolean e_cal_open (ECal *ecal, gboolean only_if_exists, GError **error);
 111 void e_cal_open_async (ECal *ecal, gboolean only_if_exists);
 112 gboolean e_cal_remove_calendar (ECal *ecal, GError **error);
 113
 114 GList *e_cal_uri_list (ECal *ecal, CalMode mode);
 115
 116 ECalLoadState e_cal_get_load_state (ECal *ecal);
 117
 118 const char *e_cal_get_uri (ECal *ecal);
 119
 120 gboolean e_cal_is_read_only (ECal *ecal, gboolean *read_only, GError **error);
 121 gboolean e_cal_get_cal_address (ECal *ecal, char **cal_address, GError **error);
 122 gboolean e_cal_get_alarm_email_address (ECal *ecal, char **alarm_address, GError **error);
 123 gboolean e_cal_get_ldap_attribute (ECal *ecal, char **ldap_attribute, GError **error);
 124
 125 gboolean e_cal_get_one_alarm_only (ECal *ecal);
 126 gboolean e_cal_get_organizer_must_attend (ECal *ecal);
 127 gboolean e_cal_get_save_schedules (ECal *ecal);
 128 gboolean e_cal_get_static_capability (ECal *ecal, const char *cap);
 129
 130 gboolean e_cal_set_mode (ECal *ecal, CalMode mode);
 131
 132 gboolean e_cal_get_default_object (ECal *ecal,
 133                                         icalcomponent **icalcomp, GError **error);
 134
 135 gboolean e_cal_get_object (ECal *ecal,
 136                                 const char *uid,
 137                                 const char *rid,
 138                                 icalcomponent **icalcomp,
 139                                 GError **error);
 140
 141 gboolean e_cal_get_changes (ECal *ecal, const char *change_id, GList **changes, GError **error);
 142 void e_cal_free_change_list (GList *list);
 143
 144 gboolean e_cal_get_object_list (ECal *ecal, const char *query, GList **objects, GError **error);
 145 gboolean e_cal_get_object_list_as_comp (ECal *ecal, const char *query, GList **objects, GError **error);
 146 void e_cal_free_object_list (GList *objects);
 147
 148 gboolean e_cal_get_free_busy (ECal *ecal, GList *users, time_t start, time_t end,
 149                                    GList **freebusy, GError **error);
 150
 151 void e_cal_generate_instances (ECal *ecal, CalObjType type,
 152                                     time_t start, time_t end,
 153                                     ECalRecurInstanceFn cb, gpointer cb_data);
 154
 155 GSList *e_cal_get_alarms_in_range (ECal *ecal, time_t start, time_t end);
 156
 157 void e_cal_free_alarms (GSList *comp_alarms);
 158
 159 gboolean e_cal_get_alarms_for_object (ECal *ecal, const char *uid,
 160                                            time_t start, time_t end,
 161                                            ECalComponentAlarms **alarms);
 162
 163 gboolean e_cal_create_object (ECal *ecal, icalcomponent *icalcomp, char **uid, GError **error);
 164 gboolean e_cal_modify_object (ECal *ecal, icalcomponent *icalcomp, CalObjModType mod, GError **error);
 165 gboolean e_cal_remove_object (ECal *ecal, const char *uid, GError **error);
 166 gboolean e_cal_remove_object_with_mod (ECal *ecal, const char *uid, const char *rid, CalObjModType mod, GError **error);
 167
 168 gboolean e_cal_discard_alarm (ECal *ecal, ECalComponent *comp, const char *auid, GError **error);
 169
 170 gboolean e_cal_receive_objects (ECal *ecal, icalcomponent *icalcomp, GError **error);
 171 gboolean e_cal_send_objects (ECal *ecal, icalcomponent *icalcomp, GError **error);
 172
 173 gboolean e_cal_get_timezone (ECal *ecal, const char *tzid, icaltimezone **zone, GError **error);
 174 gboolean e_cal_add_timezone (ECal *ecal, icaltimezone *izone, GError **error);
 175 /* Sets the default timezone to use to resolve DATE and floating DATE-TIME
 176    values. This will typically be from the user's timezone setting. Call this
 177    before using any other functions. It will pass the default timezone on to
 178    the server. Returns TRUE on success. */
 179 gboolean e_cal_set_default_timezone (ECal *ecal, icaltimezone *zone, GError **error);
 180
 181 gboolean e_cal_get_query (ECal *ecal, const char *sexp, ECalView **query, GError **error);
 182
 183 /* Resolves TZIDs for the recurrence generator. */
 184 icaltimezone *e_cal_resolve_tzid_cb (const char *tzid, gpointer data);
 185
 186 /* Returns a complete VCALENDAR for a VEVENT/VTODO including all VTIMEZONEs
 187    used by the component. It also includes a 'METHOD:PUBLISH' property. */
 188 char* e_cal_get_component_as_string (ECal *ecal, icalcomponent *icalcomp);
 189
 190 const char * e_cal_get_error_message (ECalendarStatus status);
 191
 192 G_END_DECLS
 193
 194 #endif