path: root/mail/em-popup.h

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
 *
 *  Authors: Michel Zucchi <notzed@ximian.com>
 *
 *  Copyright 2003 Ximian, Inc. (www.ximian.com)
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  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 General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 */

#ifndef __EM_POPUP_H__
#define __EM_POPUP_H__

#include <glib-object.h>

#include "e-util/e-popup.h"

#ifdef __cplusplus
extern "C" {
#pragma }
#endif /* __cplusplus */

typedef struct _EMPopup EMPopup;
typedef struct _EMPopupClass EMPopupClass;

/**
 * enum _em_popup_target_t - A list of mail popup target types.
 * 
 * @EM_POPUP_TARGET_SELECT: A selection of messages.
 * @EM_POPUP_TARGET_URI: A URI.
 * @EM_POPUP_TARGET_PART: A CamelMimePart message part.
 * @EM_POPUP_TARGET_FOLDER: A folder URI.
 * @EM_POPUP_TARGET_ATTACHMENTS: A list of attachments.
 *
 * Defines the value of the targetid for all EMPopup target types.
 **/
enum _em_popup_target_t {
    EM_POPUP_TARGET_SELECT,
    EM_POPUP_TARGET_URI,
    EM_POPUP_TARGET_PART,
    EM_POPUP_TARGET_FOLDER,
    EM_POPUP_TARGET_ATTACHMENTS,
};

/**
 * enum _em_popup_target_select_t - EMPopupTargetSelect qualifiers.
 * 
 * @EM_POPUP_SELECT_ONE: Only one item is selected.
 * @EM_POPUP_SELECT_MANY: One ore more items are selected.
 * @EM_POPUP_SELECT_MARK_READ: Message(s) are unseen and can be
 * marked seen.
 * @EM_POPUP_SELECT_MARK_UNREAD: Message(s) are seen and can be
 * marked unseen.
 * @EM_POPUP_SELECT_DELETE: Message(s) are undeleted and can
 * be marked deleted.
 * @EM_POPUP_SELECT_UNDELETE: Message(s) are deleted and can be
 * undeleted.
 * @EM_POPUP_SELECT_MAILING_LIST: If one message is selected, and it
 * contains a message list tag.
 * @EM_POPUP_SELECT_EDIT: The message can be opened for editing (the
 * folder is a sent folder).
 * @EM_POPUP_SELECT_MARK_IMPORTANT: Message(s) are not marked
 * important.
 * @EM_POPUP_SELECT_MARK_UNIMPORTANT: Message(s) are marked
 * important.
 * @EM_POPUP_SELECT_FLAG_FOLLOWUP: Message(s) are not flagged for
 * followup.
 * @EM_POPUP_SELECT_FLAG_COMPLETED: Message(s) are not flagged completed.
 * @EM_POPUP_SELECT_FLAG_CLEAR: Message(s) are flagged for followup.
 * @EM_POPUP_SELECT_ADD_SENDER: The message contains sender addresses
 * which might be added to the addressbook. i.e. it isn't a message in
 * the Sent or Drafts folders.
 * @EM_POPUP_SELECT_FOLDER: A folder is set on the selection.
 * @EM_POPUP_SELECT_LAST: The last bit used, can be used to add
 * additional types from derived application code.
 * 
 **/
enum _em_popup_target_select_t {
    EM_POPUP_SELECT_ONE                = 1<<1,
    EM_POPUP_SELECT_MANY               = 1<<2,
    EM_POPUP_SELECT_MARK_READ          = 1<<3,
    EM_POPUP_SELECT_MARK_UNREAD        = 1<<4,
    EM_POPUP_SELECT_DELETE             = 1<<5,
    EM_POPUP_SELECT_UNDELETE           = 1<<6,
    EM_POPUP_SELECT_MAILING_LIST       = 1<<7,
    EM_POPUP_SELECT_EDIT               = 1<<8,
    EM_POPUP_SELECT_MARK_IMPORTANT     = 1<<9,
    EM_POPUP_SELECT_MARK_UNIMPORTANT   = 1<<10,
    EM_POPUP_SELECT_FLAG_FOLLOWUP      = 1<<11,
    EM_POPUP_SELECT_FLAG_COMPLETED     = 1<<12,
    EM_POPUP_SELECT_FLAG_CLEAR         = 1<<13,
    EM_POPUP_SELECT_ADD_SENDER         = 1<<14,
    EM_POPUP_SELECT_FOLDER             = 1<<15,     /* do we have any folder at all? */
    EM_POPUP_SELECT_JUNK               = 1<<16,
    EM_POPUP_SELECT_NOT_JUNK           = 1<<17,
    EM_POPUP_SELECT_LAST               = 1<<18, 
};

/**
 * enum _em_popup_target_uri_t - EMPopupTargetURI qualifiers.
 * 
 * @EM_POPUP_URI_HTTP: This is a HTTP or HTTPS url.
 * @EM_POPUP_URI_MAILTO: This is a MAILTO url.
 * @EM_POPUP_URI_NOT_MAILTO: This is not a MAILTO url.
 * @EM_POPUP_URI_CALLTO: This is a CALLTO url.
 * 
 **/
enum _em_popup_target_uri_t {
    EM_POPUP_URI_HTTP = 1<<0,
    EM_POPUP_URI_MAILTO = 1<<1,
    EM_POPUP_URI_NOT_MAILTO = 1<<2,
    EM_POPUP_URI_CALLTO = 1<<3,
};

/**
 * enum _em_popup_target_part_t - EMPopupTargetPart qualifiers.
 * 
 * @EM_POPUP_PART_MESSAGE: This is a message type.
 * @EM_POPUP_PART_IMAGE: This is an image type.
 * 
 **/
enum _em_popup_target_part_t {
    EM_POPUP_PART_MESSAGE = 1<<0,
    EM_POPUP_PART_IMAGE = 1<<1,
};

/**
 * enum _em_popup_target_folder_t - EMPopupTargetFolder qualifiers.
 * 
 * @EM_POPUP_FOLDER_FOLDER: This is a normal folder.
 * @EM_POPUP_FOLDER_STORE: This is a store.
 * @EM_POPUP_FOLDER_INFERIORS: This folder may have child folders.
 * @EM_POPUP_FOLDER_DELETE: This folder can be deleted or renamed.
 * @EM_POPUP_FOLDER_SELECT: This folder exists and can be selected or
 * opened.
 * 
 **/
enum _em_popup_target_folder_t {
    EM_POPUP_FOLDER_FOLDER = 1<<0, /* normal folder */
    EM_POPUP_FOLDER_STORE = 1<<1, /* root/nonselectable folder, i.e. store */
    EM_POPUP_FOLDER_INFERIORS = 1<<2, /* folder can have children */
    EM_POPUP_FOLDER_DELETE = 1<<3, /* folder can be deleted/renamed */
    EM_POPUP_FOLDER_SELECT = 1<<4, /* folder can be selected/opened */
    EM_POPUP_FOLDER_OUTBOX = 1<<5, /* Outbox folder */
    EM_POPUP_FOLDER_NONSTATIC = 1<<6, /* Except static folders like Outbox.*/
};

/**
 * enum _em_popup_target_attachments_t - EMPopupTargetAttachments qualifiers.
 * 
 * @EM_POPUP_ATTACHMENTS_ONE: There is one and only one attachment selected.
 * @EM_POPUP_ATTACHMENTS_MANY: There is one or more attachments selected.
 * 
 **/
enum _em_popup_target_attachments_t {
    EM_POPUP_ATTACHMENTS_ONE = 1<<0, /* only 1 selected */
    EM_POPUP_ATTACHMENTS_MANY = 1<<1, /* one or more selected */
    EM_POPUP_ATTACHMENTS_MULTIPLE = 1<<2, /* More than 1 selected */
    EM_POPUP_ATTACHMENTS_IMAGE = 1<<3, /* Image selected */
    EM_POPUP_ATTACHMENTS_MESSAGE = 1<<4 /* Message selected */
};

typedef struct _EMPopupTargetSelect EMPopupTargetSelect;
typedef struct _EMPopupTargetURI EMPopupTargetURI;
typedef struct _EMPopupTargetPart EMPopupTargetPart;
typedef struct _EMPopupTargetFolder EMPopupTargetFolder;
typedef struct _EMPopupTargetAttachments EMPopupTargetAttachments;

/**
 * struct _EMPopupTargetURI - An inline URI.
 * 
 * @target: Superclass.
 * @uri: The encoded URI to which this target applies.
 * 
 * Used to represent popup-menu context on any URI object.
 **/
struct _EMPopupTargetURI {
    EPopupTarget target;
    char *uri;
};

/**
 * struct _EMPopupTargetSelect - A list of messages.
 * 
 * @target: Superclass.
 * @folder: The CamelFolder of the selected messages.
 * @uri: The encoded URI represending this folder.
 * @uids: An array of UID strings of messages within @folder.
 *
 * Used to represent a selection of messages as context for a popup
 * menu.  All items may be NULL if the current view has no active
 * folder selected.
 **/
struct _EMPopupTargetSelect {
    EPopupTarget target;
    struct _CamelFolder *folder;
    char *uri;
    GPtrArray *uids;
};

/**
 * struct _EMPopupTargetPart - A Camel object.
 * 
 * @target: Superclass.
 * @mime_type: MIME type of the part.  This may be a calculated type
 * not matching the @part's MIME type.
 * @part: A CamelMimePart representing a message or attachment.
 * 
 * Used to represent a message part as context for a popup menu.  This
 * is used for both attachments and inline-images.
 **/
struct _EMPopupTargetPart {
    EPopupTarget target;
    char *mime_type;
    struct _CamelMimePart *part;
};

/**
 * struct _EMPopupTargetFolder - A folder uri.
 * 
 * @target: Superclass.
 * @uri: A folder URI.
 *
 * This target is used to represent folder context.
 **/
struct _EMPopupTargetFolder {
    EPopupTarget target;
    char *uri;
};

/**
 * struct _EMPopupTargetAttachments - A list of composer attachments.
 * 
 * @target: Superclass.
 * @attachments: A GSList list of EMsgComposer attachments.
 *
 * This target is used to represent a selected list of attachments in
 * the message composer attachment area.
 **/
struct _EMPopupTargetAttachments {
    EPopupTarget target;
    GSList *attachments;
};

typedef struct _EPopupItem EMPopupItem;

/* The object */
struct _EMPopup {
    EPopup popup;

    struct _EMPopupPrivate *priv;
};

struct _EMPopupClass {
    EPopupClass popup_class;
};

GType em_popup_get_type(void);

EMPopup *em_popup_new(const char *menuid);

EMPopupTargetURI *em_popup_target_new_uri(EMPopup *emp, const char *uri);
EMPopupTargetSelect *em_popup_target_new_select(EMPopup *emp, struct _CamelFolder *folder, const char *folder_uri, GPtrArray *uids);
EMPopupTargetPart *em_popup_target_new_part(EMPopup *emp, struct _CamelMimePart *part, const char *mime_type);
EMPopupTargetFolder *em_popup_target_new_folder(EMPopup *emp, const char *uri, guint32 info_flags, guint32 popup_flags);
EMPopupTargetAttachments *em_popup_target_new_attachments(EMPopup *emp, GSList *attachments);

/* ********************************************************************** */

typedef struct _EMPopupHook EMPopupHook;
typedef struct _EMPopupHookClass EMPopupHookClass;

struct _EMPopupHook {
    EPopupHook hook;
};

struct _EMPopupHookClass {
    EPopupHookClass hook_class;
};

GType em_popup_hook_get_type(void);

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* __EM_POPUP_H__ */