libkcal Library API Documentation

KCal::VCalFormat Class Reference

This class implements the vCalendar format. vCalendar format implementation. More...

#include <vcalformat.h>

Inheritance diagram for KCal::VCalFormat:

KCal::CalFormat List of all members.

Public Methods

 VCalFormat ()
virtual ~VCalFormat ()
bool load (Calendar *calendar, const QString &fileName)
bool save (Calendar *, const QString &fileName)
bool fromString (Calendar *, const QString &)
QString toString (Calendar *)

Protected Methods

TodoVTodoToEvent (VObject *vtodo)
EventVEventToEvent (VObject *vevent)
VObject * eventToVTodo (const Todo *anEvent)
VObject * eventToVEvent (const Event *anEvent)
QString qDateToISO (const QDate &)
QString qDateTimeToISO (const QDateTime &, bool zulu=TRUE)
QDateTime ISOToQDateTime (const QString &dtStr)
QDate ISOToQDate (const QString &dtStr)
void populate (VObject *vcal)
const char * dayFromNum (int day)
int numFromDay (const QString &day)
Attendee::PartStat readStatus (const char *s) const
QCString writeStatus (Attendee::PartStat status) const

Detailed Description

This class implements the vCalendar format. vCalendar format implementation.

It provides methods for loading/saving/converting vCalendar format data into the internal KOrganizer representation as Calendar and Events.

Definition at line 43 of file vcalformat.h.


Member Function Documentation

bool VCalFormat::load Calendar   calendar,
const QString   fileName
[virtual]
 

Loads a calendar on disk in vCalendar format into the given calendar.

Parameters:
calendar  Calendar object the loaded data is stored into.
fileName  Name of the vCalendar file on disk.
Returns:
true on success, otherwise false

Implements KCal::CalFormat.

Definition at line 57 of file vcalformat.cpp.

References KCal::CalFormat::clearException(), QFile::encodeName(), populate(), and KCal::CalFormat::setException().

bool VCalFormat::save Calendar  ,
const QString   fileName
[virtual]
 

Writes out the given calendar to disk in vCalendar format.

Parameters:
calendar  Calendar object holding data to be written
fileName  the name of the file
Returns:
true on success, otherwise false

Implements KCal::CalFormat.

Definition at line 89 of file vcalformat.cpp.

References QFile::encodeName(), eventToVEvent(), eventToVTodo(), QFile::exists(), KCal::CalFormat::productId(), KCal::Calendar::rawEvents(), and KCal::Calendar::rawTodos().

bool VCalFormat::fromString Calendar  ,
const QString  
[virtual]
 

Parse string and populate calendar with that information.

Implements KCal::CalFormat.

Definition at line 135 of file vcalformat.cpp.

References KCal::Calendar::addEvent(), QString::utf8(), and VEventToEvent().

Referenced by KCal::VCalDrag::decode().

QString VCalFormat::toString Calendar   [virtual]
 

Return calendar information as string.

Implements KCal::CalFormat.

Definition at line 170 of file vcalformat.cpp.

References KCal::Calendar::events(), and eventToVEvent().

Referenced by KCal::VCalDrag::VCalDrag().

Todo * VCalFormat::VTodoToEvent VObject *    vtodo [protected]
 

translates a VObject of the TODO type into a Event.

Definition at line 652 of file vcalformat.cpp.

References KCal::IncidenceBase::addAttendee(), QDate::currentDate(), QTime::currentTime(), QFile::decodeName(), QString::find(), QString::findRev(), QString::fromLocal8Bit(), KCal::Calendar::getEmail(), ISOToQDateTime(), QString::left(), QString::length(), QString::mid(), KCal::Incidence::newAlarm(), QString::replace(), KCal::Alarm::setAudioAlarm(), KCal::Incidence::setCategories(), KCal::Todo::setCompleted(), KCal::Incidence::setCreated(), KCal::Incidence::setDescription(), KCal::Todo::setDtDue(), KCal::Incidence::setDtStart(), KCal::Alarm::setEnabled(), KCal::Todo::setHasDueDate(), KCal::Todo::setHasStartDate(), KCal::IncidenceBase::setLastModified(), KCal::Incidence::setLocation(), KCal::IncidenceBase::setOrganizer(), KCal::IncidenceBase::setPilotId(), KCal::Incidence::setPriority(), KCal::Alarm::setProcedureAlarm(), KCal::Incidence::setRelatedToUid(), KCal::Attendee::setRSVP(), KCal::Attendee::setStatus(), KCal::Incidence::setSummary(), KCal::IncidenceBase::setSyncStatus(), KCal::Alarm::setTime(), KCal::IncidenceBase::setUid(), and QString::simplifyWhiteSpace().

Referenced by populate().

Event * VCalFormat::VEventToEvent VObject *    vevent [protected]
 

translates a VObject into a Event and returns a pointer to it.

Definition at line 870 of file vcalformat.cpp.

References KCal::Incidence::addAttachment(), KCal::IncidenceBase::addAttendee(), KCal::Incidence::addExDate(), KCal::Recurrence::addMonthlyDay(), KCal::Recurrence::addMonthlyPos(), KCal::Recurrence::addYearlyNum(), QDate::currentDate(), QTime::currentTime(), QDateTime::date(), QFile::decodeName(), KCal::Incidence::description(), QBitArray::detach(), KCal::Event::dtEnd(), KCal::IncidenceBase::dtStart(), QBitArray::fill(), QString::find(), QString::findRev(), QString::fromLocal8Bit(), KCal::Calendar::getEmail(), QString::isEmpty(), ISOToQDate(), ISOToQDateTime(), QString::left(), QString::length(), QString::mid(), KCal::Incidence::newAlarm(), numFromDay(), KCal::Incidence::recurrence(), QString::replace(), KCal::Alarm::setAudioAlarm(), QBitArray::setBit(), KCal::Incidence::setCategories(), KCal::Incidence::setCreated(), KCal::Recurrence::setDaily(), KCal::Incidence::setDescription(), KCal::Event::setDtEnd(), KCal::Incidence::setDtStart(), KCal::Alarm::setEnabled(), KCal::IncidenceBase::setFloats(), KCal::IncidenceBase::setLastModified(), KCal::Incidence::setLocation(), KCal::Recurrence::setMonthly(), KCal::IncidenceBase::setOrganizer(), KCal::IncidenceBase::setPilotId(), KCal::Incidence::setPriority(), KCal::Alarm::setProcedureAlarm(), KCal::Incidence::setRelatedToUid(), KCal::Incidence::setResources(), KCal::Incidence::setRevision(), KCal::Attendee::setRSVP(), KCal::Incidence::setSecrecy(), KCal::Attendee::setStatus(), KCal::Incidence::setSummary(), KCal::IncidenceBase::setSyncStatus(), KCal::Alarm::setTime(), KCal::Event::setTransparency(), KCal::IncidenceBase::setUid(), KCal::Recurrence::setWeekly(), KCal::Recurrence::setYearly(), QString::simplifyWhiteSpace(), QStringList::split(), KCal::Incidence::summary(), QDateTime::time(), and QString::upper().

Referenced by fromString(), and populate().

VObject * VCalFormat::eventToVTodo const Todo   anEvent [protected]
 

translate a Event into a VTodo-type VObject and return pointer.

Definition at line 197 of file vcalformat.cpp.

References KCal::Incidence::alarms(), KCal::IncidenceBase::attendeeCount(), KCal::IncidenceBase::attendees(), KCal::Alarm::audioFile(), KCal::Incidence::categories(), KCal::Todo::completed(), KCal::Incidence::created(), KCal::Incidence::description(), KCal::IncidenceBase::doesFloat(), KCal::Todo::dtDue(), KCal::IncidenceBase::dtStart(), KCal::Person::email(), KCal::Alarm::enabled(), QFile::encodeName(), QString::find(), KCal::Todo::hasCompletedDate(), KCal::Todo::hasDueDate(), KCal::Todo::hasStartDate(), KCal::Todo::isCompleted(), QString::isEmpty(), KCal::IncidenceBase::lastModified(), QString::length(), QString::local8Bit(), KCal::Incidence::location(), QString::mid(), KCal::Person::name(), KCal::IncidenceBase::organizer(), KCal::IncidenceBase::pilotId(), KCal::Incidence::priority(), KCal::Alarm::programFile(), qDateTimeToISO(), KCal::Incidence::relatedTo(), KCal::Incidence::revision(), KCal::Attendee::RSVP(), QString::sprintf(), KCal::Attendee::status(), KCal::Incidence::summary(), KCal::IncidenceBase::syncStatus(), KCal::Alarm::time(), QString::truncate(), KCal::Alarm::type(), and KCal::IncidenceBase::uid().

Referenced by save().

VObject * VCalFormat::eventToVEvent const Event   anEvent [protected]
 

translate a Event into a VObject and returns a pointer to it.

Definition at line 359 of file vcalformat.cpp.

References KCal::Incidence::alarms(), KCal::Incidence::attachments(), KCal::IncidenceBase::attendeeCount(), KCal::IncidenceBase::attendees(), KCal::Alarm::audioFile(), QValueList< QDate >::begin(), KCal::Incidence::categories(), KCal::Incidence::created(), dayFromNum(), KCal::Recurrence::days(), KCal::Incidence::description(), KCal::IncidenceBase::doesFloat(), KCal::Recurrence::doesRecur(), KCal::Event::dtEnd(), KCal::IncidenceBase::dtStart(), KCal::Recurrence::duration(), KCal::Person::email(), KCal::Alarm::enabled(), QFile::encodeName(), QValueList< QDate >::end(), KCal::Recurrence::endDate(), KCal::Incidence::exDates(), QString::find(), QPtrList::first(), KCal::Recurrence::frequency(), QString::isEmpty(), QStringList::join(), KCal::IncidenceBase::lastModified(), QString::length(), QString::local8Bit(), KCal::Incidence::location(), QString::mid(), KCal::Recurrence::monthDays(), KCal::Recurrence::monthPositions(), KCal::Person::name(), KCal::Recurrence::rMonthPos::negative, QPtrList::next(), KCal::IncidenceBase::organizer(), KCal::IncidenceBase::pilotId(), KCal::Incidence::priority(), KCal::Alarm::programFile(), qDateTimeToISO(), qDateToISO(), KCal::Recurrence::rMonthPos::rDays, KCal::Incidence::recurrence(), KCal::Incidence::relatedTo(), KCal::Incidence::resources(), KCal::Incidence::revision(), KCal::Recurrence::rMonthPos::rPos, KCal::Attendee::RSVP(), KCal::Incidence::secrecy(), QString::sprintf(), KCal::Attendee::status(), KCal::Incidence::summary(), KCal::IncidenceBase::syncStatus(), QBitArray::testBit(), KCal::Alarm::time(), KCal::Event::transparency(), QString::truncate(), KCal::Alarm::type(), KCal::IncidenceBase::uid(), and KCal::Recurrence::yearNums().

Referenced by save(), and toString().

QString VCalFormat::qDateToISO const QDate   [protected]
 

takes a QDate and returns a string in the format YYYYMMDDTHHMMSS.

Definition at line 1399 of file vcalformat.cpp.

References QDate::day(), QDate::isValid(), QDate::month(), QString::sprintf(), and QDate::year().

Referenced by eventToVEvent().

QString VCalFormat::qDateTimeToISO const QDateTime  ,
bool    zulu = TRUE
[protected]
 

takes a QDateTime and returns a string in format YYYYMMDDTHHMMSS.

Definition at line 1419 of file vcalformat.cpp.

References QDateTime::addSecs(), QDateTime::date(), QString::sprintf(), QDateTime::time(), and KCal::Calendar::timeZoneId().

Referenced by eventToVEvent(), and eventToVTodo().

QDateTime VCalFormat::ISOToQDateTime const QString   dtStr [protected]
 

takes a string in the format YYYYMMDDTHHMMSS and returns a valid QDateTime.

Definition at line 1442 of file vcalformat.cpp.

References QDateTime::addSecs(), QString::at(), QTime::isValid(), QDate::isValid(), QString::left(), QString::length(), QString::mid(), QTime::setHMS(), QDate::setYMD(), and KCal::Calendar::timeZoneId().

Referenced by VEventToEvent(), and VTodoToEvent().

QDate VCalFormat::ISOToQDate const QString   dtStr [protected]
 

takes a string in the format YYYYMMDD and returns a valid QDate.

Definition at line 1469 of file vcalformat.cpp.

References QString::left(), and QString::mid().

Referenced by VEventToEvent().

void VCalFormat::populate VObject *    vcal [protected]
 

takes a vCalendar tree of VObjects, and puts all of them that have the "event" property into the dictionary, todos in the todo-list, etc.

Definition at line 1483 of file vcalformat.cpp.

References KCal::Calendar::addEvent(), KCal::Calendar::addTodo(), KCal::Event::dtEnd(), KCal::IncidenceBase::dtStart(), KCal::Calendar::event(), QDateTime::isValid(), KCal::CalFormat::productId(), KCal::Calendar::todo(), VEventToEvent(), and VTodoToEvent().

Referenced by load().

const char * VCalFormat::dayFromNum int    day [protected]
 

takes a number 0 - 6 and returns the two letter string of that day, i.e.

MO, TU, WE, etc.

Definition at line 1618 of file vcalformat.cpp.

Referenced by eventToVEvent().

int VCalFormat::numFromDay const QString   day [protected]
 

the reverse of the above function.

Definition at line 1625 of file vcalformat.cpp.

Referenced by VEventToEvent().


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.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat May 1 11:36:25 2004 by doxygen 1.2.15 written by Dimitri van Heesch, © 1997-2003