libkcal Library API Documentation

KCal::Incidence Class Reference

This class provides the base class common to all calendar components. More...

#include <incidence.h>

Inheritance diagram for KCal::Incidence:

KCal::IncidenceBase KCal::CustomProperties KCal::Event KCal::Journal KCal::Todo List of all members.

Public Types

typedef ListBase< IncidenceList
enum  { SecrecyPublic = 0, SecrecyPrivate = 1, SecrecyConfidential = 2 }

Public Member Functions

 Incidence (const Incidence &)
bool operator== (const Incidence &) const
virtual bool accept (Visitor &)
virtual Incidenceclone ()=0
void setReadOnly (bool)
void recreate ()
void setCreated (const QDateTime &)
QDateTime created () const
void setRevision (int rev)
int revision () const
virtual void setDtStart (const QDateTime &dtStart)
virtual QDateTime dtEnd () const
void setDescription (const QString &description)
QString description () const
void setSummary (const QString &summary)
QString summary () const
void setCategories (const QStringList &categories)
void setCategories (const QString &catStr)
QStringList categories () const
QString categoriesStr ()
void setRelatedToUid (const QString &)
QString relatedToUid () const
void setRelatedTo (Incidence *relatedTo)
IncidencerelatedTo () const
Incidence::List relations () const
void addRelation (Incidence *)
void removeRelation (Incidence *)
DateList exDates () const
DateTimeList exDateTimes () const
void setExDates (const DateList &exDates)
void setExDateTimes (const DateTimeList &exDateTimes)
void addExDate (const QDate &date)
void addExDateTime (const QDateTime &dateTime)
bool isException (const QDate &qd) const
bool isException (const QDateTime &qdt) const
void addAttachment (Attachment *attachment)
void deleteAttachment (Attachment *attachment)
void deleteAttachments (const QString &mime)
Attachment::List attachments () const
Attachment::List attachments (const QString &mime) const
void clearAttachments ()
void setSecrecy (int)
int secrecy () const
QString secrecyStr () const
bool recursOn (const QDate &qd) const
bool recursAt (const QDateTime &qdt) const
void setResources (const QStringList &resources)
QStringList resources () const
void setPriority (int priority)
int priority () const
const Alarm::Listalarms () const
AlarmnewAlarm ()
void addAlarm (Alarm *)
void removeAlarm (Alarm *)
void clearAlarms ()
bool isAlarmEnabled () const
Recurrencerecurrence () const
ushort doesRecur () const
void setLocation (const QString &location)
QString location () const

Static Public Member Functions

QStringList secrecyList ()
QString secrecyName (int)

Detailed Description

This class provides the base class common to all calendar components.

Definition at line 43 of file incidence.h.


Member Enumeration Documentation

anonymous enum
 

enumeration for describing an event's secrecy.

Definition at line 116 of file incidence.h.


Member Function Documentation

virtual bool KCal::Incidence::accept Visitor  )  [inline, virtual]
 

Accept IncidenceVisitor.

A class taking part in the visitor mechanism has to provide this implementation:

bool accept(Visitor &v) { return v.visit(this); }

Reimplemented in KCal::Journal.

Definition at line 133 of file incidence.h.

Referenced by KCal::ResourceCalendar::addIncidence(), KCal::Calendar::addIncidence(), and KCal::Calendar::deleteIncidence().

virtual Incidence* KCal::Incidence::clone  )  [pure virtual]
 

Return copy of this object.

The returned object is owned by the caller.

Implemented in KCal::Event, KCal::Journal, and KCal::Todo.

Referenced by KCal::DndFactory::createDrag(), KCal::ICalFormat::fromString(), and KCal::ICalFormat::toICalString().

void Incidence::setReadOnly bool   )  [virtual]
 

Set readonly state of incidence.

Parameters:
readonly If true, the incidence is set to readonly, if false the incidence is set to readwrite.

Reimplemented from KCal::IncidenceBase.

Definition at line 150 of file incidence.cpp.

References KCal::IncidenceBase::setReadOnly().

Referenced by KCal::ResourceKABC::load().

void Incidence::recreate  ) 
 

Recreate event.

The event is made a new unique event, but already stored event information is preserved. Sets uniquie id, creation date, last modification date and revision number.

Definition at line 139 of file incidence.cpp.

References setCreated(), KCal::IncidenceBase::setLastModified(), setRevision(), and KCal::IncidenceBase::setUid().

Referenced by KCal::DndFactory::pasteIncidence().

void Incidence::setCreated const QDateTime &   ) 
 

Set creation date.

Definition at line 157 of file incidence.cpp.

Referenced by recreate(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

QDateTime Incidence::created  )  const
 

Return time and date of creation.

Definition at line 163 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), and KCal::VCalFormat::eventToVTodo().

void Incidence::setRevision int  rev  ) 
 

Set the number of revisions this event has seen.

Definition at line 168 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by recreate(), and KCal::VCalFormat::VEventToEvent().

int Incidence::revision  )  const
 

Return the number of revisions this event has seen.

Definition at line 176 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), and KCal::VCalFormat::eventToVTodo().

void Incidence::setDtStart const QDateTime &  dtStart  )  [virtual]
 

Set starting date/time.

Reimplemented from KCal::IncidenceBase.

Definition at line 181 of file incidence.cpp.

References KCal::IncidenceBase::setDtStart().

Referenced by KCal::ResourceKABC::load(), KCal::DndFactory::pasteIncidence(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

virtual QDateTime KCal::Incidence::dtEnd  )  const [inline, virtual]
 

Return the incidence's ending date/time as a QDateTime.

Reimplemented in KCal::Event.

Definition at line 180 of file incidence.h.

Referenced by KCal::CalendarLocal::appendRecurringAlarms(), and KCal::Alarm::time().

void Incidence::setDescription const QString &  description  ) 
 

Set the long description.

Definition at line 188 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

QString Incidence::description  )  const
 

Return long description.

Definition at line 195 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), KCal::VCalFormat::eventToVTodo(), and KCal::VCalFormat::VEventToEvent().

void Incidence::setSummary const QString &  summary  ) 
 

Set short summary.

Definition at line 201 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::ResourceKABC::load(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

QString Incidence::summary  )  const
 

Return short summary.

Definition at line 208 of file incidence.cpp.

Referenced by KCal::CalendarLocal::appendAlarms(), KCal::CalendarLocal::appendRecurringAlarms(), KCal::Event::dtEnd(), KCal::VCalFormat::eventToVEvent(), KCal::VCalFormat::eventToVTodo(), and KCal::VCalFormat::VEventToEvent().

void Incidence::setCategories const QStringList &  categories  ) 
 

Set categories.

Definition at line 213 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::ResourceKABC::load(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

void Incidence::setCategories const QString &  catStr  ) 
 

Set categories based on a comma delimited string.

Definition at line 221 of file incidence.cpp.

References KCal::IncidenceBase::updated().

QStringList Incidence::categories  )  const
 

Return categories as a list of strings.

Definition at line 238 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), KCal::VCalFormat::eventToVTodo(), and KCal::CalFilter::filterIncidence().

QString Incidence::categoriesStr  ) 
 

Return categories as a comma separated string.

Definition at line 243 of file incidence.cpp.

void Incidence::setRelatedToUid const QString &   ) 
 

Point at some other event to which the event relates.

This function should only be used when constructing a calendar before the related Incidence exists.

Definition at line 248 of file incidence.cpp.

Referenced by KCal::Calendar::removeRelations(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

QString Incidence::relatedToUid  )  const
 

What event does this one relate to? This function should only be used when constructing a calendar before the related Incidence exists.

Definition at line 254 of file incidence.cpp.

Referenced by KCal::Calendar::setupRelations().

void Incidence::setRelatedTo Incidence relatedTo  ) 
 

Point at some other event to which the event relates.

Definition at line 259 of file incidence.cpp.

References addRelation(), and removeRelation().

Referenced by KCal::Calendar::removeRelations(), and KCal::Calendar::setupRelations().

Incidence * Incidence::relatedTo  )  const
 

What event does this one relate to?

Definition at line 268 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), KCal::VCalFormat::eventToVTodo(), KCal::Calendar::removeRelations(), and KCal::Calendar::setupRelations().

Incidence::List Incidence::relations  )  const
 

All events that are related to this event.

Definition at line 273 of file incidence.cpp.

Referenced by KCal::Calendar::removeRelations().

void Incidence::addRelation Incidence  ) 
 

Add an event which is related to this event.

Definition at line 278 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by setRelatedTo(), and KCal::Calendar::setupRelations().

void Incidence::removeRelation Incidence  ) 
 

Remove event that is related to this event.

Definition at line 286 of file incidence.cpp.

Referenced by KCal::Calendar::removeRelations(), and setRelatedTo().

DateList Incidence::exDates  )  const
 

Returns the list of dates which are exceptions to the recurrence rule.

Definition at line 330 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent().

DateTimeList Incidence::exDateTimes  )  const
 

Returns the list of date/times which are exceptions to the recurrence rule.

Definition at line 335 of file incidence.cpp.

void Incidence::setExDates const DateList &  exDates  ) 
 

Sets the list of dates which are exceptions to the recurrence rule.

This does not affect the date-time exception list.

Definition at line 302 of file incidence.cpp.

References KCal::IncidenceBase::updated().

void Incidence::setExDateTimes const DateTimeList &  exDateTimes  ) 
 

Sets the list of date/times which are exceptions to the recurrence rule.

This does not affect the date-only exception list.

Definition at line 309 of file incidence.cpp.

References KCal::IncidenceBase::updated().

void Incidence::addExDate const QDate &  date  ) 
 

Add a date to the list of exceptions of the recurrence rule.

Definition at line 316 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent().

void Incidence::addExDateTime const QDateTime &  dateTime  ) 
 

Add a date/time to the list of exceptions of the recurrence rule.

Definition at line 323 of file incidence.cpp.

References KCal::IncidenceBase::updated().

bool Incidence::isException const QDate &  qd  )  const
 

Returns true if there is an exception for this date in the recurrence rule set, or false otherwise.

Does not check the date/time exception list.

Definition at line 340 of file incidence.cpp.

Referenced by KCal::CalendarLocal::appendRecurringAlarms(), recursAt(), and recursOn().

bool Incidence::isException const QDateTime &  qdt  )  const
 

Returns true if there is an exception for this date/time in the recurrence rule set, or false otherwise.

Does not check the date-only exception list.

Definition at line 352 of file incidence.cpp.

void Incidence::addAttachment Attachment attachment  ) 
 

Add attachment.

Definition at line 364 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent().

void Incidence::deleteAttachment Attachment attachment  ) 
 

Remove and delete a specific attachment.

Definition at line 371 of file incidence.cpp.

void Incidence::deleteAttachments const QString &  mime  ) 
 

Remove and delete all attachments with this mime type.

Definition at line 376 of file incidence.cpp.

Attachment::List Incidence::attachments  )  const
 

Return list of all associated attachments.

Definition at line 385 of file incidence.cpp.

Referenced by attachments(), and KCal::VCalFormat::eventToVEvent().

Attachment::List Incidence::attachments const QString &  mime  )  const
 

Find a list of attachments with this mime type.

Definition at line 390 of file incidence.cpp.

References attachments().

void Incidence::clearAttachments  ) 
 

Remove and delete all attachments.

Definition at line 401 of file incidence.cpp.

void Incidence::setSecrecy int   ) 
 

Sets secrecy status.

This can be Public, Private or Confidential. See separate enum.

Definition at line 431 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent().

int Incidence::secrecy  )  const
 

Return the event's secrecy.

Definition at line 438 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent().

QString Incidence::secrecyStr  )  const
 

Return secrecy as translated string.

Definition at line 443 of file incidence.cpp.

References secrecyName().

QStringList Incidence::secrecyList  )  [static]
 

Return list of all available secrecy states as list of translated strings.

Definition at line 466 of file incidence.cpp.

References secrecyName().

QString Incidence::secrecyName int   )  [static]
 

Return human-readable translated name of secrecy class.

Definition at line 448 of file incidence.cpp.

Referenced by secrecyList(), and secrecyStr().

bool Incidence::recursOn const QDate &  qd  )  const
 

Returns true if the date specified is one on which the incidence will recur.

Definition at line 292 of file incidence.cpp.

References isException().

Referenced by KCal::CalendarLocal::rawEventsForDate().

bool Incidence::recursAt const QDateTime &  qdt  )  const
 

Returns true if the date/time specified is one on which the incidence will recur.

Definition at line 297 of file incidence.cpp.

References isException().

void Incidence::setResources const QStringList &  resources  ) 
 

Set resources used, such as Office, Car, etc.

Definition at line 406 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent().

QStringList Incidence::resources  )  const
 

Return list of current resources.

Definition at line 413 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent().

void Incidence::setPriority int  priority  ) 
 

Set the incidences priority, 0 is undefined, 1 highest (decreasing order).

Definition at line 419 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

int Incidence::priority  )  const
 

Return priority.

The priority is a number between 1 and 5. 1 is highest priority.

Definition at line 426 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), and KCal::VCalFormat::eventToVTodo().

const Alarm::List & Incidence::alarms  )  const
 

All alarms that are associated with this incidence.

Definition at line 477 of file incidence.cpp.

Referenced by KCal::CalendarLocal::appendAlarms(), KCal::CalendarLocal::appendRecurringAlarms(), KCal::VCalFormat::eventToVEvent(), and KCal::VCalFormat::eventToVTodo().

Alarm * Incidence::newAlarm  ) 
 

Create a new alarm which is associated with this incidence.

Definition at line 482 of file incidence.cpp.

Referenced by KCal::ResourceKABC::load(), KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

void Incidence::addAlarm Alarm  ) 
 

Add an alarm which is associated with this incidence.

Definition at line 490 of file incidence.cpp.

References KCal::IncidenceBase::updated().

void Incidence::removeAlarm Alarm  ) 
 

Remove an alarm that is associated with this incidence.

Definition at line 496 of file incidence.cpp.

References KCal::ListBase< T >::removeRef(), and KCal::IncidenceBase::updated().

void Incidence::clearAlarms  ) 
 

Remove all alarms that are associated with this incidence.

Definition at line 502 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::ResourceKABC::load().

bool Incidence::isAlarmEnabled  )  const
 

Return whether any alarm associated with this incidence is enabled.

Definition at line 508 of file incidence.cpp.

Recurrence * Incidence::recurrence  )  const
 

Return the recurrence rule associated with this incidence.

If there is none, returns an appropriate (non-0) object.

Definition at line 517 of file incidence.cpp.

References KCal::IncidenceBase::dtStart().

Referenced by KCal::CalendarLocal::appendRecurringAlarms(), KCal::VCalFormat::eventToVEvent(), KCal::ResourceKABC::load(), KCal::CalendarLocal::rawEvents(), and KCal::VCalFormat::VEventToEvent().

ushort Incidence::doesRecur  )  const
 

Forward to Recurrence::doesRecur().

Definition at line 541 of file incidence.cpp.

Referenced by KCal::CalendarLocal::alarms(), KCal::CalFilter::filterEvent(), KCal::CalendarLocal::rawEvents(), and KCal::CalendarLocal::rawEventsForDate().

void Incidence::setLocation const QString &  location  ) 
 

Set the event's/todo's location.

Do _not_ use it with journal.

Definition at line 529 of file incidence.cpp.

References KCal::IncidenceBase::updated().

Referenced by KCal::VCalFormat::VEventToEvent(), and KCal::VCalFormat::VTodoToEvent().

QString Incidence::location  )  const
 

Return the event's/todo's location.

Do _not_ use it with journal.

Definition at line 536 of file incidence.cpp.

Referenced by KCal::VCalFormat::eventToVEvent(), and KCal::VCalFormat::eventToVTodo().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for libkcal Library Version 3.2.1.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat Mar 6 17:18:04 2004 by doxygen 1.3.6-20040222 written by Dimitri van Heesch, © 1997-2003