kmail

urlhandler.h

00001 /*  -*- c++ -*-
00002     interfaces/urlhandler.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 TQt library by Trolltech AS, Norway (or with modified versions
00023     of TQt that use the same license as TQt), 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     TQt.  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_INTERFACES_URLHANDLER_H__
00033 #define __KMAIL_INTERFACES_URLHANDLER_H__
00034 
00035 class KURL;
00036 
00037 class TQString;
00038 class TQPoint;
00039 class KMReaderWin;
00040 
00041 namespace KMail {
00049   class URLHandler {
00050   public:
00051     virtual ~URLHandler() {}
00052 
00059     virtual bool handleClick( const KURL & url, KMReaderWin * w ) const = 0;
00060 
00065     virtual bool handleShiftClick( const KURL &url, KMReaderWin *window ) const {
00066       Q_UNUSED( url );
00067       Q_UNUSED( window );
00068       return false;
00069     }
00070 
00074     virtual bool willHandleDrag( const KURL &url, const TQString &imagePath,
00075                                  KMReaderWin *window ) const {
00076       Q_UNUSED( url );
00077       Q_UNUSED( window );
00078       Q_UNUSED( imagePath );
00079       return false;
00080     }
00081 
00087     virtual bool handleDrag( const KURL &url, const TQString &imagePath,
00088                              KMReaderWin *window ) const {
00089       Q_UNUSED( url );
00090       Q_UNUSED( window );
00091       Q_UNUSED( imagePath );
00092       return false;
00093     }
00094 
00102     virtual bool handleContextMenuRequest( const KURL & url, const TQPoint & p, KMReaderWin * w ) const = 0;
00108     virtual TQString statusBarMessage( const KURL & url, KMReaderWin * w ) const = 0;
00109   };
00110 
00111 } // namespace KMail
00112 
00113 #endif // __KMAIL_INTERFACES_URLHANDLER_H__
00114