icalformat_p.h

Go to the documentation of this file.

/*
  This file is part of the kcalcore library.
 
  Copyright (c) 2001-2003 Cornelius Schumacher <schumacher@kde.org>
  Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
  Copyright (c) 2006 David Jarvie <software@astrojar.org.uk>
  Copyright (C) 2012  Christian Mollekopf <mollekopf@kolabsys.com>
 
  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 KCALCORE_ICALFORMAT_P_H
#define KCALCORE_ICALFORMAT_P_H
 
#include "exceptions.h"
#include "freebusy.h"
#include "todo.h"
#include "journal.h"
#include "event.h"
#include "person.h"
#include "calendar.h"
#include "schedulemessage.h"
 
#include <KDateTime>
 
#include <libical/ical.h>
 
class QDate;
 
namespace KCalCore {
 
class Alarm;
class Attachment;
class Attendee;
class Duration;
class Event;
class FreeBusy;
class ICalFormat;
class ICalTimeZones;
class Incidence;
class Journal;
class Recurrence;
class RecurrenceRule;
class Todo;
 
#define _ICAL_VERSION "2.0"
 
#define _ICAL_IMPLEMENTATION_VERSION "1.0"
 
class ICalFormatImpl
{
public:
    explicit ICalFormatImpl(ICalFormat *parent);
 
    virtual ~ICalFormatImpl();
 
    bool populate(const Calendar::Ptr &calendar, icalcomponent *fs,
                  bool deleted = false, const QString &notebook = QString());
 
    icalcomponent *writeIncidence(const IncidenceBase::Ptr &incidence,
                                  iTIPMethod method = iTIPRequest,
                                  ICalTimeZones *tzList = 0,
                                  ICalTimeZones *tzUsedList = 0);
 
    icalcomponent *writeTodo(const Todo::Ptr &todo, ICalTimeZones *tzlist = 0,
                             ICalTimeZones *tzUsedList = 0);
 
    icalcomponent *writeEvent(const Event::Ptr &event, ICalTimeZones *tzlist = 0,
                              ICalTimeZones *tzUsedList = 0);
 
    icalcomponent *writeJournal(const Journal::Ptr &journal, ICalTimeZones *tzlist = 0,
                                ICalTimeZones *tzUsedList = 0);
 
    icalcomponent *writeFreeBusy(const FreeBusy::Ptr &freebusy,
                                 iTIPMethod method = iTIPPublish);
 
    void writeIncidence(icalcomponent *parent, const Incidence::Ptr &incidence,
                        ICalTimeZones *tzlist = 0, ICalTimeZones *tzUsedList = 0);
 
    icalproperty *writeDescription(const QString &description, bool isRich = false);
    icalproperty *writeSummary(const QString &summary, bool isRich = false);
    icalproperty *writeLocation(const QString &location, bool isRich = false);
    icalproperty *writeAttendee(const Attendee::Ptr &attendee);
    icalproperty *writeOrganizer(const Person::Ptr &organizer);
    icalproperty *writeAttachment(const Attachment::Ptr &attach);
    icalproperty *writeRecurrenceRule(Recurrence *);
    icalrecurrencetype writeRecurrenceRule(RecurrenceRule *recur);
    icalcomponent *writeAlarm(const Alarm::Ptr &alarm);
 
    QString extractErrorProperty(icalcomponent *);
    Todo::Ptr readTodo(icalcomponent *vtodo, ICalTimeZones *tzlist);
    Event::Ptr readEvent(icalcomponent *vevent, ICalTimeZones *tzlist);
    FreeBusy::Ptr readFreeBusy(icalcomponent *vfreebusy);
    Journal::Ptr readJournal(icalcomponent *vjournal, ICalTimeZones *tzlist);
    Attendee::Ptr readAttendee(icalproperty *attendee);
    Person::Ptr readOrganizer(icalproperty *organizer);
    Attachment::Ptr readAttachment(icalproperty *attach);
    void readIncidence(icalcomponent *parent, Incidence::Ptr incidence,
                       ICalTimeZones *tzlist);
    void readRecurrenceRule(icalproperty *rrule, Incidence::Ptr event);
    void readExceptionRule(icalproperty *rrule, Incidence::Ptr incidence);
    void readRecurrence(const struct icalrecurrencetype &r,
                        RecurrenceRule *recur);
    void readAlarm(icalcomponent *alarm, Incidence::Ptr incidence,
                   ICalTimeZones *tzlist);
 
    QString loadedProductId() const;
 
    static icaltimetype writeICalDate(const QDate &);
 
    static QDate readICalDate(icaltimetype);
 
    static icaltimetype writeICalDateTime(const KDateTime &);
 
    static icaltimetype writeICalUtcDateTime(const KDateTime &);
 
    static icalproperty *writeICalDateTimeProperty(const icalproperty_kind kind,
            const KDateTime &dt,
            ICalTimeZones *tzlist = 0,
            ICalTimeZones *tzUsedList = 0);
 
    static KDateTime readICalDateTime(icalproperty *p, const icaltimetype &t,
                                      ICalTimeZones *tzlist, bool utc = false);
 
    static KDateTime readICalUtcDateTime(icalproperty *p, icaltimetype &t,
                                         ICalTimeZones *tzlist = 0)
    //TODO: KDE5, move this implementation to icalformat_p.cpp
    {
        return readICalDateTime(p, t, tzlist, true);
    }
 
    static KDateTime readICalDateTimeProperty(icalproperty *p,
            ICalTimeZones *tzlist, bool utc = false);
 
    static KDateTime readICalUtcDateTimeProperty(icalproperty *p)
    {
        return readICalDateTimeProperty(p, 0, true);
    }
 
    static icaldurationtype writeICalDuration(const Duration &duration);
 
    static Duration readICalDuration(icaldurationtype d);
 
    static icaldatetimeperiodtype writeICalDatePeriod(const QDate &date);
 
    icalcomponent *createCalendarComponent(const Calendar::Ptr &calendar = Calendar::Ptr());
 
    icalcomponent *createScheduleComponent(const IncidenceBase::Ptr &incidence,
                                           iTIPMethod method);
 
protected:
    // void dumpIcalRecurrence( const icalrecurrencetype &r );
 
private:
    //@cond PRIVATE
    class Private;
    Private *const d;
    //@endcond
};
 
}
 
#endif