You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
498 lines
12 KiB
498 lines
12 KiB
/*
|
|
This file is part of KAddressbook.
|
|
Copyright (c) 2003 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., 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
|