vcardconverter.h

00001 /*
00002     This file is part of libkabc.
00003     Copyright (c) 2002 Tobias Koenig <tokoe@kde.org>
00004 
00005     This library is free software; you can redistribute it and/or
00006     modify it under the terms of the GNU Library General Public
00007     License as published by the Free Software Foundation; either
00008     version 2 of the License, or (at your option) any later version.
00009 
00010     This library is distributed in the hope that it will be useful,
00011     but WITHOUT ANY WARRANTY; without even the implied warranty of
00012     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013     Library General Public License for more details.
00014 
00015     You should have received a copy of the GNU Library General Public License
00016     along with this library; see the file COPYING.LIB.  If not, write to
00017     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00018     Boston, MA 02110-1301, USA.
00019 */
00020 
00021 #ifndef KABC_VCARDCONVERTER_H
00022 #define KABC_VCARDCONVERTER_H
00023 
00024 #include "kabc_export.h"
00025 #include "addressee.h"
00026 #include <QtCore/QString>
00027 
00028 namespace KABC {
00029 
00053 class KABC_EXPORT VCardConverter
00054 {
00055   public:
00056 
00061     enum Version {
00062       v2_1,
00063       v3_0
00064     };
00065 
00069     VCardConverter();
00070 
00074     ~VCardConverter();
00075 
00083     QByteArray createVCard( const Addressee &addr, Version version = v3_0 ) const;
00084 
00092     // FIXME: Add error handling
00093     QByteArray createVCards( Addressee::List list, Version version = v3_0 ) const;
00094 
00095     // FIXME: Add "createVCards( AddressBook * )"
00096 
00100     Addressee parseVCard( const QByteArray &vcard ) const;
00101 
00105     // FIXME: Add error handling
00106     Addressee::List parseVCards( const QByteArray &vcard ) const;
00107 
00108   private:
00109     class VCardConverterPrivate;
00110     VCardConverterPrivate *const d;
00111 };
00112 
00122 KABC_EXPORT QString dateToVCardString( const QDateTime &dateTime );
00123 
00129 KABC_EXPORT QString dateToVCardString( const QDate &date );
00130 
00137 KABC_EXPORT QDateTime VCardStringToDate( const QString &dateString );
00138 
00139 }
00140 #endif
KDE Home | KDE Accessibility Home | Description of Access Keys