vcalformat.h

Go to the documentation of this file.

/*
  This file is part of the kcalcore library.

  Copyright (c) 1998 Preston Brown <pbrown@kde.org>
  Copyright (c) 2001-2003 Cornelius Schumacher <schumacher@kde.org>

  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_VCALFORMAT_H
#define KCALCORE_VCALFORMAT_H

#include "kcalcore_export.h"
#include "attendee.h"
#include "calformat.h"
#include "event.h"
#include "todo.h"
#include "journal.h"

struct VObject;

class KDateTime;

class QDate;

#define _VCAL_VERSION "1.0"

namespace KCalCore {

class Event;
class Todo;

class KCALCORE_EXPORT VCalFormat : public CalFormat
{
public:
    VCalFormat();

    virtual ~VCalFormat();

    bool load(const Calendar::Ptr &calendar, const QString &fileName);

    bool save(const Calendar::Ptr &calendar, const QString &fileName);

    bool fromString(const Calendar::Ptr &calendar, const QString &string,
                    bool deleted = false, const QString &notebook = QString());

    QString toString(const Calendar::Ptr &calendar, const QString &notebook = QString(),
                     bool deleted = false);

    bool fromRawString(const Calendar::Ptr &calendar, const QByteArray &string,
                       bool deleted = false, const QString &notebook = QString());

protected:
    Todo::Ptr VTodoToEvent(VObject *vtodo);

    Event::Ptr VEventToEvent(VObject *vevent);

    VObject *eventToVEvent(const Event::Ptr &event);

    QString parseTZ(const QByteArray &timezone) const;

    QString parseDst(QByteArray &timezone) const;

    VObject *eventToVTodo(const Todo::Ptr &todo);

    QString qDateToISO(const QDate &date);

    QString kDateTimeToISO(const KDateTime &date, bool zulu = true);

    KDateTime ISOToKDateTime(const QString &dtStr);

    QDate ISOToQDate(const QString &dtStr);

    bool parseTZOffsetISO8601(const QString &s, int &result);

    void populate(VObject *vcal, bool deleted = false, const QString &notebook = QString());

    const char *dayFromNum(int day);

    int numFromDay(const QString &day);

    Attendee::PartStat readStatus(const char *s) const;

    QByteArray writeStatus(Attendee::PartStat status) const;

    void readCustomProperties(VObject *o, const Incidence::Ptr &i);
    void writeCustomProperties(VObject *o, const Incidence::Ptr &i);

protected:
    virtual void virtual_hook(int id, void *data);

private:
    enum PilotState {
        SYNCNONE = 0,
        SYNCMOD = 1,
        SYNCDEL = 3
    };

    //@cond PRIVATE
    Q_DISABLE_COPY(VCalFormat)
    class Private;
    Private *const d;
    //@endcond
};

}

#endif