KCalendarCore::Attendee

Search for usage in LXR

KCalendarCore::Attendee Class Reference

#include <attendee.h>

Public Types

enum  CuType {
  Individual, Group, Resource, Room,
  Unknown
}
 
typedef QVector< AttendeeList
 
enum  PartStat {
  NeedsAction, Accepted, Declined, Tentative,
  Delegated, Completed, InProcess, None
}
 
enum  Role { ReqParticipant, OptParticipant, NonParticipant, Chair }
 

Properties

CuType cuType
 
QString delegate
 
QString delegator
 
QString email
 
QString fullName
 
bool isNull
 
QString name
 
Role role
 
bool rsvp
 
PartStat status
 
QString uid
 

Public Member Functions

 Attendee ()
 
 Attendee (const Attendee &attendee)
 
 Attendee (const QString &name, const QString &email, bool rsvp=false, PartStat status=None, Role role=ReqParticipant, const QString &uid=QString())
 
 ~Attendee ()
 
CustomPropertiescustomProperties ()
 
const CustomPropertiescustomProperties () const
 
CuType cuType () const
 
QString cuTypeStr () const
 
QString delegate () const
 
QString delegator () const
 
QString email () const
 
QString fullName () const
 
bool isNull () const
 
QString name () const
 
bool operator!= (const Attendee &attendee) const
 
Attendeeoperator= (const Attendee &attendee)
 
bool operator== (const Attendee &attendee) const
 
Role role () const
 
bool RSVP () const
 
void setCustomProperty (const QByteArray &xname, const QString &xvalue)
 
void setCuType (const QString &cuType)
 
void setCuType (CuType cuType)
 
void setDelegate (const QString &delegate)
 
void setDelegator (const QString &delegator)
 
void setEmail (const QString &email)
 
void setName (const QString &name)
 
void setRole (Role role)
 
void setRSVP (bool rsvp)
 
void setStatus (PartStat status)
 
void setUid (const QString &uid)
 
PartStat status () const
 
QString uid () const
 

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 44 of file attendee.h.

Member Typedef Documentation

◆ List

List of attendees.

Definition at line 109 of file attendee.h.

Member Enumeration Documentation

◆ CuType

The different types of a participant.

Since
4.14
Enumerator
Individual 

An individual (default)

Group 

A group of individuals.

Resource 

A physical resource.

Room 

A room resource.

Unknown 

Otherwise not known.

Definition at line 92 of file attendee.h.

◆ 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 64 of file attendee.h.

◆ 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 79 of file attendee.h.

Constructor & Destructor Documentation

◆ Attendee() [1/3]

Attendee::Attendee ( )

Create a null Attendee.

Definition at line 109 of file attendee.cpp.

◆ Attendee() [2/3]

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.

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 114 of file attendee.cpp.

◆ Attendee() [3/3]

Attendee::Attendee ( const Attendee attendee)

Constructs an attendee by copying another attendee.

Parameters
attendeeis the attendee to be copied.

Definition at line 126 of file attendee.cpp.

◆ ~Attendee()

Attendee::~Attendee ( )
default

Destroys the attendee.

Member Function Documentation

◆ customProperties() [1/2]

const CustomProperties & Attendee::customProperties ( )

Returns a reference to the CustomProperties object.

Definition at line 292 of file attendee.cpp.

◆ customProperties() [2/2]

const CustomProperties& KCalendarCore::Attendee::customProperties ( ) const

Returns a const reference to the CustomProperties object.

◆ cuType()

CuType KCalendarCore::Attendee::cuType ( ) const

Returns the CuType of the attendee.

See also
setCuType()
Since
4.14

◆ cuTypeStr()

QString Attendee::cuTypeStr ( ) const

Returns the CuType of the attendee.

See also
setCuType()
Since
4.14

Definition at line 230 of file attendee.cpp.

◆ delegate()

QString KCalendarCore::Attendee::delegate ( ) const

Returns the delegate.

See also
setDelegate().

◆ delegator()

QString KCalendarCore::Attendee::delegator ( ) const

Returns the delegator.

See also
setDelegator().

◆ email()

QString KCalendarCore::Attendee::email ( ) const

Returns the email address for this attendee.

◆ fullName()

QString KCalendarCore::Attendee::fullName ( ) const

Returns the full name and email address of this attendee.

Returns
A QString containing the person's full name in the form "FirstName LastName \<mail@domain\>".

◆ isNull()

bool KCalendarCore::Attendee::isNull ( ) const

Returns true if this is a default-constructed Attendee instance.

◆ name()

QString KCalendarCore::Attendee::name ( ) const

Returns the name of the attendee.

◆ operator!=()

bool KCalendarCore::Attendee::operator!= ( const Attendee attendee) const

Compares this with attendee for inequality.

Parameters
attendeethe attendee to compare.

Definition at line 146 of file attendee.cpp.

◆ operator=()

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

Sets this attendee equal to attendee.

Parameters
attendeeis the attendee to copy.

Definition at line 151 of file attendee.cpp.

◆ operator==()

bool KCalendarCore::Attendee::operator== ( const Attendee attendee) const

Compares this with attendee for equality.

Parameters
attendeethe attendee to compare.

Definition at line 139 of file attendee.cpp.

◆ role()

Role KCalendarCore::Attendee::role ( ) const

Returns the Role of the attendee.

See also
setRole()

◆ RSVP()

bool Attendee::RSVP ( ) const

Returns the attendee RSVP flag.

See also
setRSVP()

Definition at line 200 of file attendee.cpp.

◆ setCustomProperty()

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 287 of file attendee.cpp.

◆ setCuType() [1/2]

void Attendee::setCuType ( const QString cuType)

Sets the CuType of the attendee to cuType.

Parameters
cuTypeis the CuType to use for the attendee.
See also
cuType()
Since
4.14

Definition at line 220 of file attendee.cpp.

◆ setCuType() [2/2]

void Attendee::setCuType ( Attendee::CuType  cuType)

Sets the CuType of the attendee to cuType.

Parameters
cuTypeis the CuType to use for the attendee.
See also
cuType()
Since
4.14

Definition at line 215 of file attendee.cpp.

◆ setDelegate()

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 267 of file attendee.cpp.

◆ setDelegator()

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 277 of file attendee.cpp.

◆ setEmail()

void Attendee::setEmail ( const QString email)

Sets the email address for this attendee to email.

Definition at line 186 of file attendee.cpp.

◆ setName()

void Attendee::setName ( const QString name)

Sets the name of the attendee to name.

Definition at line 167 of file attendee.cpp.

◆ setRole()

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 235 of file attendee.cpp.

◆ setRSVP()

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 195 of file attendee.cpp.

◆ setStatus()

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 205 of file attendee.cpp.

◆ setUid()

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 245 of file attendee.cpp.

◆ status()

PartStat KCalendarCore::Attendee::status ( ) const

Returns the PartStat of the attendee.

See also
setStatus()

◆ uid()

QString KCalendarCore::Attendee::uid ( ) const

Returns the UID of the attendee.

See also
setUid()

The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Sat Sep 23 2023 04:00:34 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.