From 460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: 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 --- libkcal/attendee.h | 162 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 libkcal/attendee.h (limited to 'libkcal/attendee.h') diff --git a/libkcal/attendee.h b/libkcal/attendee.h new file mode 100644 index 00000000..1cdc7b54 --- /dev/null +++ b/libkcal/attendee.h @@ -0,0 +1,162 @@ +/* + This file is part of libkcal. + + Copyright (c) 2001-2003 Cornelius Schumacher + + 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 KCAL_ATTENDEE_H +#define KCAL_ATTENDEE_H + +#include +#include + +#include "listbase.h" +#include "person.h" + +namespace KCal { + +/** + This class represents information related to an attendee of an event. +*/ +class LIBKCAL_EXPORT Attendee : public Person +{ + public: + enum PartStat { NeedsAction, Accepted, Declined, Tentative, + Delegated, Completed, InProcess }; + enum Role { ReqParticipant, OptParticipant, NonParticipant, Chair }; + + typedef ListBase List; + + /** + Create Attendee. + + @param name Name + @param email Email address + @param rsvp Request for reply + @param status Status (see enum for list) + @param role Role + @param u the uid for the attendee + */ + Attendee( const QString &name, const QString &email, + bool rsvp = false, PartStat status = NeedsAction, + Role role = ReqParticipant, const QString &u = QString::null ); + /** + Destruct Attendee. + */ + virtual ~Attendee(); + + /** + Set role of Attendee. + */ + // FIXME: List of roles still has to be documented. + void setRole( Role ); + + /** + Return role of Attendee. + */ + Role role() const; + + /** + Return role as clear text string. + */ + QString roleStr() const; + /** + Return string represenation of role. + */ + static QString roleName( Role ); + /** + Return string representations of all available roles. + */ + static QStringList roleList(); + + /** + Return unique id of the attendee. + */ + QString uid() const; + /** + Set unique id of attendee. + */ + void setUid ( const QString & ); + + /** + Set status. See enum for definitions of possible values. + */ + void setStatus( PartStat s ); + + /** + Return status. + */ + PartStat status() const; + + /** + Return status as human-readable string. + */ + QString statusStr() const; + /** + Return string representation of attendee status. + */ + static QString statusName( PartStat ); + /** + Return string representations of all available attendee status values. + */ + static QStringList statusList(); + + /** + Set if Attendee is asked to reply. + */ + void setRSVP( bool r ) { mRSVP = r; } + /** + Return, if Attendee is asked to reply. + */ + bool RSVP() const { return mRSVP; } + + /** + Sets the delegate. + */ + void setDelegate( const QString &delegate ) { mDelegate = delegate; } + /** + Returns the delegate. + */ + QString delegate() const { return mDelegate; } + + /** + Sets the delegator. + */ + void setDelegator( const QString &delegator ) { mDelegator = delegator; } + /** + Returns the delegator. + */ + QString delegator() const { return mDelegator; } + + private: + bool mRSVP; + Role mRole; + PartStat mStatus; + QString mUid; + QString mDelegate; + QString mDelegator; + + class Private; + Private *d; +}; + +bool operator==( const Attendee& a1, const Attendee& a2 ); + +} + +#endif -- cgit v1.2.3