aboutsummaryrefslogtreecommitdiffstats
path: root/calendar/gui/gnome-cal.h
blob: 2b7eac85f1fed4a5afe7833f68ed0281f04c12f4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
/*
 * Evolution calendar - Main calendar view widget
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) version 3.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with the program; if not, see <http://www.gnu.org/licenses/>
 *
 *
 * Authors:
 *      Miguel de Icaza <miguel@ximian.com>
 *      Federico Mena-Quintero <federico@ximian.com>
 *      Seth Alves <alves@hungry.com>
 *
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
 *
 */

#ifndef GNOME_CALENDAR_H
#define GNOME_CALENDAR_H

#include <time.h>
#include <gtk/gtk.h>
#include <misc/e-calendar.h>
#include <libecal/e-cal.h>
#include <shell/e-shell-settings.h>

#include "e-calendar-table.h"

/* Standard GObject macros */
#define GNOME_TYPE_CALENDAR \
    (gnome_calendar_get_type ())
#define GNOME_CALENDAR(obj) \
    (G_TYPE_CHECK_INSTANCE_CAST \
    ((obj), GNOME_TYPE_CALENDAR, GnomeCalendar))
#define GNOME_CALENDAR_CLASS(cls) \
    (G_TYPE_CHECK_INSTANCE_CAST_CLASS \
    ((cls), GNOME_TYPE_CALENDAR, GnomeCalendarClass))
#define GNOME_IS_CALENDAR(obj) \
    (G_TYPE_CHECK_INSTANCE_TYPE \
    ((obj), GNOME_TYPE_CALENDAR))
#define GNOME_IS_CALENDAR_CLASS(cls) \
    (G_TYPE_CHECK_CLASS_TYPE \
    ((cls), GNOME_TYPE_CALENDAR))
#define GNOME_CALENDAR_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS \
    ((obj), GNOME_TYPE_CALENDAR, GnomeCalendarClass))

G_BEGIN_DECLS

/* Avoid circular inclusion. */
struct _ECalendarView;

typedef struct _GnomeCalendar GnomeCalendar;
typedef struct _GnomeCalendarClass GnomeCalendarClass;
typedef struct _GnomeCalendarPrivate GnomeCalendarPrivate;

/* View types */
typedef enum {
    GNOME_CAL_DAY_VIEW,
    GNOME_CAL_WORK_WEEK_VIEW,
    GNOME_CAL_WEEK_VIEW,
    GNOME_CAL_MONTH_VIEW,
    GNOME_CAL_LIST_VIEW,
    GNOME_CAL_LAST_VIEW
} GnomeCalendarViewType;

typedef enum {
    GNOME_CAL_GOTO_TODAY,
    GNOME_CAL_GOTO_DATE,
    GNOME_CAL_GOTO_FIRST_DAY_OF_MONTH,
    GNOME_CAL_GOTO_LAST_DAY_OF_MONTH,
    GNOME_CAL_GOTO_FIRST_DAY_OF_WEEK,
    GNOME_CAL_GOTO_LAST_DAY_OF_WEEK,
    GNOME_CAL_GOTO_SAME_DAY_OF_PREVIOUS_WEEK,
    GNOME_CAL_GOTO_SAME_DAY_OF_NEXT_WEEK
} GnomeCalendarGotoDateType;

struct _GnomeCalendar {
    GtkVBox vbox;
    GnomeCalendarPrivate *priv;
};

struct _GnomeCalendarClass {
    GtkVBoxClass parent_class;

    /* Notification signals */
    void (* dates_shown_changed)    (GnomeCalendar *gcal);

    void (* calendar_selection_changed) (GnomeCalendar *gcal);

    void (* calendar_focus_change)  (GnomeCalendar *gcal, gboolean in);
    void (* change_view) (GnomeCalendar *gcal,
                   GnomeCalendarViewType view_type);

        void (* source_added)           (GnomeCalendar *gcal, ESource *source);
        void (* source_removed)         (GnomeCalendar *gcal, ESource *source);

    /* Action signals */
        void (* goto_date)              (GnomeCalendar *gcal, GnomeCalendarGotoDateType date);
};

GType       gnome_calendar_get_type     (void);
GtkWidget * gnome_calendar_new      (EShellSettings *shell_settings);
EShellSettings *gnome_calendar_get_shell_settings
                        (GnomeCalendar *gcal);
ECalendar * gnome_calendar_get_date_navigator
                        (GnomeCalendar *gcal);
void        gnome_calendar_set_date_navigator
                        (GnomeCalendar *gcal,
                         ECalendar *date_navigator);
ECalModel * gnome_calendar_get_model    (GnomeCalendar *gcal);
gboolean    gnome_calendar_remove_source    (GnomeCalendar *gcal,
                         ESource *source);
gboolean    gnome_calendar_remove_source_by_uid
                        (GnomeCalendar *gcal,
                         const gchar *uid);
gboolean    gnome_calendar_set_default_source
                        (GnomeCalendar *gcal,
                         ESource *source);
void        gnome_calendar_update_query (GnomeCalendar *gcal);
void        gnome_calendar_set_search_query (GnomeCalendar *gcal,
                         const gchar *sexp,
                         gboolean range_search,
                         time_t start_range,
                         time_t end_range);

void        gnome_calendar_next     (GnomeCalendar *gcal);
void        gnome_calendar_previous     (GnomeCalendar *gcal);
void        gnome_calendar_goto     (GnomeCalendar *gcal,
                         time_t new_time);
void        gnome_calendar_update_view_times(GnomeCalendar *gcal,
                         time_t start_time);
void        gnome_calendar_dayjump      (GnomeCalendar *gcal,
                         time_t time);
void        gnome_calendar_goto_today   (GnomeCalendar *gcal);

GnomeCalendarViewType
        gnome_calendar_get_view     (GnomeCalendar *gcal);
void        gnome_calendar_set_view     (GnomeCalendar *gcal,
                         GnomeCalendarViewType view_type);
void        gnome_calendar_display_view (GnomeCalendar *gcal,
                         GnomeCalendarViewType view_type);

struct _ECalendarView *
        gnome_calendar_get_calendar_view(GnomeCalendar *gcal,
                         GnomeCalendarViewType view_type);

gboolean    gnome_calendar_get_range_selected
                        (GnomeCalendar *gcal);
void        gnome_calendar_set_range_selected
                        (GnomeCalendar *gcal,
                         gboolean range_selected);
void        gnome_calendar_set_selected_time_range
                        (GnomeCalendar *gcal,
                         time_t start_time);
void        gnome_calendar_new_task     (GnomeCalendar *gcal,
                         time_t *dtstart,
                         time_t *dtend);

/* Returns the selected time range for the current view. Note that this may be
   different from the fields in the GnomeCalendar, since the view may clip
   this or choose a more appropriate time. */
void        gnome_calendar_get_current_time_range
                        (GnomeCalendar *gcal,
                         time_t *start_time,
                         time_t *end_time);

void        gnome_calendar_notify_dates_shown_changed
                        (GnomeCalendar *gcal);

/* Returns the number of selected events (0 or 1 at present). */
gint        gnome_calendar_get_num_events_selected
                        (GnomeCalendar *gcal);

void        gnome_calendar_purge        (GnomeCalendar  *gcal,
                         time_t older_than);

/* Direct calendar component operations */
void        gnome_calendar_edit_appointment (GnomeCalendar *gcal,
                         const gchar * src_uid,
                         const gchar * comp_uid,
                         const gchar * comp_rid);

G_END_DECLS

#endif