Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 497 insertions, 0 deletions

diff --git a/kaddressbook/kabcore.h b/kaddressbook/kabcore.h
new file mode 100644
index 000000000..8cb2bc4d5
--- /dev/null
+++ b/kaddressbook/kabcore.h
@@ -0,0 +1,497 @@
+/*
+    This file is part of KAddressbook.
+    Copyright (c) 2003 Tobias Koenig <[email protected]>
+
+    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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 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 KABCORE_H
+#define KABCORE_H
+
+#include <kabc/field.h>
+
+#include <qdict.h>
+#include <qlabel.h>
+#include <qwidget.h>
+
+#include "core.h"
+#include <kdepimmacros.h>
+
+namespace KABC {
+class AddressBook;
+class Ticket;
+}
+
+namespace KPIM {
+class AddresseeView;
+class CategoryEditDialog;
+class CategorySelectDialog;
+}
+
+class KAboutData;
+class KAction;
+class KActionCollection;
+class KConfig;
+class KStatusBar;
+class KToggleAction;
+class KXMLGUIClient;
+
+class QSplitter;
+class QHBoxLayout;
+class QWidgetStack;
+
+class AddresseeEditorDialog;
+class ExtensionManager;
+class FilterSelectionWidget;
+class IncSearchWidget;
+class JumpButtonBar;
+class KAddressBookIface;
+class KAddressBookService;
+class KIMProxy;
+class LDAPSearchDialog;
+class ViewManager;
+class XXPortManager;
+
+namespace KAB {
+    class DistributionListEntryView;
+}
+
+typedef struct {
+  KABC::Ticket *ticket;
+  int counter;
+} ResourceMapEntry;
+
+class KDE_EXPORT KABCore : public KAB::Core
+{
+  Q_OBJECT
+
+  public:
+    KABCore( KXMLGUIClient *client, bool readWrite, QWidget *parent,
+             const QString &file = QString::null, const char *name = 0 );
+    ~KABCore();
+
+    /**
+      Restores the global settings.
+     */
+    void restoreSettings();
+
+    /**
+      Saves the global settings.
+     */
+    void saveSettings();
+
+    /**
+      Returns a pointer to the StdAddressBook of the application.
+     */
+    KABC::AddressBook *addressBook() const;
+
+    /**
+      Returns a pointer to the KConfig object of the application.
+     */
+    KConfig *config() const;
+
+    /**
+      Returns a pointer to the global KActionCollection object. So
+      other classes can register their actions easily.
+     */
+    KActionCollection *actionCollection() const;
+
+    /**
+      Returns the current sort field of the view.
+     */
+    KABC::Field *currentSortField() const;
+
+    /**
+      Returns the uid list of the currently selected contacts.
+     */
+    QStringList selectedUIDs() const;
+
+    /**
+      Displays the ResourceSelectDialog and returns the selected
+      resource or a null pointer if no resource was selected by
+      the user.
+     */
+    KABC::Resource *requestResource( QWidget *parent );
+
+    /**
+      Returns the parent widget.
+     */
+    QWidget *widget() const;
+
+    static KAboutData *createAboutData();
+
+    void setStatusBar( KStatusBar *statusBar );
+
+    KStatusBar *statusBar() const;
+
+    KAB::SearchManager *searchManager() const { return mSearchManager; }
+
+    KCommandHistory *commandHistory() const { return mCommandHistory; }
+
+#ifdef KDEPIM_NEW_DISTRLISTS
+    /**
+      Returns all the distribution lists.
+     */
+    virtual KPIM::DistributionList::List distributionLists() const;
+
+    /**
+      Returns the name of all the distribution lists.
+     */
+    virtual QStringList distributionListNames() const;
+
+    /**
+      sets the distribution list to display. If null, the regular
+      address book is to be displayed.  
+     */
+    virtual void setSelectedDistributionList( const QString &name );
+#endif
+
+  public slots:
+    /**
+      Is called whenever a contact is selected in the view.
+     */
+    void setContactSelected( const QString &uid );
+
+    /**
+      Opens the preferred mail composer with all selected contacts as
+      arguments.
+     */
+    void sendMail();
+
+    /**
+      Opens the preferred mail composer with the given contacts as
+      arguments.
+     */
+    void sendMail( const QString& email );
+
+
+    void mailVCard();
+    void mailVCard(const QStringList& uids);
+
+    /**
+     * Start an Instant Messaging chat with the selected contacts
+     */
+    void startChat();
+
+    /**
+      Starts the preferred web browser with the given URL as argument.
+     */
+    void browse( const QString& url );
+
+    /**
+      Select all contacts in the view.
+     */
+    void selectAllContacts();
+
+    /**
+      Deletes all selected contacts from the address book.
+     */
+    void deleteContacts();
+
+    /**
+      Deletes given contacts from the address book.
+
+      @param uids The uids of the contacts, which shall be deleted.
+     */
+    void deleteContacts( const QStringList &uids );
+
+    /**
+      Deletes given distribution lists from the address book.
+
+      @param uids The names of the distribution lists which shall be deleted.
+     */
+    void deleteDistributionLists( const QStringList &names );
+
+
+    /**
+      Copys the selected contacts into clipboard for later pasting.
+     */
+    void copyContacts();
+
+    /**
+      Cuts the selected contacts and stores them for later pasting.
+     */
+    void cutContacts();
+
+    /**
+      Paste contacts from clipboard into the address book.
+     */
+    void pasteContacts();
+
+    /**
+      Paste given contacts into the address book.
+
+      @param list The list of addressee, which shall be pasted.
+     */
+    void pasteContacts( KABC::Addressee::List &list );
+
+
+    /**
+      Merge the selected contacts in a single one.
+     */
+    void mergeContacts();
+
+    /**
+      Sets the whoAmI contact, that is used by many other programs to
+      get personal information about the current user.
+     */
+    void setWhoAmI();
+
+    /**
+      Displays the category dialog and applies the result to all
+      selected contacts.
+     */
+    void setCategories();
+
+    /**
+      Search with the current search field for a contact, that matches
+      the given text, and selects it in the view.
+     */
+    void incrementalTextSearch( const QString& text );
+
+    void incrementalJumpButtonSearch( const QString& characters );
+
+    /**
+      Marks the address book as modified.
+     */
+    void setModified();
+
+    /**
+      Marks the address book as modified concerning the argument.
+     */
+    void setModified( bool modified );
+
+    /**
+      Returns whether the address book is modified.
+     */
+    bool modified() const;
+
+    /**
+      Called whenever an contact is modified in the contact editor
+      dialog or the quick edit.
+     */
+    void contactModified( const KABC::Addressee &addr );
+
+    /**
+      DCOP METHOD: Adds the given email address to address book.
+     */
+    virtual void addEmail( const QString& addr );
+
+    /**
+      DCOP METHOD: Imports the vCard, located at the given url.
+     */
+    virtual void importVCard( const KURL& url );
+
+    /**
+      DCOP METHOD: Imports the given vCard.
+     */
+    virtual void importVCardFromData( const QString& vCard );
+
+    /**
+      DCOP METHOD: Opens contact editor to input a new contact.
+     */
+    virtual void newContact();
+
+    /** 
+     DCOP METHOD: Opens distribution list editor to create a new distribution list
+    */
+    virtual void newDistributionList();
+
+    /**
+      DCOP METHOD: Returns the name of the contact, that matches the given
+                   phone number.
+     */
+    virtual QString getNameByPhone( const QString& phone );
+
+    /**
+      DCOP METHOD: Handle command line arguments, return true if handled
+      and false if no args was given. The iface is either the mainwin or the part.
+     */
+    bool handleCommandLine( KAddressBookIface* iface );
+
+
+    /**
+      Saves the contents of the AddressBook back to disk.
+     */
+    void save();
+
+    /**
+      Shows the edit dialog for the given uid. If the uid is QString::null,
+      the method will try to find a selected addressee in the view.
+     */
+    void editContact( const QString &uid = QString::null );
+
+    /**
+     * Let the user chose a different resource for the selected contacts.
+     * If the adding to the new resource is successfull, the contact is
+     * removed from the old one, unless the Copy flag is given. */
+    void storeContactIn( const QString &uid = QString::null, bool copy = false );
+    
+    /**
+     * Lets the user chose a different resource for the selected contacts and
+     * copies it there.
+     */
+    void copySelectedContactToResource();
+
+    /**
+     * Lets the user chose a different resource for the selected contacts and
+     * moves it there.
+     */
+    void moveSelectedContactToResource();
+
+    /**
+      Launches the ldap search dialog.
+     */
+    void openLDAPDialog();
+
+    /**
+      Opens the settings dialog.
+     */
+    void configure();
+
+    /**
+      Creates a KAddressBookPrinter, which will display the print
+      dialog and do the printing.
+     */
+    void print();
+
+    void detailsHighlighted( const QString& );
+
+    void showContactsAddress( const QString &uid );
+
+    void configurationChanged();
+
+    bool queryClose();
+
+    /**
+      Is called whenever the xmlgui has to be rebuild after a part switch.
+     */
+    void reinitXMLGUI();
+
+  private:
+
+#ifdef KDEPIM_NEW_DISTRLISTS
+    void editDistributionList( const KPIM::DistributionList &list );
+    void showDistributionListEntry( const QString &uid );
+#endif
+
+  private slots:
+    void setJumpButtonBarVisible( bool visible );
+    void setDetailsVisible( bool visible );
+
+    void extensionModified( const KABC::Addressee::List &list );
+    void extensionDeleted( const QStringList &uidList );
+    void clipboardDataChanged();
+    void updateIncSearchWidget();
+
+    void slotEditorDestroyed( const QString &uid );
+    void delayedAddressBookChanged();
+    void addressBookChanged();
+
+    void categoriesSelected( const QStringList& );
+    void editCategories();
+    void slotClearSearchBar();
+    void slotContactsUpdated();
+
+    void activateDetailsWidget( QWidget *widget );
+    void deactivateDetailsWidget( QWidget *widget );
+
+    void editDistributionList( const QString &name );
+
+    void removeSelectedContactsFromDistList();
+    void editSelectedDistributionList();
+    void sendMailToDistributionList( const QString &id ); 
+
+  private:
+    void initGUI();
+    void createJumpButtonBar();
+    void initActions();
+
+    void updateCategories();
+    QStringList allCategories() const;
+
+    AddresseeEditorDialog *createAddresseeEditorDialog( QWidget *parent,
+                                                        const char *name = 0 );
+
+    QWidget *mWidget;
+    KABC::AddressBook *mAddressBook;
+    KStatusBar *mStatusBar;
+
+    ViewManager *mViewManager;
+    QLabel *mViewHeaderLabel;
+
+#ifdef KDEPIM_NEW_DISTRLISTS
+    QString mSelectedDistributionList;
+    QWidget *mDistListButtonWidget;
+#endif
+
+    ExtensionManager *mExtensionManager;
+    XXPortManager *mXXPortManager;
+
+    JumpButtonBar *mJumpButtonBar;
+    FilterSelectionWidget *mFilterSelectionWidget;
+    IncSearchWidget *mIncSearchWidget;
+    KAB::DistributionListEntryView* mDistListEntryView;
+    KPIM::AddresseeView *mDetailsViewer;
+    KPIM::CategorySelectDialog *mCategorySelectDialog;
+    KPIM::CategoryEditDialog *mCategoryEditDialog;
+    QWidget *mDetailsPage;
+    QWidget *mDetailsWidget;
+    QHBoxLayout *mDetailsLayout;
+    QSplitter *mDetailsSplitter;
+    QSplitter *mLeftSplitter;
+    QWidgetStack *mDetailsStack;
+    LDAPSearchDialog *mLdapSearchDialog;
+    QDict<AddresseeEditorDialog> mEditorDict;
+
+    bool mReadWrite;
+    bool mModified;
+    bool mIsPart;
+
+    QTimer *mAddressBookChangedTimer;
+
+    KAction *mActionPaste;
+    KAction *mActionCut;
+    KAction *mActionDelete;
+    KAction *mActionCopy;
+    KAction *mActionEditAddressee;
+    KAction *mActionMoveAddresseeTo;
+    KAction *mActionCopyAddresseeTo;
+    KAction *mActionMerge;
+    KAction *mActionMail;
+    KAction *mActionMailVCard;
+    KAction *mActionChat;
+    KAction *mActionSave;
+    KAction *mActionDeleteView;
+    KAction *mActionWhoAmI;
+    KAction *mActionCategories;
+    KToggleAction *mActionJumpBar;
+    KToggleAction *mActionDetails;
+    KCommandHistory *mCommandHistory;
+
+    KAddressBookService *mAddressBookService;
+
+    KAB::SearchManager *mSearchManager;
+    // KIMProxy provides access to up to date instant messaging presence data
+    ::KIMProxy *mKIMProxy;
+    class KABCorePrivate;
+    KABCorePrivate *d;
+};
+
+#endif