kmail Library API Documentation

subscriptiondialog.h

00001 /*  -*- c++ -*-
00002     subscriptiondialog.h
00003 
00004     This file is part of KMail, the KDE mail client.
00005     Copyright (C) 2002 Carsten Burghardt <burghardt@kde.org>
00006 
00007     KMail is free software; you can redistribute it and/or modify it
00008     under the terms of the GNU General Public License, version 2, as
00009     published by the Free Software Foundation.
00010 
00011     KMail is distributed in the hope that it will be useful, but
00012     WITHOUT ANY WARRANTY; without even the implied warranty of
00013     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014     General Public License for more details.
00015 
00016     You should have received a copy of the GNU General Public License
00017     along with this program; if not, write to the Free Software
00018     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
00019 
00020     In addition, as a special exception, the copyright holders give
00021     permission to link the code of this program with any edition of
00022     the Qt library by Trolltech AS, Norway (or with modified versions
00023     of Qt that use the same license as Qt), and distribute linked
00024     combinations including the two.  You must obey the GNU General
00025     Public License in all respects for all of the code used other than
00026     Qt.  If you modify this file, you may extend this exception to
00027     your version of the file, but you are not obligated to do so.  If
00028     you do not wish to do so, delete this exception statement from
00029     your version.
00030 */
00031 
00032 #ifndef __SUBSCRIPTIONDIALOG
00033 #define __SUBSCRIPTIONDIALOG
00034 
00035 #include <qdict.h>
00036 #include <ksubscription.h>
00037 #include "imapaccountbase.h"
00038 
00039 class KMMessage;
00040 class FolderStorage;
00041 
00042 namespace KMail {
00043 
00044   // Abstract base class for the server side and client side subscription dialogs.
00045   // Scott Meyers says: "Make non-leaf classes abstract" and he is right, I think.
00046   // (More Effective C++, Item 33)
00047   class SubscriptionDialogBase : public KSubscription
00048   {
00049     Q_OBJECT
00050 
00051     public:
00052       SubscriptionDialogBase( QWidget *parent,
00053                               const QString &caption,
00054                               KAccount* acct,
00055                               QString startPath = QString::null );
00056       virtual ~SubscriptionDialogBase() {}
00057 
00058     protected:
00059       void findParentItem ( QString &name, QString &path, QString &compare,
00060                        GroupItem **parent, GroupItem **oldItem );
00061 
00062     public slots:
00066       void slotListDirectory(const QStringList&, const QStringList&,
00067           const QStringList&, const QStringList&, const ImapAccountBase::jobData &);
00068 
00072       void slotSave();
00073 
00074     protected slots:
00078       void slotLoadFolders();
00079 
00080 
00081     protected:
00082       virtual void listAllAvailableAndCreateItems() = 0;
00083       virtual void processFolderListing() = 0;
00084       virtual void doSave() = 0;
00085 
00086       // helpers
00088       void moveChildrenToNewParent( GroupItem *oldItem, GroupItem *item  );
00089 
00092       void createListViewItem( int i );
00093 
00094       QString mDelimiter;
00095       QStringList mFolderNames, mFolderPaths,
00096                   mFolderMimeTypes, mFolderAttributes;
00097       ImapAccountBase::jobData mJobData;
00098       uint mCount;
00099       bool mCheckForExisting;
00100       QDict<GroupItem> mItemDict;
00101       QString mStartPath;
00102   };
00103 
00104   class SubscriptionDialog : public SubscriptionDialogBase
00105   {
00106     Q_OBJECT
00107     public:
00108 
00109       SubscriptionDialog( QWidget *parent,
00110                           const QString &caption,
00111                           KAccount* acct,
00112                           QString startPath = QString::null );
00113       virtual ~SubscriptionDialog();
00114      protected:
00116       virtual void listAllAvailableAndCreateItems();
00118       virtual void processFolderListing();
00120       virtual void doSave();
00121     private:
00126       void processItems();
00127 
00128   };
00129 
00130 } // namespace KMail
00131 
00132 #endif
KDE Logo
This file is part of the documentation for kmail Library Version 3.3.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Jan 31 15:55:09 2007 by doxygen 1.4.2 written by Dimitri van Heesch, © 1997-2003