kopetecontactlist.h

Go to the documentation of this file.

/*
    kopetecontactlist.h - Kopete's Contact List backend

    Copyright (c) 2002      by Martijn Klingens       <klingens@kde.org>
    Copyright (c) 2002-2004 by Olivier Goffart        <ogoffart@kde.org>

    Kopete    (c) 2002-2004 by the Kopete developers  <kopete-devel@kde.org>

    *************************************************************************
    *                                                                       *
    * This library is free software; you can redistribute it and/or         *
    * modify it under the terms of the GNU Lesser General Public            *
    * License as published by the Free Software Foundation; either          *
    * version 2 of the License, or (at your option) any later version.      *
    *                                                                       *
    *************************************************************************
*/

#ifndef KOPETECONTACTLIST_H__
#define KOPETECONTACTLIST_H__

#include <QtCore/QObject>
#include <QtCore/QList>
#include <QtGui/QStandardItemModel>

#include <KUrl>

#include "kopete_export.h"

namespace Kopete
{

class MetaContact;
class Group;
class Contact;


class KOPETE_EXPORT ContactList : public QObject
{
    Q_OBJECT

public:
    static ContactList *self();
    ~ContactList();

    QList<MetaContact *> metaContacts() const;

    QList<Group *> groups() const;

    MetaContact *metaContact( const QString &metaContactId ) const;

    Group * group(unsigned int groupId) const;


    Contact *findContact( const QString &protocolId, const QString &accountId, const QString &contactId ) const;

    MetaContact *findMetaContactByDisplayName( const QString &displayName ) const;

    MetaContact *findMetaContactByContactId( const QString &contactId ) const;

    Group * findGroup( const QString &displayName, int type = 0/*Group::Normal*/ );

    QList<MetaContact *> selectedMetaContacts() const;

    QList<Group *> selectedGroups() const ;

    MetaContact* myself();

public slots:
    void addMetaContacts( QList<MetaContact *> metaContacts );

    void addMetaContact( Kopete::MetaContact *c );

    void removeMetaContact( Kopete::MetaContact *contact );

    void mergeMetaContacts( QList<MetaContact *> src, Kopete::MetaContact *dst );

    void addGroups( QList<Group *> groups );

    void addGroup(Kopete::Group *);

    void removeGroup(Kopete::Group *);

     void setSelectedItems(QList<MetaContact *> metaContacts , QList<Group *> groups);

    void load();

    bool loaded() const;

    void save();

    void shutdown();

signals:
    void metaContactAdded( Kopete::MetaContact *mc );

    void metaContactRemoved( Kopete::MetaContact *mc );

    void groupAdded( Kopete::Group * );

    void groupRemoved( Kopete::Group * );

    void groupRenamed(Kopete::Group *, const QString & oldname);

    void metaContactAddedToGroup( Kopete::MetaContact *mc, Kopete::Group *to );
    void metaContactRemovedFromGroup( Kopete::MetaContact *mc, Kopete::Group *from );

    void metaContactMovedToGroup( Kopete::MetaContact *mc, Kopete::Group *from, Kopete::Group *to );

    void selectionChanged();
    void metaContactSelected(bool);

    void contactListLoaded();

private slots:
    void slotSaveLater();
    void slotKABCChanged();

private:
    ContactList();
    
    static ContactList *s_self;
    class Private;
    Private * const d;
};

} //END namespace Kopete


#endif