summaryrefslogtreecommitdiffstats
path: root/korn/dcopdrop.h
diff options
context:
space:
mode:
Diffstat (limited to 'korn/dcopdrop.h')
-rw-r--r--korn/dcopdrop.h190
1 files changed, 190 insertions, 0 deletions
diff --git a/korn/dcopdrop.h b/korn/dcopdrop.h
new file mode 100644
index 000000000..91bc8f98d
--- /dev/null
+++ b/korn/dcopdrop.h
@@ -0,0 +1,190 @@
+/*
+ * Copyright (C) 2004, Mart Kelder ([email protected])
+ *
+ * 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 DCOPDROP_H
+#define DCOPDROP_H
+
+#include "maildrop.h"
+
+#include <dcopobject.h>
+
+class DCOPDropInterface;
+//class KDropCfgDialog;
+class KornMailId;
+class KornMailSubject;
+
+class KConfigBase;
+
+template<class A, class B> class QMap;
+class QString;
+
+/**
+ * This class implements a KMailDrop for DCOP-objects.
+ * This class handles all new messages which are comming in through DCOP.
+ */
+class DCOPDrop : public KMailDrop
+{ Q_OBJECT
+public:
+ /**
+ * Constructor: no parameters
+ */
+ DCOPDrop();
+ /**
+ * Destructor
+ */
+ virtual ~DCOPDrop();
+
+ /**
+ * A DCOPDrop cannot produce error messages, so it always returns true.
+ *
+ * @return true is the box is valid
+ */
+ virtual bool valid() { return true; }
+ /**
+ * This forces the drop to recheck. It is inpossible to recheck dcop,
+ * so this function does nothing.
+ */
+ virtual void recheck();
+ /**
+ * This function starts the monitor, however, this drop is always running,
+ * and doesn't need to be started.
+ * The return value is always true.
+ *
+ * @return true
+ */
+ virtual bool startMonitor();
+ /**
+ * This function starts the monitor, however, this drop is always running,
+ * and doesn't need to be started.
+ * The return value is always true.
+ *
+ * @return true
+ */
+ virtual bool stopMonitor();
+ /**
+ * Return true is the monitor has been started before.
+ * @return true is it is 'running'.
+ */
+ virtual bool running() { return _isRunning; }
+
+ //virtual void addConfigPage( KDropCfgDialog* ) ;
+ /**
+ * This function gives a new instance of a DCOPDrop.
+ *
+ * @return A new instance of a DCOPDrop.
+ */
+ virtual KMailDrop* clone() const { return new DCOPDrop; }
+
+ /**
+ * This function reeds the config which are shipped which the group.
+ *
+ * @param config The configuration group which contains the info for this account.
+ * @return The same value as KMailDrop::readConfigGroup( config ) returns.
+ */
+ virtual bool readConfigGroup( const KConfigGroup& config );
+ /**
+ * This function also reeds the configurion, but from a mapping.
+ *
+ * @param map The mapping containing the configuration.
+ * @param protocol The protocol which comes with the mapping.
+ *
+ * @return true is all information is retrieved succesfully.
+ */
+ virtual bool readConfigGroup( const QMap< QString, QString > & map, const Protocol * protocol );
+ /**
+ * This function writes the information to a config group.
+ *
+ * @param config The configuration to write true
+ * @return true if no error occured.
+ */
+ virtual bool writeConfigGroup( KConfigBase& config ) const;
+ /**
+ * This returns the type of the box, in this case allways "dcop".
+ *
+ * @return "dcop"
+ */
+ virtual QString type() const;
+
+ /**
+ * This function should return true if it uses a synchrone comminucation.
+ * It doens't, so it returns false.
+ *
+ * @return false
+ */
+ virtual bool synchrone() const { return false; }
+
+ /**
+ * Return true if it is possible to read the subjects of new email.
+ *
+ * @return true
+ */
+ virtual bool canReadSubjects() { return true; }
+ /**
+ * This function does reads the subjects.
+ * @param stop A variable which isn't used: only used for synchrone actions
+ * @return A QValueVector which KornMailSubject* instance for every new mail.
+ */
+ virtual QValueVector< KornMailSubject >* doReadSubjects( bool *stop );
+
+ /**
+ * This function should return true if it is possible to delete emails.
+ * This is possible, so it always return true.
+ *
+ * @return true
+ */
+ virtual bool canDeleteMails() { return true; }
+ /**
+ * This function deletes the email.
+ *
+ * @param ids The id's of the email which must be deleted.
+ * @param stop Not used: only for synchrone opererations.
+ * @return true if deleting was succesfull
+ */
+ virtual bool deleteMails( QPtrList<const KornMailId> * ids, bool * stop );
+
+ /**
+ * This function returns true if it is possible to read emails.
+ * The emails are only given at once as a whole, so reading is impossible.
+ *
+ * @return false
+ */
+ virtual bool canReadMail() { return false; }
+
+
+private:
+ bool _isRunning;
+ QMap< int, KornMailSubject* > *_msgList;
+ QString *_name;
+ int _counter;
+ DCOPDropInterface *_interface;
+
+ void eraseList( void );
+
+private slots:
+ void doReadSubjectsASync( void );
+
+public: //accessed by DCOPDropInterface
+ int addMessage( const QString& subject, const QString& message );
+ bool removeMessage( int id );
+
+ //accessed by DCOPDropCfg
+ QString DCOPName() const;
+ void setDCOPName( const QString& );
+};
+
+#endif