• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdepimlibs API Reference
  • KDE Home
  • Contact Us
 

KCalCore Library

  • KCalCore
  • Attendee
Public Types | Public Member Functions | Friends | List of all members
KCalCore::Attendee Class Reference

#include <attendee.h>

Inheritance diagram for KCalCore::Attendee:
Inheritance graph
[legend]

Public Types

typedef QVector< Ptr > List
 
enum  PartStat {
  NeedsAction, Accepted, Declined, Tentative,
  Delegated, Completed, InProcess, None
}
 
typedef QSharedPointer< Attendee > Ptr
 
enum  Role { ReqParticipant, OptParticipant, NonParticipant, Chair }
 

Public Member Functions

 Attendee (const QString &name, const QString &email, bool rsvp=false, PartStat status=None, Role role=ReqParticipant, const QString &uid=QString())
 
 Attendee (const Attendee &attendee)
 
 ~Attendee ()
 
CustomProperties & customProperties ()
 
const CustomProperties & customProperties () const
 
QString delegate () const
 
QString delegator () const
 
bool operator!= (const Attendee &attendee) const
 
Attendee & operator= (const Attendee &attendee)
 
bool operator== (const Attendee &attendee) const
 
Role role () const
 
bool RSVP () const
 
void setCustomProperty (const QByteArray &xname, const QString &xvalue)
 
void setDelegate (const QString &delegate)
 
void setDelegator (const QString &delegator)
 
void setRole (Role role)
 
void setRSVP (bool rsvp)
 
void setStatus (PartStat status)
 
void setUid (const QString &uid)
 
PartStat status () const
 
QString uid () const
 

Friends

KCALCORE_EXPORT QDataStream & operator<< (QDataStream &s, const KCalCore::Attendee::Ptr &attendee)
 
KCALCORE_EXPORT QDataStream & operator>> (QDataStream &s, KCalCore::Attendee::Ptr &attendee)
 

Detailed Description

Represents information related to an attendee of an Calendar Incidence, typically a meeting or task (to-do).

Attendees are people with a name and (optional) email address who are invited to participate in some way in a meeting or task. This class also tracks that status of the invitation: accepted; tentatively accepted; declined; delegated to another person; in-progress; completed.

Attendees may optionally be asked to RSVP ("Respond Please") to the invitation.

Note that each attendee be can optionally associated with a UID (unique identifier) derived from a Calendar Incidence, Email Message, or any other thing you want.

Definition at line 57 of file attendee.h.

Member Typedef Documentation

typedef QVector<Ptr> KCalCore::Attendee::List

List of attendees.

Definition at line 99 of file attendee.h.

typedef QSharedPointer<Attendee> KCalCore::Attendee::Ptr

A shared pointer to an Attendee object.

Definition at line 94 of file attendee.h.

Member Enumeration Documentation

enum KCalCore::Attendee::PartStat

The different types of participant status.

The meaning is specific to the incidence type in context.

Enumerator
NeedsAction 

Event, to-do or journal needs action (default)

Accepted 

Event, to-do or journal accepted.

Declined 

Event, to-do or journal declined.

Tentative 

Event or to-do tentatively accepted.

Delegated 

Event or to-do delegated.

Completed 

To-do completed.

InProcess 

To-do in process of being completed.

Definition at line 70 of file attendee.h.

enum KCalCore::Attendee::Role

The different types of participation roles.

Enumerator
ReqParticipant 

Participation is required (default)

OptParticipant 

Participation is optional.

NonParticipant 

Non-Participant; copied for information purposes.

Chair 

Chairperson.

Definition at line 84 of file attendee.h.

Constructor & Destructor Documentation

Attendee::Attendee ( const QString &  name,
const QString &  email,
bool  rsvp = false,
Attendee::PartStat  status = None,
Attendee::Role  role = ReqParticipant,
const QString &  uid = QString() 
)

Constructs an attendee consisting of a Person name (name) and email address (email); invitation status and Role; an optional RSVP flag and UID.

Private class that helps to provide binary compatibility between releases.

Parameters
nameis person name of the attendee.
emailis person email address of the attendee.
rsvpif true, the attendee is requested to reply to invitations.
statusis the PartStat status of the attendee.
roleis the Role of the attendee.
uidis the UID of the attendee.

Definition at line 58 of file attendee.cpp.

Attendee::Attendee ( const Attendee &  attendee)

Constructs an attendee by copying another attendee.

Parameters
attendeeis the attendee to be copied.

Definition at line 70 of file attendee.cpp.

Attendee::~Attendee ( )

Destroys the attendee.

Definition at line 76 of file attendee.cpp.

Member Function Documentation

CustomProperties & Attendee::customProperties ( )

Returns a reference to the CustomProperties object.

Definition at line 176 of file attendee.cpp.

const CustomProperties & Attendee::customProperties ( ) const

Returns a const reference to the CustomProperties object.

Definition at line 181 of file attendee.cpp.

QString Attendee::delegate ( ) const

Returns the delegate.

See also
setDelegate().

Definition at line 156 of file attendee.cpp.

QString Attendee::delegator ( ) const

Returns the delegator.

See also
setDelegator().

Definition at line 166 of file attendee.cpp.

bool KCalCore::Attendee::operator!= ( const Attendee &  attendee) const

Compares this with attendee for inequality.

Parameters
attendeethe attendee to compare.

Definition at line 93 of file attendee.cpp.

Attendee & KCalCore::Attendee::operator= ( const Attendee &  attendee)

Sets this attendee equal to attendee.

Parameters
attendeeis the attendee to copy.

Definition at line 98 of file attendee.cpp.

bool KCalCore::Attendee::operator== ( const Attendee &  attendee) const

Compares this with attendee for equality.

Parameters
attendeethe attendee to compare.

Definition at line 81 of file attendee.cpp.

Attendee::Role Attendee::role ( ) const

Returns the Role of the attendee.

See also
setRole()

Definition at line 136 of file attendee.cpp.

bool Attendee::RSVP ( ) const

Returns the attendee RSVP flag.

See also
setRSVP()

Definition at line 116 of file attendee.cpp.

void Attendee::setCustomProperty ( const QByteArray &  xname,
const QString &  xvalue 
)

Adds a custom property.

If the property already exists it will be overwritten.

Parameters
xnameis the name of the property.
xvalueis its value.

Definition at line 171 of file attendee.cpp.

void Attendee::setDelegate ( const QString &  delegate)

Sets the delegate.

Parameters
delegateis a string containing a MAILTO URI of those delegated to attend the meeting.
See also
delegate(), setDelegator().

Definition at line 151 of file attendee.cpp.

void Attendee::setDelegator ( const QString &  delegator)

Sets the delegator.

Parameters
delegatoris a string containing a MAILTO URI of those who have delegated their meeting attendance.
See also
delegator(), setDelegate().

Definition at line 161 of file attendee.cpp.

void Attendee::setRole ( Attendee::Role  role)

Sets the Role of the attendee to role.

Parameters
roleis the Role to use for the attendee.
See also
role()

Definition at line 131 of file attendee.cpp.

void Attendee::setRSVP ( bool  rsvp)

Sets the RSVP flag of the attendee to rsvp.

Parameters
rsvpif set (true), the attendee is requested to reply to invitations.
See also
RSVP()

Definition at line 111 of file attendee.cpp.

void Attendee::setStatus ( Attendee::PartStat  status)

Sets the PartStat of the attendee to status.

Parameters
statusis the PartStat to use for the attendee.
See also
status()

Definition at line 121 of file attendee.cpp.

void Attendee::setUid ( const QString &  uid)

Sets the UID of the attendee to uid.

Parameters
uidis the UID to use for the attendee.
See also
uid()

Definition at line 141 of file attendee.cpp.

Attendee::PartStat Attendee::status ( ) const

Returns the PartStat of the attendee.

See also
setStatus()

Definition at line 126 of file attendee.cpp.

QString Attendee::uid ( ) const

Returns the UID of the attendee.

See also
setUid()

Definition at line 146 of file attendee.cpp.

Friends And Related Function Documentation

KCALCORE_EXPORT QDataStream& operator<< ( QDataStream &  s,
const KCalCore::Attendee::Ptr &  attendee 
)
friend

Serializes an Attendee object into a data stream.

Parameters
streamis a QDataStream.
attendeeis a pointer to a Attendee object to be serialized.
KCALCORE_EXPORT QDataStream& operator>> ( QDataStream &  s,
KCalCore::Attendee::Ptr &  attendee 
)
friend

Initializes an Attendee object from a data stream.

Parameters
streamis a QDataStream.
attendeeis a pointer to a Attendee object to be initialized.

The documentation for this class was generated from the following files:
  • attendee.h
  • attendee.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2014 The KDE developers.
Generated on Tue Oct 14 2014 22:59:58 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KCalCore Library

Skip menu "KCalCore Library"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdepimlibs API Reference

Skip menu "kdepimlibs API Reference"
  • akonadi
  •   contact
  •   kmime
  •   socialutils
  • kabc
  • kalarmcal
  • kblog
  • kcal
  • kcalcore
  • kcalutils
  • kholidays
  • kimap
  • kldap
  • kmbox
  • kmime
  • kpimidentities
  • kpimtextedit
  • kresources
  • ktnef
  • kxmlrpcclient
  • microblog

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal