icalformat_p.h

Go to the documentation of this file.

/*
  This file is part of the kcal 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>

  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 KCAL_ICALFORMAT_P_H
#define KCAL_ICALFORMAT_P_H

#include "freebusy.h"
#include "scheduler.h"

#include <libical/ical.h>

#include <kdatetime.h>

#include <QtCore/QString>
#include <QtCore/QList>

namespace KCal {

class Alarm;
class Attachment;
class Incidence;
class ICalTimeZones;
class Recurrence;
class RecurrenceRule;

#define _ICAL_VERSION "2.0"

class ICalFormatImpl
{
  public:
    explicit ICalFormatImpl( ICalFormat *parent );

    virtual ~ICalFormatImpl();

    bool populate( Calendar *calendar, icalcomponent *fs );

    icalcomponent *writeIncidence( IncidenceBase *incidence,
                                   iTIPMethod method = iTIPRequest );

    icalcomponent *writeTodo( Todo *todo, ICalTimeZones *tzlist = 0,
                              ICalTimeZones *tzUsedList = 0 );

    icalcomponent *writeEvent( Event *event, ICalTimeZones *tzlist = 0,
                               ICalTimeZones *tzUsedList = 0 );

    icalcomponent *writeFreeBusy( FreeBusy *freebusy,
                                  iTIPMethod method = iTIPPublish );

    icalcomponent *writeJournal( Journal *journal, ICalTimeZones *tzlist = 0,
                                 ICalTimeZones *tzUsedList = 0 );

    void writeIncidence( icalcomponent *parent, Incidence *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( Attendee *attendee );
    icalproperty *writeOrganizer( const Person &organizer );
    icalproperty *writeAttachment( Attachment *attach );
    icalproperty *writeRecurrenceRule( Recurrence * );
    icalrecurrencetype writeRecurrenceRule( RecurrenceRule *recur );
    icalcomponent *writeAlarm( Alarm *alarm );

    QString extractErrorProperty( icalcomponent * );
    Todo *readTodo( icalcomponent *vtodo, ICalTimeZones *tzlist );
    Event *readEvent( icalcomponent *vevent, ICalTimeZones *tzlist );
    FreeBusy *readFreeBusy( icalcomponent *vfreebusy );
    Journal *readJournal( icalcomponent *vjournal, ICalTimeZones *tzlist );
    Attendee *readAttendee( icalproperty *attendee );
    Person readOrganizer( icalproperty *organizer );
    Attachment *readAttachment( icalproperty *attach );
    void readIncidence( icalcomponent *parent, Incidence *incidence,
                        ICalTimeZones *tzlist );
    void readRecurrenceRule( icalproperty *rrule, Incidence *event );
    void readExceptionRule( icalproperty *rrule, Incidence *incidence );
    void readRecurrence( const struct icalrecurrencetype &r,
                         RecurrenceRule *recur );
    void readAlarm( icalcomponent *alarm, Incidence *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 )
    { 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( Calendar *calendar = 0 );

    icalcomponent *createScheduleComponent( IncidenceBase *incidence,
                                            iTIPMethod method );

  protected:
    void dumpIcalRecurrence( icalrecurrencetype r );

  private:
    //@cond PRIVATE
    class Private;
    Private *const d;
    //@endcond
};

}

#endif