composer.h

Go to the documentation of this file.

/* -*- mode: C++; c-file-style: "gnu" -*-
  This file is part of KMail, the KDE mail client.
  Copyright (c) 1997 Markus Wuebben <markus.wuebben@kde.org>

  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 __KMAIL_COMPOSER_H__
#define __KMAIL_COMPOSER_H__

#include "secondarywindow.h"

#include <kurl.h>
#include <kmime/kmime_message.h>
#include <akonadi/collection.h>

#include <boost/shared_ptr.hpp>

namespace KMime {
class Content;
}

namespace KMail {

class Composer : public KMail::SecondaryWindow
{
    Q_OBJECT
protected:
    Composer( const char *name=0 ) : KMail::SecondaryWindow( name ) {}

public:
    enum TemplateContext { New, Reply, ReplyToAll, Forward, NoTemplate };
    enum VisibleHeaderFlag {
        HDR_FROM        = 0x01,
        HDR_REPLY_TO    = 0x02,
        HDR_SUBJECT     = 0x20,
        HDR_NEWSGROUPS  = 0x40,
        HDR_FOLLOWUP_TO = 0x80,
        HDR_IDENTITY    = 0x100,
        HDR_TRANSPORT   = 0x200,
        HDR_FCC         = 0x400,
        HDR_DICTIONARY  = 0x800,
        HDR_ALL         = 0xfff
    };
    typedef QFlags<VisibleHeaderFlag> VisibleHeaderFlags;

public: // mailserviceimpl
    virtual void send( int how ) = 0;
    virtual void addAttachmentsAndSend( const KUrl::List &urls,
                                        const QString &comment, int how) = 0;
    virtual void addAttachment( const KUrl &url, const QString &comment ) = 0;
    virtual void addAttachment( const QString & name,
                                KMime::Headers::contentEncoding cte,
                                const QString& charset,
                                const QByteArray & data,
                                const QByteArray & mimeType ) = 0;
public: // kmcommand
    virtual QString dbusObjectPath() const = 0;
public: // kmkernel, kmcommands, callback
    virtual void setMessage( const KMime::Message::Ptr &newMsg,  bool lastSignState = false, bool lastEncryptState = false, bool mayAutoSign=true,
                             bool allowDecryption=false, bool isModified=false ) = 0;
    virtual void setCurrentTransport( int transportId ) = 0;

    virtual void setCurrentReplyTo(const QString& replyTo) = 0;

    virtual void setFcc( const QString &idString ) = 0;
    virtual bool isComposing() const = 0;

    virtual void setTextSelection( const QString& selection ) = 0;

    virtual void setCustomTemplate( const QString& customTemplate ) = 0;

    virtual void setAutoSaveFileName( const QString &fileName ) = 0;
    virtual void setCollectionForNewMessage( const Akonadi::Collection& folder ) = 0;

    virtual void addExtraCustomHeaders( const QMap<QByteArray, QString> &header) = 0;

public: // kmcommand
    virtual void setFolder( const Akonadi::Collection& ) = 0;

    virtual void setFocusToEditor() = 0;

    virtual void setFocusToSubject() = 0;

public: // callback
    virtual void setSigningAndEncryptionDisabled( bool v ) = 0;

public slots: // kmkernel, callback
    virtual void slotSendNow() = 0;
    virtual void slotWordWrapToggled( bool ) = 0;
    virtual void setModified( bool modified ) = 0;
public slots: // kmkernel
    virtual void autoSaveMessage(bool force = false ) = 0;

public: // kmkernel, attachmentlistview
    virtual void disableWordWrap() = 0;

    virtual void forceDisableHtml() = 0;

    virtual void disableForgottenAttachmentsCheck() = 0;

    virtual void ignoreStickyFields() = 0;

public: // kmcommand
    virtual void addAttach( KMime::Content *msgPart ) = 0;
};

Composer *makeComposer( const KMime::Message::Ptr &msg = KMime::Message::Ptr(), bool lastSignState = false, bool lastEncryptState = false,
                        Composer::TemplateContext context = Composer::NoTemplate,
                        uint identity = 0, const QString & textSelection = QString(),
                        const QString & customTemplate = QString() );

}

#endif // __KMAIL_COMPOSER_H__