kaddressbook Library API Documentation

extensionwidget.h

00001 /*                                                                      
00002     This file is part of KAddressBook.                                  
00003     Copyright (c) 2002 Tobias Koenig <tokoe@kde.org>                   
00004                                                                         
00005     This program is free software; you can redistribute it and/or modify
00006     it under the terms of the GNU General Public License as published by
00007     the Free Software Foundation; either version 2 of the License, or   
00008     (at your option) any later version.                                 
00009                                                                         
00010     This program is distributed in the hope that it will be useful,     
00011     but WITHOUT ANY WARRANTY; without even the implied warranty of      
00012     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the        
00013     GNU General Public License for more details.                        
00014                                                                         
00015     You should have received a copy of the GNU General Public License   
00016     along with this program; if not, write to the Free Software         
00017     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.           
00018                                                                         
00019     As a special exception, permission is given to link this program    
00020     with any edition of Qt, and distribute the resulting executable,    
00021     without including the source code for Qt in the source distribution.
00022 */                                                                      
00023 
00024 #ifndef KAB_EXTENSIONWIDGET_H
00025 #define KAB_EXTENSIONWIDGET_H
00026 
00027 #include <qwidget.h>
00028 
00029 #include <kabc/addressbook.h>
00030 #include <klibloader.h>
00031 
00032 
00033 namespace KAB {
00034 class Core;
00035 class ConfigureWidget;
00036 
00037 class ExtensionWidget : public QWidget
00038 {
00039   Q_OBJECT
00040   
00041   public:
00042     ExtensionWidget( Core *core, QWidget *parent, const char *name = 0 );
00043     ~ExtensionWidget();
00044 
00048     KAB::Core *core() const;
00049 
00053     bool contactsSelected() const;
00054 
00060     KABC::Addressee::List selectedContacts();
00061 
00065     virtual void contactsSelectionChanged();
00066 
00071     virtual QString title() const = 0;
00072 
00076     virtual QString identifier() const = 0;
00077 
00078   signals:
00079     void modified( const KABC::Addressee::List &list );
00080 
00081   private:
00082     KAB::Core *mCore;
00083 
00084     class ExtensionWidgetPrivate;
00085     ExtensionWidgetPrivate *d;
00086 };
00087 
00088 class ExtensionFactory : public KLibFactory
00089 {
00090   public:
00091     virtual ExtensionWidget *extension( KAB::Core *core, QWidget *parent,
00092                                         const char *name = 0 ) = 0;
00093 
00094     virtual ConfigureWidget *configureWidget( QWidget*, const char* = 0 )
00095     {
00096       return 0;
00097     }
00098 
00099     virtual bool configureWidgetAvailable() { return false; }
00100 
00105     virtual QString identifier() const = 0;
00106 
00107   protected:
00108     virtual QObject* createObject( QObject*, const char*, const char*,
00109                                    const QStringList & )
00110     {
00111       return 0;
00112     }
00113 };
00114 
00115 }
00116 
00117 #endif
KDE Logo
This file is part of the documentation for kaddressbook Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat May 1 11:38:51 2004 by doxygen 1.2.15 written by Dimitri van Heesch, © 1997-2003