kaddressbook

core.h

00001 /*
00002     This file is part of KAddressbook.
00003     Copyright (c) 2003 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 along
00016     with this program; if not, write to the Free Software Foundation, Inc.,
00017     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 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_CORE_H
00025 #define KAB_CORE_H
00026 
00027 #include <libkdepim/distributionlist.h>
00028 
00029 #include <QtCore/QObject>
00030 #include <QtGui/QUndoStack>
00031 
00032 #include "kaddressbook_export.h"
00033 #include <kabc/field.h>
00034 #include <kxmlguiclient.h>
00035 
00036 namespace KABC {
00037 class AddressBook;
00038 class Resource;
00039 }
00040 
00041 class QWidget;
00042 
00043 class KActionCollection;
00044 class KConfig;
00045 class KUrl;
00046 
00047 namespace KAB {
00048 
00049 class SearchManager;
00050 
00051 class KABINTERFACES_EXPORT Core : public QObject
00052 {
00053   Q_OBJECT
00054 
00055   public:
00056     Core( KXMLGUIClient *client, QObject *parent, const char *name = 0 );
00057 
00061     virtual KABC::AddressBook *addressBook() const = 0;
00062 
00066     virtual KConfig *config() const = 0;
00067 
00072     virtual KActionCollection *actionCollection() const = 0;
00073 
00077     virtual KXMLGUIClient *guiClient() const { return mGUIClient; }
00078 
00082     virtual KABC::Field *currentSortField() const = 0;
00083 
00087     virtual QStringList selectedUIDs() const = 0;
00088 
00094     virtual KABC::Resource *requestResource( QWidget *parent ) = 0;
00095 
00099     virtual QWidget *widget() const = 0;
00100 
00106     virtual void deleteContacts( const QStringList &uids ) = 0;
00107 
00113     virtual void deleteDistributionLists( const QStringList &uids ) = 0;
00114 
00118     virtual KPIM::DistributionList::List distributionLists() const = 0;
00119 
00120 
00124     virtual QStringList distributionListNames() const = 0;
00125 
00130     virtual void setSelectedDistributionList( const QString &name ) = 0;
00131 
00133     virtual SearchManager *searchManager() const = 0;
00134 
00135     virtual QUndoStack *commandHistory() const = 0;
00136 
00137     Q_SIGNALS:
00142     void contactsUpdated();
00143 
00144   public Q_SLOTS:
00148     virtual void setContactSelected( const QString &uid ) = 0;
00149 
00153     virtual void addEmail( const QString& addr ) = 0;
00154 
00158     virtual void importVCard( const KUrl& url ) = 0;
00159 
00163     virtual void importVCardFromData( const QString& vCard ) = 0;
00164 
00168     virtual void newContact() = 0;
00169 
00173     virtual void newDistributionList() = 0;
00174 
00179     virtual QString getNameByPhone( const QString& phone ) = 0;
00180 
00184     virtual void editContact( const QString &uid = QString() ) = 0;
00185 
00189     virtual void editDistributionList( const QString &name ) = 0;
00190 
00191   private:
00192     KXMLGUIClient *mGUIClient;
00193 };
00194 
00195 }
00196 
00197 #endif