~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to servers/exchange/storage/e-folder.c

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
2
 
/* e-folder.c
3
 
 *
4
 
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
5
 
 *
6
 
 * This program is free software; you can redistribute it and/or
7
 
 * modify it under the terms of version 2 of the GNU Lesser General Public
8
 
 * License as published by the Free Software Foundation.
9
 
 *
10
 
 * This program is distributed in the hope that it will be useful,
11
 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12
 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13
 
 * General Public License for more details.
14
 
 *
15
 
 * You should have received a copy of the GNU Lesser General Public
16
 
 * License along with this program; if not, write to the
17
 
 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18
 
 * Boston, MA 02110-1301, USA.
19
 
 *
20
 
 * Author: Ettore Perazzoli
21
 
 */
22
 
 
23
 
#ifdef HAVE_CONFIG_H
24
 
#include <config.h>
25
 
#endif
26
 
 
27
 
#include "e-folder.h"
28
 
 
29
 
#include <string.h>
30
 
#include <glib.h>
31
 
#include <libedataserver/e-data-server-util.h>
32
 
 
33
 
#define PARENT_TYPE G_TYPE_OBJECT
34
 
static GObjectClass *parent_class = NULL;
35
 
 
36
 
G_DEFINE_TYPE (EFolder, e_folder, G_TYPE_OBJECT)
37
 
 
38
 
struct EFolderPrivate {
39
 
        gchar *name;
40
 
        gchar *type;
41
 
        gchar *description;
42
 
        gchar *physical_uri;
43
 
 
44
 
        gint child_highlight;
45
 
        gint unread_count;
46
 
 
47
 
        /* Folders have a default sorting priority of zero; when deciding the
48
 
           sort order in the Evolution folder tree, folders with the same
49
 
           priority value are compared by name, while folders with a higher
50
 
           priority number always come after the folders with a lower priority
51
 
           number.  */
52
 
        gint sorting_priority;
53
 
 
54
 
        guint self_highlight : 1;
55
 
        guint is_stock : 1;
56
 
        guint can_sync_offline : 1;
57
 
        guint has_subfolders : 1;
58
 
 
59
 
        /* Custom icon for this folder; if NULL the folder will just use the
60
 
           icon for its type.  */
61
 
        gchar *custom_icon_name;
62
 
};
63
 
 
64
 
enum {
65
 
        CHANGED,
66
 
        NAME_CHANGED,
67
 
        LAST_SIGNAL
68
 
};
69
 
 
70
 
static guint signals[LAST_SIGNAL] = { 0 };
71
 
 
72
 
/* EFolder methods.   */
73
 
 
74
 
static gboolean
75
 
accept_drop (EFolder *folder, GdkDragContext *context,
76
 
             const gchar *target_type,
77
 
             GtkSelectionData *selection_data)
78
 
{
79
 
        return FALSE;
80
 
}
81
 
 
82
 
/* GObject methods.  */
83
 
 
84
 
static void
85
 
impl_finalize (GObject *object)
86
 
{
87
 
        EFolder *folder;
88
 
        EFolderPrivate *priv;
89
 
 
90
 
        folder = E_FOLDER (object);
91
 
        priv = folder->priv;
92
 
 
93
 
        g_free (priv->name);
94
 
        g_free (priv->type);
95
 
        g_free (priv->description);
96
 
        g_free (priv->physical_uri);
97
 
 
98
 
        g_free (priv->custom_icon_name);
99
 
 
100
 
        g_free (priv);
101
 
 
102
 
        (* G_OBJECT_CLASS (parent_class)->finalize) (object);
103
 
}
104
 
 
105
 
static void
106
 
e_folder_class_init (EFolderClass *klass)
107
 
{
108
 
        GObjectClass *object_class;
109
 
 
110
 
        parent_class = g_type_class_ref (PARENT_TYPE);
111
 
 
112
 
        object_class = G_OBJECT_CLASS (klass);
113
 
        object_class->finalize = impl_finalize;
114
 
 
115
 
        klass->accept_drop = accept_drop;
116
 
        signals[CHANGED] = g_signal_new ("changed",
117
 
                                         G_OBJECT_CLASS_TYPE (object_class),
118
 
                                         G_SIGNAL_RUN_FIRST,
119
 
                                         G_STRUCT_OFFSET (EFolderClass, changed),
120
 
                                         NULL, NULL,
121
 
                                         g_cclosure_marshal_VOID__VOID,
122
 
                                         G_TYPE_NONE, 0);
123
 
 
124
 
        signals[NAME_CHANGED] = g_signal_new ("name_changed",
125
 
                                              G_OBJECT_CLASS_TYPE (object_class),
126
 
                                              G_SIGNAL_RUN_FIRST,
127
 
                                              G_STRUCT_OFFSET (EFolderClass, name_changed),
128
 
                                              NULL, NULL,
129
 
                                              g_cclosure_marshal_VOID__VOID,
130
 
                                              G_TYPE_NONE, 0);
131
 
}
132
 
 
133
 
static void
134
 
e_folder_init (EFolder *folder)
135
 
{
136
 
        EFolderPrivate *priv;
137
 
 
138
 
        priv = g_new0 (EFolderPrivate, 1);
139
 
        folder->priv = priv;
140
 
}
141
 
 
142
 
void
143
 
e_folder_construct (EFolder *folder,
144
 
                    const gchar *name,
145
 
                    const gchar *type,
146
 
                    const gchar *description)
147
 
{
148
 
        EFolderPrivate *priv;
149
 
 
150
 
        g_return_if_fail (E_IS_FOLDER (folder));
151
 
        g_return_if_fail (name != NULL);
152
 
        g_return_if_fail (type != NULL);
153
 
 
154
 
        priv = folder->priv;
155
 
 
156
 
        priv->name        = g_strdup (name);
157
 
        priv->type        = g_strdup (type);
158
 
        priv->description = g_strdup (description);
159
 
}
160
 
 
161
 
EFolder *
162
 
e_folder_new (const gchar *name,
163
 
              const gchar *type,
164
 
              const gchar *description)
165
 
{
166
 
        EFolder *folder;
167
 
 
168
 
        g_return_val_if_fail (name != NULL, NULL);
169
 
        g_return_val_if_fail (type != NULL, NULL);
170
 
        g_return_val_if_fail (description != NULL, NULL);
171
 
 
172
 
        folder = g_object_new (E_TYPE_FOLDER, NULL);
173
 
 
174
 
        e_folder_construct (folder, name, type, description);
175
 
 
176
 
        return folder;
177
 
}
178
 
 
179
 
const gchar *
180
 
e_folder_get_name (EFolder *folder)
181
 
{
182
 
        g_return_val_if_fail (E_IS_FOLDER (folder), NULL);
183
 
 
184
 
        return folder->priv->name;
185
 
}
186
 
 
187
 
const gchar *
188
 
e_folder_get_type_string (EFolder *folder)
189
 
{
190
 
        g_return_val_if_fail (E_IS_FOLDER (folder), NULL);
191
 
 
192
 
        return folder->priv->type;
193
 
}
194
 
 
195
 
const gchar *
196
 
e_folder_get_description (EFolder *folder)
197
 
{
198
 
        g_return_val_if_fail (E_IS_FOLDER (folder), NULL);
199
 
 
200
 
        return folder->priv->description;
201
 
}
202
 
 
203
 
const gchar *
204
 
e_folder_get_physical_uri (EFolder *folder)
205
 
{
206
 
        g_return_val_if_fail (E_IS_FOLDER (folder), NULL);
207
 
 
208
 
        return folder->priv->physical_uri;
209
 
}
210
 
 
211
 
gint
212
 
e_folder_get_unread_count (EFolder *folder)
213
 
{
214
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
215
 
 
216
 
        return folder->priv->unread_count;
217
 
}
218
 
 
219
 
gboolean
220
 
e_folder_get_highlighted (EFolder *folder)
221
 
{
222
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
223
 
 
224
 
        return folder->priv->child_highlight || folder->priv->unread_count;
225
 
}
226
 
 
227
 
gboolean
228
 
e_folder_get_is_stock (EFolder *folder)
229
 
{
230
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
231
 
 
232
 
        return folder->priv->is_stock;
233
 
}
234
 
 
235
 
gboolean
236
 
e_folder_get_can_sync_offline (EFolder *folder)
237
 
{
238
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
239
 
 
240
 
        return folder->priv->can_sync_offline;
241
 
}
242
 
 
243
 
gboolean
244
 
e_folder_get_has_subfolders (EFolder *folder)
245
 
{
246
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
247
 
 
248
 
        return folder->priv->has_subfolders;
249
 
}
250
 
 
251
 
/**
252
 
 * e_folder_get_custom_icon:
253
 
 * @folder: An EFolder
254
 
 *
255
 
 * Get the name of the custom icon for @folder, or NULL if no custom icon is
256
 
 * associated with it.
257
 
 **/
258
 
const gchar *
259
 
e_folder_get_custom_icon_name (EFolder *folder)
260
 
{
261
 
        g_return_val_if_fail (E_IS_FOLDER (folder), NULL);
262
 
 
263
 
        return folder->priv->custom_icon_name;
264
 
}
265
 
 
266
 
/**
267
 
 * e_folder_get_sorting_priority:
268
 
 * @folder: An EFolder
269
 
 *
270
 
 * Get the sorting priority for @folder.
271
 
 *
272
 
 * Return value: Sorting priority value for @folder.
273
 
 **/
274
 
gint
275
 
e_folder_get_sorting_priority (EFolder *folder)
276
 
{
277
 
        g_return_val_if_fail (E_IS_FOLDER (folder), 0);
278
 
 
279
 
        return folder->priv->sorting_priority;
280
 
}
281
 
 
282
 
void
283
 
e_folder_set_name (EFolder *folder,
284
 
                   const gchar *name)
285
 
{
286
 
        g_return_if_fail (E_IS_FOLDER (folder));
287
 
        g_return_if_fail (name != NULL);
288
 
 
289
 
        if (folder->priv->name == name)
290
 
                return;
291
 
 
292
 
        g_free (folder->priv->name);
293
 
        folder->priv->name = g_strdup (name);
294
 
 
295
 
        g_signal_emit (folder, signals[NAME_CHANGED], 0);
296
 
        g_signal_emit (folder, signals[CHANGED], 0);
297
 
}
298
 
 
299
 
void
300
 
e_folder_set_type_string (EFolder *folder,
301
 
                          const gchar *type)
302
 
{
303
 
        g_return_if_fail (E_IS_FOLDER (folder));
304
 
        g_return_if_fail (type != NULL);
305
 
 
306
 
        g_free (folder->priv->type);
307
 
        folder->priv->type = g_strdup (type);
308
 
 
309
 
        g_signal_emit (folder, signals[CHANGED], 0);
310
 
}
311
 
 
312
 
void
313
 
e_folder_set_description (EFolder *folder,
314
 
                          const gchar *description)
315
 
{
316
 
        g_return_if_fail (E_IS_FOLDER (folder));
317
 
        g_return_if_fail (description != NULL);
318
 
 
319
 
        g_free (folder->priv->description);
320
 
        folder->priv->description = g_strdup (description);
321
 
 
322
 
        g_signal_emit (folder, signals[CHANGED], 0);
323
 
}
324
 
 
325
 
void
326
 
e_folder_set_physical_uri (EFolder *folder,
327
 
                           const gchar *physical_uri)
328
 
{
329
 
        g_return_if_fail (E_IS_FOLDER (folder));
330
 
        g_return_if_fail (physical_uri != NULL);
331
 
 
332
 
        if (folder->priv->physical_uri == physical_uri)
333
 
                return;
334
 
 
335
 
        g_free (folder->priv->physical_uri);
336
 
        folder->priv->physical_uri = g_strdup (physical_uri);
337
 
 
338
 
        g_signal_emit (folder, signals[CHANGED], 0);
339
 
}
340
 
 
341
 
void
342
 
e_folder_set_unread_count (EFolder *folder,
343
 
                           gint unread_count)
344
 
{
345
 
        g_return_if_fail (E_IS_FOLDER (folder));
346
 
 
347
 
        folder->priv->unread_count = unread_count;
348
 
 
349
 
        g_signal_emit (folder, signals[CHANGED], 0);
350
 
}
351
 
 
352
 
void
353
 
e_folder_set_child_highlight (EFolder *folder,
354
 
                              gboolean highlighted)
355
 
{
356
 
        g_return_if_fail (E_IS_FOLDER (folder));
357
 
 
358
 
        if (highlighted)
359
 
                folder->priv->child_highlight++;
360
 
        else
361
 
                folder->priv->child_highlight--;
362
 
 
363
 
        g_signal_emit (folder, signals[CHANGED], 0);
364
 
}
365
 
 
366
 
void
367
 
e_folder_set_is_stock (EFolder *folder,
368
 
                       gboolean is_stock)
369
 
{
370
 
        g_return_if_fail (E_IS_FOLDER (folder));
371
 
 
372
 
        folder->priv->is_stock = !! is_stock;
373
 
 
374
 
        g_signal_emit (folder, signals[CHANGED], 0);
375
 
}
376
 
 
377
 
void
378
 
e_folder_set_can_sync_offline (EFolder *folder,
379
 
                               gboolean can_sync_offline)
380
 
{
381
 
        g_return_if_fail (E_IS_FOLDER (folder));
382
 
 
383
 
        folder->priv->can_sync_offline = !! can_sync_offline;
384
 
 
385
 
        g_signal_emit (folder, signals[CHANGED], 0);
386
 
}
387
 
 
388
 
void
389
 
e_folder_set_has_subfolders (EFolder *folder,
390
 
                             gboolean has_subfolders)
391
 
{
392
 
        g_return_if_fail (E_IS_FOLDER (folder));
393
 
 
394
 
        folder->priv->has_subfolders = !! has_subfolders;
395
 
 
396
 
        g_signal_emit (folder, signals[CHANGED], 0);
397
 
}
398
 
 
399
 
/**
400
 
 * e_folder_set_custom_icon_name:
401
 
 * @folder: An EFolder
402
 
 * @icon_name: Name of the icon to be set (to be found in the standard
403
 
 * Evolution icon dir)
404
 
 *
405
 
 * Set a custom icon for @folder (thus overriding the default icon, which is
406
 
 * the one associated to the type of the folder).
407
 
 **/
408
 
void
409
 
e_folder_set_custom_icon (EFolder *folder,
410
 
                          const gchar *icon_name)
411
 
{
412
 
        g_return_if_fail (E_IS_FOLDER (folder));
413
 
 
414
 
        if (icon_name == folder->priv->custom_icon_name)
415
 
                return;
416
 
 
417
 
        if (folder->priv->custom_icon_name == NULL
418
 
            || (icon_name != NULL && strcmp (icon_name, folder->priv->custom_icon_name) != 0)) {
419
 
                g_free (folder->priv->custom_icon_name);
420
 
                folder->priv->custom_icon_name = g_strdup (icon_name);
421
 
 
422
 
                g_signal_emit (folder, signals[CHANGED], 0);
423
 
        }
424
 
}
425
 
 
426
 
/**
427
 
 * e_folder_set_sorting_priority:
428
 
 * @folder: An EFolder
429
 
 * @sorting_priority: A sorting priority number
430
 
 *
431
 
 * Set the sorting priority for @folder.  Folders have a default sorting
432
 
 * priority of zero; when deciding the sort order in the Evolution folder tree,
433
 
 * folders with the same priority value are compared by name, while folders
434
 
 * with a higher priority number always come after the folders with a lower
435
 
 * priority number.
436
 
 **/
437
 
void
438
 
e_folder_set_sorting_priority (EFolder *folder,
439
 
                               gint sorting_priority)
440
 
{
441
 
        g_return_if_fail (E_IS_FOLDER (folder));
442
 
 
443
 
        if (folder->priv->sorting_priority == sorting_priority)
444
 
                return;
445
 
 
446
 
        folder->priv->sorting_priority = sorting_priority;
447
 
 
448
 
        g_signal_emit (folder, signals[CHANGED], 0);
449
 
}
450
 
 
451
 
gboolean
452
 
e_folder_accept_drop (EFolder *folder, GdkDragContext *context,
453
 
                      const gchar *target_type,
454
 
                      GtkSelectionData *selection_data)
455
 
{
456
 
        g_return_val_if_fail (E_IS_FOLDER (folder), FALSE);
457
 
        g_return_val_if_fail (context != NULL, FALSE);
458
 
 
459
 
        return E_FOLDER_GET_CLASS (folder)->accept_drop (folder, context,
460
 
                                                         target_type,
461
 
                                                         selection_data);
462
 
}