kmail

headerstrategy.h

Go to the documentation of this file.
00001 /*  -*- c++ -*-
00002     headerstrategy.h
00003 
00004     This file is part of KMail, the KDE mail client.
00005     Copyright (c) 2003 Marc Mutz <mutz@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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  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 __KMAIL_HEADERSTRATEGY_H__
00033 #define __KMAIL_HEADERSTRATEGY_H__
00034 
00035 class QString;
00036 class QStringList;
00037 
00038 namespace KMail {
00039 
00040   class HeaderStrategy {
00041   protected:
00042     HeaderStrategy();
00043     virtual ~HeaderStrategy();
00044 
00045   public:
00046     //
00047     // Factory methods:
00048     //
00049     enum Type { All, Rich, Standard, Brief, Custom };
00050 
00051     static const HeaderStrategy * create( Type type );
00052     static const HeaderStrategy * create( const QString & type );
00053 
00054     static const HeaderStrategy * all();
00055     static const HeaderStrategy * rich();
00056     static const HeaderStrategy * standard();
00057     static const HeaderStrategy * brief();
00058     static const HeaderStrategy * custom();
00059 
00060     //
00061     // Methods for handling the strategies:
00062     //
00063     virtual const char * name() const = 0;
00064     virtual const HeaderStrategy * next() const = 0;
00065     virtual const HeaderStrategy * prev() const = 0;
00066 
00067     //
00068     // HeaderStrategy interface:
00069     //
00070     enum DefaultPolicy { Display, Hide };
00071 
00072     virtual QStringList headersToDisplay() const;
00073     virtual QStringList headersToHide() const;
00074     virtual DefaultPolicy defaultPolicy() const = 0;
00075     virtual bool showHeader( const QString & header ) const;
00076   };
00077 
00078 } // namespace KMail
00079 
00080 #endif // __KMAIL_HEADERSTRATEGY_H__