distributionlist.h

/*
    This file is part of libkabc.
    Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>

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

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
*/

#ifndef KABC_DISTRIBUTIONLIST_H
#define KABC_DISTRIBUTIONLIST_H

#include "kabc_export.h"
#ifndef KDEPIM_NO_KRESOURCES
#include "addressbook.h"
#else
#include "addressee.h"
#include <QtCore/QMap>
#endif
#include <QtCore/QList>

namespace KABC {

//class DistributionListManager;
class Resource;

class KABC_DEPRECATED_EXPORT DistributionList
{
  public:
    class KABC_EXPORT Entry
    {
      public:
        typedef QList<Entry> List;

        Entry();

        Entry( const Entry &other );

        Entry( const Addressee &addressee, const QString &email );

        ~Entry();

        Entry &operator=( const Entry &other );

        Addressee addressee() const;

        QString email() const;

      private:
        class Private;
        Private *const d;
    };

    DistributionList( Resource *resource, const QString &name );

    DistributionList( Resource *resource, const QString &identifier,
                      const QString &name );

    ~DistributionList();

    void setIdentifier( const QString &identifier );

    QString identifier() const;

    void setName( const QString & );

    QString name() const;

    void insertEntry( const Addressee &, const QString &email=QString() );

    void removeEntry( const Addressee &, const QString &email=QString() );

    QStringList emails() const;

    Entry::List entries() const;

    Resource *resource() const;

  private:
    class Private;
    Private *const d;

    Q_DISABLE_COPY( DistributionList )
};

typedef QMap<QString, DistributionList*> DistributionListMap;

}
#endif