calendarsupport/mailclient.h

   1 /*
   2   Copyright (c) 1998 Barry D Benowitz <b.benowitz@telesciences.com>
   3   Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
   4   Copyright (c) 2009 Allen Winter <winter@kde.org>
   5
   6   This program is free software; you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation; either version 2 of the License, or
   9   (at your option) any later version.
  10
  11   This program is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License along
  17   with this program; if not, write to the Free Software Foundation, Inc.,
  18   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  19
  20   As a special exception, permission is given to link this program
  21   with any edition of Qt, and distribute the resulting executable,
  22   without including the source code for Qt in the source distribution.
  23 */
  24 #ifndef CALENDARSUPPORT_MAILCLIENT_H
  25 #define CALENDARSUPPORT_MAILCLIENT_H
  26
  27 #include "calendarsupport_export.h"
  28
  29 #include <KCalCore/IncidenceBase>
  30
  31 #include <QObject>
  32
  33 namespace KPIMIdentities {
  34   class Identity;
  35 }
  36
  37 namespace CalendarSupport {
  38
  39 class CALENDARSUPPORT_EXPORT MailClient : public QObject
  40 {
  41   public:
  42     MailClient();
  43     virtual ~MailClient();
  44
  45     bool mailAttendees( const KCalCore::IncidenceBase::Ptr &,
  46                         const KPIMIdentities::Identity &identity,
  47                         bool bccMe, const QString &attachment=QString(),
  48                         const QString &mailTransport = QString() );
  49
  50     bool mailOrganizer( const KCalCore::IncidenceBase::Ptr &,
  51                         const KPIMIdentities::Identity &identity,
  52                         const QString &from, bool bccMe,
  53                         const QString &attachment=QString(),
  54                         const QString &sub=QString(),
  55                         const QString &mailTransport = QString() );
  56
  57     bool mailTo( const KCalCore::IncidenceBase::Ptr &, const KPIMIdentities::Identity &identity,
  58                  const QString &from, bool bccMe, const QString &recipients,
  59                  const QString &attachment=QString(), const QString &mailTransport = QString() );
  60
  61     /**
  62       Sends mail with specified from, to and subject field and body as text.
  63       If bcc is set, send a blind carbon copy to the sender
  64
  65       @param identity is the Identity of the sender
  66       @param from is the address of the sender of the message
  67       @param to a list of addresses to receive the message
  68       @param cc a list of addresses to receive message carbon copies
  69       @param subject is the subject of the message
  70       @param body is the boody of the message
  71       @param hidden if true and using KMail as the mailer, send the message
  72       without opening a composer window.
  73       @param bcc if true, send a blind carbon copy to the message sender
  74       @param attachment optional attachment (raw data)
  75       @param mailTransport defines the mail transport method. See here the
  76       kdepimlibs/mailtransport library.
  77     */
  78     bool send( const KPIMIdentities::Identity &identity, const QString &from, const QString &to,
  79                const QString &cc, const QString &subject, const QString &body,
  80                bool hidden=false, bool bccMe=false, const QString &attachment=QString(),
  81                const QString &mailTransport = QString() );
  82 };
  83
  84 }
  85
  86 #endif