summaryrefslogtreecommitdiffstats
path: root/korn/kmail_proto.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 (patch)
tree67208f7c145782a7e90b123b982ca78d88cc2c87 /korn/kmail_proto.h
downloadtdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.tar.gz
tdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.zip
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
Diffstat (limited to 'korn/kmail_proto.h')
-rw-r--r--korn/kmail_proto.h122
1 files changed, 122 insertions, 0 deletions
diff --git a/korn/kmail_proto.h b/korn/kmail_proto.h
new file mode 100644
index 000000000..6e055b406
--- /dev/null
+++ b/korn/kmail_proto.h
@@ -0,0 +1,122 @@
+/*
+ * Copyright (C) 2005, Mart Kelder (mart.kde@hccnet.nl)
+ *
+ * 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 MK_KMAILPROTOCOL
+#define MK_KMAILPROTOCOL
+
+#include "protocol.h"
+
+class KConfig;
+class KConfigBase;
+
+/**
+ * This class is the comminucation between KOrn and KMail.
+ * If provides an configuration option to fill in the KMail account name,
+ * and it provides a conversion from the KMail config to a configuration KOrn can read.
+ * That conversion is done every time, so that changing the settings in KMail also affects
+ * the settings in KOrn.
+ */
+class KMail_Protocol : public Protocol
+{
+public:
+ /**
+ * Constructor
+ */
+ KMail_Protocol();
+ /**
+ * Destructor
+ */
+ ~KMail_Protocol();
+
+ /**
+ * This function returns the protocol of the resulting configuration.
+ * This is not itself, because an real Protocol of type KMail doesn't exist.
+ *
+ * @param config The configuration group to read the kmailname from.
+ * @return A pointer to a Protocol (not newly created) or 0 if an error orrured.
+ */
+ virtual const Protocol* getProtocol( KConfigGroup* config ) const;
+ /**
+ * This gives a new Maildrop back. The maildrop is responsible to execute the configuration.
+ * In most cases, it will return a new instance of the KKioDrop Maildrop.
+ * @param config The configuration group to read the kmailname from.
+ * @return A new KMailDrop, or a 0 pointer if an error occured.
+ */
+ virtual KMailDrop* createMaildrop( KConfigGroup* config ) const;
+ /**
+ * This does the real convertion: given a namen of a KMail account (hidden in config),
+ * it calculates how the configuration whould have looked in KOrn.
+ *
+ * @param config The configuration group to read the kmailname from.
+ * @param password The password fetched out of the configuration or KWallet.
+ * @return A mapping containing the configuration if success, and empty mapping otherwise.
+ */
+ virtual QMap< QString, QString > * createConfig( KConfigGroup* config, const QString& password ) const;
+ /**
+ * The name of thes protocol
+ *
+ * @return "kmail"
+ */
+ virtual QString configName() const { return "kmail"; }
+
+ /**
+ * This adds the names of the groupboxes neccesairy for configuration to list.
+ *
+ * @param list A empty list at calling; after this function, "KMail" is added, because KMail is the only group here.
+ */
+ virtual void configFillGroupBoxes( QStringList* list ) const;
+ /**
+ * This filles the config fields of the configuration.
+ * There is only one config field, containing the accounts of KMail.
+ *
+ * @param vector A vector containing the groupboxes.
+ * @param object An object to connect slots to.
+ * @param result The resulting object.
+ */
+ virtual void configFields( QPtrVector< QWidget >* vector, const QObject* object, QPtrList< AccountInput >* result ) const;
+ /**
+ * This can manipulate entries that are readed from the configuartion.
+ * This function does nothing here.
+ *
+ * @param config The configuration mapping as read from the configuration file
+ */
+ virtual void readEntries( QMap< QString, QString >* config ) const;
+
+ /**
+ * This can manipulate entries that are writed to the configuartion file.
+ * This function does nothing here.
+ *
+ * @param config The configuration mapping as to be written to the configuration file (can be modified)
+ */
+ virtual void writeEntries( QMap< QString, QString >* config ) const;
+
+private:
+ QString readPassword( bool store, const KConfigBase &config, int id ) const;
+ QString getTypeAndConfig( const QString& kmailname, KConfig &config, int &nummer ) const;
+
+ static const char* kmailGroupName;
+ static const char* kmailKeyName;
+ static const char* kmailKeyType;
+ static const char* kmailKeyId;
+ static const char* kmailKeyMBox;
+ static const char* kmailKeyQMail;
+ static const int kmailFirstGroup;
+};
+
+#endif //MK_KMAILPROTOCOL