• Skip to content
  • Skip to link menu
KDE 4.3 API Reference
  • KDE API Reference
  • KDE-PIM Libraries
  • Sitemap
  • Contact Us
 

KCal Library

customproperties.cpp

Go to the documentation of this file.
00001 /*
00002   This file is part of the kcal library.
00003 
00004   Copyright (c) 2002,2006 David Jarvie <software@astrojar.org.uk>
00005 
00006   This library is free software; you can redistribute it and/or
00007   modify it under the terms of the GNU Library General Public
00008   License as published by the Free Software Foundation; either
00009   version 2 of the License, or (at your option) any later version.
00010 
00011   This library is distributed in the hope that it will be useful,
00012   but WITHOUT ANY WARRANTY; without even the implied warranty of
00013   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014   Library General Public License for more details.
00015 
00016   You should have received a copy of the GNU Library General Public License
00017   along with this library; see the file COPYING.LIB.  If not, write to
00018   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00019   Boston, MA 02110-1301, USA.
00020 */
00032 #include "customproperties.h"
00033 #include <kdebug.h>
00034 #include <QtCore/QByteArray>
00035 
00036 using namespace KCal;
00037 
00038 //@cond PRIVATE
00039 static bool checkName( const QByteArray &name );
00040 
00041 class CustomProperties::Private
00042 {
00043   public:
00044     bool operator==( const Private &other ) const;
00045     QMap<QByteArray, QString> mProperties;   // custom calendar properties
00046 };
00047 
00048 bool CustomProperties::Private::operator==( const CustomProperties::Private &other ) const
00049 {
00050   if ( mProperties.count() != other.mProperties.count() ) {
00051     return false;
00052   }
00053   for ( QMap<QByteArray, QString>::ConstIterator it = mProperties.begin();
00054         it != mProperties.end(); ++it ) {
00055     QMap<QByteArray, QString>::ConstIterator itOther =
00056                other.mProperties.find( it.key() );
00057     if ( itOther == other.mProperties.end() || itOther.value() != it.value() ) {
00058       return false;
00059     }
00060   }
00061   return true;
00062 }
00063 //@endcond
00064 
00065 CustomProperties::CustomProperties()
00066   : d( new Private )
00067 {
00068 }
00069 
00070 CustomProperties::CustomProperties( const CustomProperties &cp )
00071   : d( new Private( *cp.d ) )
00072 {
00073 }
00074 
00075 CustomProperties &CustomProperties::operator=( const CustomProperties &other )
00076 {
00077   // check for self assignment
00078   if ( &other == this ) {
00079     return *this;
00080   }
00081 
00082   *d = *other.d;
00083   return *this;
00084 }
00085 
00086 CustomProperties::~CustomProperties()
00087 {
00088   delete d;
00089 }
00090 
00091 bool CustomProperties::operator==( const CustomProperties &other ) const
00092 {
00093   return *d == *other.d;
00094 }
00095 
00096 void CustomProperties::setCustomProperty( const QByteArray &app, const QByteArray &key,
00097                                           const QString &value )
00098 {
00099   if ( value.isNull() || key.isEmpty() || app.isEmpty() ) {
00100     return;
00101   }
00102   QByteArray property = "X-KDE-" + app + '-' + key;
00103   if ( !checkName( property ) ) {
00104     return;
00105   }
00106   d->mProperties[property] = value;
00107   customPropertyUpdated();
00108 }
00109 
00110 void CustomProperties::removeCustomProperty( const QByteArray &app, const QByteArray &key )
00111 {
00112   removeNonKDECustomProperty( QByteArray( "X-KDE-" + app + '-' + key ) );
00113 }
00114 
00115 QString CustomProperties::customProperty( const QByteArray &app, const QByteArray &key ) const
00116 {
00117   return nonKDECustomProperty( QByteArray( "X-KDE-" + app + '-' + key ) );
00118 }
00119 
00120 void CustomProperties::setNonKDECustomProperty( const QByteArray &name, const QString &value )
00121 {
00122   if ( value.isNull() || !checkName( name ) ) {
00123     return;
00124   }
00125   d->mProperties[name] = value;
00126   customPropertyUpdated();
00127 }
00128 
00129 void CustomProperties::removeNonKDECustomProperty( const QByteArray &name )
00130 {
00131   if ( d->mProperties.remove( name ) ) {
00132     customPropertyUpdated();
00133   }
00134 }
00135 
00136 QString CustomProperties::nonKDECustomProperty( const QByteArray &name ) const
00137 {
00138   return d->mProperties.value( name );
00139 }
00140 
00141 void CustomProperties::setCustomProperties( const QMap<QByteArray, QString> &properties )
00142 {
00143   bool changed = false;
00144   for ( QMap<QByteArray, QString>::ConstIterator it = properties.begin();
00145         it != properties.end();  ++it ) {
00146     // Validate the property name and convert any null string to empty string
00147     if ( checkName( it.key() ) ) {
00148       d->mProperties[it.key()] = it.value().isNull() ? QString( "" ) : it.value();
00149       changed = true;
00150     }
00151   }
00152   if ( changed ) {
00153     customPropertyUpdated();
00154   }
00155 }
00156 
00157 QMap<QByteArray, QString> CustomProperties::customProperties() const
00158 {
00159   return d->mProperties;
00160 }
00161 
00162 //@cond PRIVATE
00163 bool checkName( const QByteArray &name )
00164 {
00165   // Check that the property name starts with 'X-' and contains
00166   // only the permitted characters
00167   const char *n = name;
00168   int len = name.length();
00169   if ( len < 2 ||  n[0] != 'X' || n[1] != '-' ) {
00170     return false;
00171   }
00172   for ( int i = 2;  i < len;  ++i ) {
00173     char ch = n[i];
00174     if ( ( ch >= 'A' && ch <= 'Z' ) ||
00175          ( ch >= 'a' && ch <= 'z' ) ||
00176          ( ch >= '0' && ch <= '9' ) ||
00177          ch == '-' ) {
00178       continue;
00179     }
00180     return false;   // invalid character found
00181   }
00182   return true;
00183 }
00184 //@endcond

KCal Library

Skip menu "KCal Library"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

KDE-PIM Libraries

Skip menu "KDE-PIM Libraries"
  • akonadi
  • kabc
  • kblog
  • kcal
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  • kldap
  • kmime
  • kpimidentities
  • kpimtextedit
  •   richtextbuilders
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Generated for KDE-PIM Libraries by doxygen 1.6.1
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal