Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 93 insertions, 0 deletions

diff --git a/libkdepim/interfaces/MailTransportServiceIface.h b/libkdepim/interfaces/MailTransportServiceIface.h
new file mode 100644
index 00000000..d0ced70a
--- /dev/null
+++ b/libkdepim/interfaces/MailTransportServiceIface.h
@@ -0,0 +1,93 @@
+/*
+    This file is part of libkdepim.
+
+    Copyright (c) 2003 Daniel Molkentin <molkentin@kde.org>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    License as published by the Free Software Foundation; either
+    version 2 of the License, or (at your option) any later version.
+
+    This library 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
+    Library General Public License for more details.
+
+    You should have received a copy of the GNU Library General Public License
+    along with this library; see the file COPYING.LIB.  If not, write to
+    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+    Boston, MA 02110-1301, USA.
+*/
+
+#ifndef MAILTRANSPORTSERVICEIFACE_H
+#define MAILTRANSPORTSERVICEIFACE_H
+
+#include <dcopobject.h>
+#include <dcopref.h>
+#include <kurl.h>
+#include <qstring.h>
+#include <qcstring.h>
+
+#include <kdepimmacros.h>
+
+namespace KPim {
+
+#define MailTransportServiceIface KDE_EXPORT MailTransportServiceIface
+  class MailTransportServiceIface : virtual public DCOPObject
+#undef MailTransportServiceIface
+  {
+    K_DCOP
+      
+    k_dcop:
+      /**
+       * This method will compose a message and send it using the mailers
+       * preferred transport. The mimetype of the attachments passed is
+       * determined using mime magic.
+       *
+       * @return true when the message was send successfully, false on failure.
+       **/
+      virtual bool sendMessage( const QString& from, const QString& to, 
+                                const QString& cc, const QString& bcc,
+                                const QString& subject, const QString& body, 
+                                const KURL::List& attachments ) = 0;
+
+      /**
+       * This method basically behaves like the one above, but takes only one
+       * attachment as QByteArray. This is useful if you want to attach simple
+       * text files (e.g. a vCalendar). The mimetype is determined using
+       * mime magic.
+       *
+       * @return true when the message was send successfully, false on failure.
+       **/
+      virtual bool sendMessage( const QString& from, const QString& to, 
+                                const QString& cc, const QString& bcc,
+                                const QString& subject, const QString& body, 
+                                const QByteArray& attachment ) = 0;
+
+    k_dcop_hidden:
+      /**
+       * This method is deprecated. Use the corresponding method with the
+       * additional parameter from instead.
+       **/
+      // FIXME KDE 4.0: Remove this.
+      virtual bool sendMessage( const QString& to, 
+                                const QString& cc, const QString& bcc,
+                                const QString& subject, const QString& body, 
+                                const KURL::List& attachments ) = 0;
+			       
+      /**
+       * This method is deprecated. Use the corresponding method with the
+       * additional parameter from instead.
+       **/
+      // FIXME KDE 4.0: Remove this.
+      virtual bool sendMessage( const QString& to,
+                                const QString& cc, const QString& bcc,
+                                const QString& subject, const QString& body, 
+                                const QByteArray& attachment ) = 0;
+
+  };
+
+}
+
+#endif // MAILTRANSPORTSERVICEIFACE_H
+