Diffstat (limited to 'kaddressbook/extensionwidget.h') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | kaddressbook/extensionwidget.h | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/kaddressbook/extensionwidget.h b/kaddressbook/extensionwidget.h new file mode 100644 index 0000000..fc91f21 --- a/dev/null +++ b/kaddressbook/extensionwidget.h @@ -0,0 +1,119 @@ +/* + This file is part of KAddressBook. + Copyright (c) 2002 Tobias Koenig <tokoe@kde.org> + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + + As a special exception, permission is given to link this program + with any edition of Qt, and distribute the resulting executable, + without including the source code for Qt in the source distribution. +*/ + +#ifndef EXTENSIONWIDGET_H +#define EXTENSIONWIDGET_H + +#include <qwidget.h> + +#include <kabc/addressbook.h> +#ifndef KAB_EMBEDDED +#include <klibloader.h> +#endif //KAB_EMBEDDED + +class ConfigureWidget; +class KABCore; + +class ExtensionWidget : public QWidget +{ + Q_OBJECT + + public: + ExtensionWidget( KABCore *core, QWidget *parent, const char *name = 0 ); + ~ExtensionWidget(); + + /** + @return A pointer to the core object + */ + KABCore *core() const; + + /** + Returns whether there are selected contacts in the view. + */ + bool contactsSelected() const; + + /** + Returns a list of contacts that are selected in the view. + Use @ref addresseesSelected() to test if there exists selected + contacts. + */ + KABC::Addressee::List selectedContacts(); + + /** + This method is called whenever the selection in the view changed. + */ + virtual void contactsSelectionChanged(); + + /** + This method should be reimplemented and return the i18ned title of this + widget. + */ + virtual QString title() const; + + /** + This method should be reimplemented and return a unique identifier. + */ + virtual QString identifier() const; + + signals: + void modified( const KABC::Addressee::List &list ); + + private: + KABCore *mCore; + + class ExtensionWidgetPrivate; + ExtensionWidgetPrivate *d; +}; + +#ifndef KAB_EMBEDDED +//MOC_SKIP_BEGIN +class ExtensionFactory : public KLibFactory +//MOC_SKIP_END +#else //KAB_EMBEDDED +class ExtensionFactory +#endif //KAB_EMBEDDED +{ + public: + virtual ExtensionWidget *extension( KABCore *core, QWidget *parent, + const char *name = 0 ) = 0; + + virtual ConfigureWidget *configureWidget( QWidget *parent, + const char *name = 0 ); + + virtual bool configureWidgetAvailable() { return false; } + + /** + This method should return the same identifier like the config + widget. + */ + virtual QString identifier() const = 0; + + protected: + virtual QObject* createObject( QObject*, const char*, const char*, + const QStringList & ) + { + return 0; + } +}; + +#endif |