path: root/libemail-engine/mail-folder-cache.h

/*
 * 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.
 *
 * 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 General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, see <http://www.gnu.org/licenses/>.
 *
 *
 * Authors:
 *   Peter Williams <peterw@ximian.com>
 *   Michael Zucchi <notzed@ximian.com>
 *   Jonathon Jongsma <jonathon.jongsma@collabora.co.uk>
 *
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
 * Copyright (C) 2009 Intel Corporation
 *
 */

#if !defined (__LIBEMAIL_ENGINE_H_INSIDE__) && !defined (LIBEMAIL_ENGINE_COMPILATION)
#error "Only <libemail-engine/libemail-engine.h> should be included directly."
#endif

#ifndef MAIL_FOLDER_CACHE_H
#define MAIL_FOLDER_CACHE_H

#include <camel/camel.h>

/* Standard GObject macros */
#define MAIL_TYPE_FOLDER_CACHE \
    (mail_folder_cache_get_type ())
#define MAIL_FOLDER_CACHE(obj) \
    (G_TYPE_CHECK_INSTANCE_CAST \
    ((obj), MAIL_TYPE_FOLDER_CACHE, MailFolderCache))
#define MAIL_FOLDER_CACHE_CLASS(cls) \
    (G_TYPE_CHECK_CLASS_CAST \
    ((cls), MAIL_TYPE_FOLDER_CACHE, MailFolderCacheClass))
#define MAIL_IS_FOLDER_CACHE(obj) \
    (G_TYPE_CHECK_INSTANCE_TYPE \
    ((obj), MAIL_TYPE_FOLDER_CACHE))
#define MAIL_IS_FOLDER_CACHE_CLASS(cls) \
    (G_TYPE_CHECK_CLASS_TYPE \
    ((cls), MAIL_TYPE_FOLDER_CACHE))
#define MAIL_FOLDER_CACHE_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS \
    ((obj), MAIL_TYPE_FOLDER_CACHE, MailFolderCacheClass))

G_BEGIN_DECLS

typedef struct _MailFolderCache MailFolderCache;
typedef struct _MailFolderCacheClass MailFolderCacheClass;
typedef struct _MailFolderCachePrivate MailFolderCachePrivate;

/**
 * MailFolderCache:
 *
 * Contains only private data that should be read and manipulated using the
 * functions below.
 */
struct _MailFolderCache {
    GObject parent;
    MailFolderCachePrivate *priv;
};

struct _MailFolderCacheClass {
    GObjectClass parent_class;

    /* Signals */
    void        (*folder_available) (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name);
    void        (*folder_unavailable)   (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name);
    void        (*folder_deleted)   (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name);
    void        (*folder_renamed)   (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *old_folder_name,
                         const gchar *new_folder_name);
    void        (*folder_unread_updated)
                        (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name,
                         gint unread);
    void        (*folder_changed)   (MailFolderCache *cache,
                         CamelStore *store,
                         gint new_messages,
                         const gchar *msg_uid,
                         const gchar *msg_sender,
                         const gchar *msg_subject);
};

GType       mail_folder_cache_get_type  (void) G_GNUC_CONST;
MailFolderCache *
        mail_folder_cache_new       (void);
GMainContext *  mail_folder_cache_ref_main_context
                        (MailFolderCache *cache);
void        mail_folder_cache_note_store    (MailFolderCache *cache,
                         CamelStore *store,
                         GCancellable *cancellable,
                         GAsyncReadyCallback callback,
                         gpointer user_data);
gboolean    mail_folder_cache_note_store_finish
                        (MailFolderCache *cache,
                         GAsyncResult *result,
                         CamelFolderInfo **out_info,
                         GError **error);
void        mail_folder_cache_note_folder   (MailFolderCache *cache,
                         CamelFolder *folder);
gboolean    mail_folder_cache_has_folder_info
                        (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name);
CamelFolder *   mail_folder_cache_ref_folder    (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name);
gboolean    mail_folder_cache_get_folder_info_flags
                        (MailFolderCache *cache,
                         CamelStore *store,
                         const gchar *folder_name,
                         CamelFolderInfoFlags *flags);
void        mail_folder_cache_get_local_folder_uris
                        (MailFolderCache *cache,
                         GQueue *out_queue);
void        mail_folder_cache_get_remote_folder_uris
                        (MailFolderCache *cache,
                         GQueue *out_queue);
void        mail_folder_cache_service_removed
                        (MailFolderCache *cache,
                         CamelService *service);
void        mail_folder_cache_service_enabled
                        (MailFolderCache *cache,
                         CamelService *service);
void        mail_folder_cache_service_disabled
                        (MailFolderCache *cache,
                         CamelService *service);

G_END_DECLS

#endif /* MAIL_FOLDER_CACHE_H */