kabc Library API Documentation

KABC::DistributionList Class Reference

Distribution list of email addresses. More...

#include <distributionlist.h>

List of all members.

Public Methods

 DistributionList (DistributionListManager *manager, const QString &name)
 Create distribution list object.

 ~DistributionList ()
 Destructor.

void setName (const QString &)
 Set name of this list.

QString name () const
 Get name of this list.

void insertEntry (const Addressee &, const QString &email=QString::null)
 Insert an entry into this distribution list.

void removeEntry (const Addressee &, const QString &email=QString::null)
 Remove an entry from this distribution list.

QStringList emails () const
 Return list of email addresses, which belong to this distributon list.

Entry::List entries () const
 Return list of entries belonging to this distribution list.


Detailed Description

Distribution list of email addresses.

This class represents a list of email addresses. Each email address is associated with an address book entry. If the address book entry changes, the entry in the distribution list is automatically updated.

Definition at line 39 of file distributionlist.h.


Constructor & Destructor Documentation

DistributionList::DistributionList DistributionListManager   manager,
const QString   name
 

Create distribution list object.

Parameters:
manager  Managing object of this list.
name  Name of this list.

Definition at line 29 of file distributionlist.cpp.

References KABC::DistributionListManager::insert().

DistributionList::~DistributionList  
 

Destructor.

Definition at line 36 of file distributionlist.cpp.

References KABC::DistributionListManager::remove().


Member Function Documentation

void DistributionList::setName const QString  
 

Set name of this list.

The name is used as key by the DistributinListManager.

Definition at line 41 of file distributionlist.cpp.

QString DistributionList::name  
 

Get name of this list.

Definition at line 46 of file distributionlist.cpp.

Referenced by KABC::DistributionListManager::insert(), KABC::DistributionListManager::list(), KABC::DistributionListManager::listNames(), KABC::DistributionListManager::remove(), and KABC::DistributionListManager::save().

void DistributionList::insertEntry const Addressee  ,
const QString   email = QString::null
 

Insert an entry into this distribution list.

If the entry already exists nothing happens.

Definition at line 51 of file distributionlist.cpp.

References QValueList< Entry >::append(), QValueList< Entry >::begin(), QValueList< Entry >::end(), QString::isEmpty(), QString::isNull(), and KABC::Addressee::uid().

Referenced by KABC::DistributionListManager::load().

void DistributionList::removeEntry const Addressee  ,
const QString   email = QString::null
 

Remove an entry from this distribution list.

If the entry doesn't exist nothing happens.

Definition at line 73 of file distributionlist.cpp.

References QValueList< Entry >::begin(), QValueList< Entry >::end(), QValueList< Entry >::remove(), and KABC::Addressee::uid().

QStringList DistributionList::emails  
 

Return list of email addresses, which belong to this distributon list.

These addresses can be directly used by e.g. a mail client.

Definition at line 84 of file distributionlist.cpp.

References QValueList< Entry >::begin(), emails(), QValueList< Entry >::end(), KABC::Addressee::fullEmail(), and QString::isEmpty().

Referenced by emails().

DistributionList::Entry::List DistributionList::entries  
 

Return list of entries belonging to this distribution list.

This function is mainly useful for a distribution list editor.

Definition at line 102 of file distributionlist.cpp.

Referenced by KABC::DistributionListManager::save().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:22:09 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001