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     void deleted( const QStringList& uidList );
00081 
00082   private:
00083     KAB::Core *mCore;
00084 
00085     class ExtensionWidgetPrivate;
00086     ExtensionWidgetPrivate *d;
00087 };
00088 
00089 class ExtensionFactory : public KLibFactory
00090 {
00091   public:
00092     virtual ExtensionWidget *extension( KAB::Core *core, QWidget *parent,
00093                                         const char *name = 0 ) = 0;
00094 
00095     virtual ConfigureWidget *configureWidget( QWidget*, const char* = 0 )
00096     {
00097       return 0;
00098     }
00099 
00100     virtual bool configureWidgetAvailable() { return false; }
00101 
00106     virtual QString identifier() const = 0;
00107 
00108   protected:
00109     virtual QObject* createObject( QObject*, const char*, const char*,
00110                                    const QStringList & )
00111     {
00112       return 0;
00113     }
00114 };
00115 
00116 }
00117 
00118 #endif
KDE Logo
This file is part of the documentation for kaddressbook Library Version 3.3.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Jul 25 11:19:25 2007 by doxygen 1.4.2 written by Dimitri van Heesch, © 1997-2003