kdecore Library API Documentation

kconfig.h

00001 /*
00002    This file is part of the KDE libraries
00003    Copyright (c) 1999 Preston Brown <pbrown@kde.org>
00004    Copyright (C) 1997 Matthias Kalle Dalheimer <kalle@kde.org>
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., 59 Temple Place - Suite 330,
00019    Boston, MA 02111-1307, USA.
00020 */
00021 
00022 // $Id: kconfig.h,v 1.63 2004/01/07 00:35:30 mueller Exp $
00023 
00024 #ifndef _KCONFIG_H
00025 #define _KCONFIG_H
00026 
00027 class QTimer;
00028 
00029 #include <qvaluelist.h>
00030 
00031 #include "ksharedptr.h"
00032 #include "kconfigbase.h"
00033 
00034 class KConfigPrivate;
00035 
00046 class KConfig : public KConfigBase
00047 {
00048   Q_OBJECT
00049 
00050 public:
00051 
00065   KConfig( const QString& fileName = QString::null,
00066           bool bReadOnly = false, bool bUseKDEGlobals = true, const char *resType="config");
00067 
00068   KConfig(KConfigBackEnd *backEnd, bool bReadOnly = false);
00069 
00076   virtual ~KConfig();
00077 
00090   virtual void rollback(bool bDeep = true);
00091 
00092 
00097   virtual QStringList groupList() const;
00098 
00110   virtual QMap<QString, QString> entryMap(const QString &pGroup) const;
00111 
00116   virtual void reparseConfiguration();
00117 
00124   void setFileWriteMode(int mode);
00125 
00132   void setForceGlobal( bool force ) { bForceGlobal = force; }
00133 
00139   bool forceGlobal() const { return bForceGlobal; }
00140 
00155   void checkUpdate(const QString &id, const QString &updateFile);
00156 
00168   KConfig* copyTo(const QString &file, KConfig *config=0) const;
00169 
00170 protected:
00171 
00178   virtual bool internalHasGroup(const QCString &group) const;
00179 
00190   virtual KEntryMap internalEntryMap(const QString &pGroup) const;
00191 
00201    virtual KEntryMap internalEntryMap() const { return aEntryMap; }
00202 
00213   virtual void putData(const KEntryKey &_key, const KEntry &_data, bool _checkGroup=true);
00214 
00223   virtual KEntry lookupData(const KEntryKey &_key) const;
00224 
00232   KEntryMap aEntryMap;
00233 
00234 private:
00239   KConfig( const KConfig& );
00244   KConfig& operator= ( const KConfig& rConfig );
00245 
00246 private:
00247   bool bGroupImmutable : 1; // Current group is immutable.
00248   bool bFileImmutable  : 1; // Current file is immutable.
00249   bool bForceGlobal    : 1; // Apply everything to kdeglobals.
00250 protected:
00251   virtual void virtual_hook( int id, void* data );
00252 private:
00253   KConfigPrivate *d;
00254 };
00255 
00256 class KSharedConfig : public KConfig, public KShared
00257 {
00258   friend class QValueList<KSharedConfig*>;
00259 public:
00260   typedef KSharedPtr<KSharedConfig> Ptr;
00261 
00262 public:  
00268   static KSharedConfig::Ptr openConfig(const QString& fileName, bool immutable = false,
00269     bool bUseKDEGlobals = true);
00270 
00271 private:
00272   KSharedConfig( const QString& fileName, bool immutable, bool useKDEGlobals );
00273   ~KSharedConfig();
00274 
00275   static QValueList<KSharedConfig*> *s_list;
00276 };
00277 
00278 #endif
KDE Logo
This file is part of the documentation for kdecore Library Version 3.2.3.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Sep 30 05:15:52 2004 by doxygen 1.3.4 written by Dimitri van Heesch, © 1997-2003