Actually move the kde files that were renamed in the last commit

1 files changed, 1230 insertions, 0 deletions

diff --git a/tdecore/kconfigskeleton.h b/tdecore/kconfigskeleton.h
new file mode 100644
index 000000000..c3e9f4a57
--- /dev/null
+++ b/tdecore/kconfigskeleton.h
@@ -0,0 +1,1230 @@
+/*
+ * This file is part of KDE.
+ * 
+ * Copyright (c) 2001,2002,2003 Cornelius Schumacher <schumacher@kde.org>
+ * Copyright (c) 2003 Waldo Bastian <bastian@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 _KCONFIGSKELETON_H
+#define _KCONFIGSKELETON_H
+
+#include <tqcolor.h>
+#include <tqdatetime.h>
+#include <tqfont.h>
+#include <tqpoint.h>
+#include <tqptrlist.h>
+#include <tqdict.h>
+#include <tqrect.h>
+#include <tqsize.h>
+#include <tqstringlist.h>
+#include <tqvariant.h>
+#include <kconfig.h>
+#include <kglobalsettings.h>
+
+  /**
+   * @short Class for storing a preferences setting
+   * @author Cornelius Schumacher
+   * @see KConfigSkeleton
+   * 
+   * This class represents one preferences setting as used by @ref KConfigSkeleton.
+   * Subclasses of KConfigSkeletonItem implement storage functions for a certain type of
+   * setting. Normally you don't have to use this class directly. Use the special
+   * addItem() functions of KConfigSkeleton instead. If you subclass this class you will
+   * have to register instances with the function KConfigSkeleton::addItem().
+   */
+  class KDECORE_EXPORT KConfigSkeletonItem
+  {
+  public:
+    typedef TQValueList < KConfigSkeletonItem * >List;
+    typedef TQDict < KConfigSkeletonItem > Dict;
+    typedef TQDictIterator < KConfigSkeletonItem > DictIterator;
+
+    /**
+     * Constructor.
+     * 
+     * @param group Config file group.
+     * @param key Config file key.
+     */
+    KConfigSkeletonItem(const TQString & group, const TQString & key)
+      :mGroup(group),mKey(key), mIsImmutable(true)
+    {
+    }
+
+    /**
+     * Destructor.
+     */
+    virtual ~KConfigSkeletonItem()
+    {
+    }
+
+    /**
+     * Set config file group.
+     */
+    void setGroup( const TQString &group )
+    {
+      mGroup = group;
+    }
+
+    /**
+     * Return config file group.
+     */
+    TQString group() const
+    {
+      return mGroup;
+    }
+
+    /**
+     * Set config file key.
+     */
+    void setKey( const TQString &key )
+    {
+      mKey = key;
+    }
+    
+    /**
+     * Return config file key.
+     */
+    TQString key() const
+    {
+      return mKey;
+    }
+
+    /**
+     * Set internal name of entry.
+     */
+    void setName(const TQString &name)
+    {
+      mName = name;
+    }
+
+    /**
+     * Return internal name of entry.
+     */
+    TQString name() const
+    {
+      return mName;
+    }
+
+    /**
+      Set label providing a translated one-line description of the item.
+    */
+    void setLabel( const TQString &l )
+    {
+      mLabel = l;
+    }
+    
+    /**
+      Return label of item. See setLabel().
+    */
+    TQString label() const
+    {
+      return mLabel;
+    }
+
+    /**
+      Set WhatsThis description og item.
+    */
+    void setWhatsThis( const TQString &w )
+    {
+      mWhatsThis = w;
+    }
+    
+    /**
+      Return WhatsThis description of item. See setWhatsThis().
+    */
+    TQString whatsThis() const
+    {
+      return mWhatsThis;
+    }
+
+    /**
+     * This function is called by @ref KConfigSkeleton to read the value for this setting
+     * from a config file.
+     * value.
+     */
+    virtual void readConfig(KConfig *) = 0;
+
+    /**
+     * This function is called by @ref KConfigSkeleton to write the value of this setting
+     * to a config file.
+     */
+    virtual void writeConfig(KConfig *) = 0;
+
+    /**
+     * Read global default value.
+     */
+    virtual void readDefault(KConfig *) = 0;
+
+    /**
+     * Set item to @p p
+     */
+    virtual void setProperty(const TQVariant &p) = 0;
+    
+    /**
+     * Return item as property
+     */
+    virtual TQVariant property() const = 0;
+
+    /**
+     * Return minimum value of item or invalid if not specified
+     */
+    virtual TQVariant minValue() const { return TQVariant(); }
+
+    /**
+     * Return maximum value of item or invalid if not specified
+     */
+    virtual TQVariant maxValue() const { return TQVariant(); }
+
+    /**
+      Sets the current value to the default value.
+    */
+    virtual void setDefault() = 0;
+
+    /**
+     * Exchanges the current value with the default value
+     * Used by KConfigSkeleton::useDefaults(bool);
+     */
+    virtual void swapDefault() = 0;
+
+    /**
+     * Return if the entry can be modified.
+     */
+    bool isImmutable() const
+    {
+      return mIsImmutable;
+    }
+
+  protected:
+    /**
+     * sets mIsImmutable to true if mKey in config is immutable
+     * @param config KConfig to check if mKey is immutable in
+     */
+    void readImmutability(KConfig *config);
+
+    TQString mGroup;
+    TQString mKey;
+    TQString mName;
+
+  private:
+    bool mIsImmutable;
+
+    TQString mLabel;
+    TQString mWhatsThis;
+  };
+
+
+template < typename T > class KConfigSkeletonGenericItem:public KConfigSkeletonItem
+  {
+  public:
+    KConfigSkeletonGenericItem(const TQString & group, const TQString & key, T & reference,
+                T defaultValue)
+      : KConfigSkeletonItem(group, key), mReference(reference),
+        mDefault(defaultValue), mLoadedValue(defaultValue)
+    {
+    }
+
+    /**
+     * Set value of this KConfigSkeletonItem.
+     */
+    void setValue(const T & v)
+    {
+      mReference = v;
+    }
+
+    /**
+     * Return value of this KConfigSkeletonItem.
+     */
+    T & value()
+    {
+      return mReference;
+    }
+
+    /**
+     * Return const value of this KConfigSkeletonItem.
+     */
+    const T & value() const
+    {
+      return mReference;
+    }
+
+    /**
+      Set default value for this item.
+    */
+    virtual void setDefaultValue( const T &v )
+    {
+      mDefault = v;
+    }
+
+    virtual void setDefault()
+    {
+      mReference = mDefault;
+    }
+
+    virtual void writeConfig(KConfig * config)
+    {
+      if ( mReference != mLoadedValue ) // Is this needed?
+      {
+        config->setGroup(mGroup);
+        if ((mDefault == mReference) && !config->hasDefault( mKey))
+          config->revertToDefault( mKey );
+        else
+          config->writeEntry(mKey, mReference);
+      }
+    }
+
+    void readDefault(KConfig * config)
+    {
+      config->setReadDefaults(true);
+      readConfig(config);
+      config->setReadDefaults(false);
+      mDefault = mReference;
+    }
+
+    void swapDefault()
+    {
+      T tmp = mReference;
+      mReference = mDefault;
+      mDefault = tmp;
+    }
+
+  protected:
+    T & mReference;
+    T mDefault;
+    T mLoadedValue;
+  };
+
+  /**
+   * @short Class for handling preferences settings for an application.
+   * @author Cornelius Schumacher
+   * @see KConfigSkeletonItem
+   * 
+   * This class provides an interface to preferences settings. Preferences items
+   * can be registered by the addItem() function corresponding to the data type of
+   * the seetting. KConfigSkeleton then handles reading and writing of config files and
+   * setting of default values.
+   * 
+   * Normally you will subclass KConfigSkeleton, add data members for the preferences
+   * settings and register the members in the constructor of the subclass.
+   * 
+   * Example:
+   * \code
+   * class MyPrefs : public KConfigSkeleton
+   * {
+   *   public:
+   *     MyPrefs()
+   *     {
+   *       setCurrentGroup("MyGroup");
+   *       addItemBool("MySetting1",mMyBool,false);
+   *       addItemColor("MySetting2",mMyColor,TQColor(1,2,3));
+   * 
+   *       setCurrentGroup("MyOtherGroup");
+   *       addItemFont("MySetting3",mMyFont,TQFont("helvetica",12));
+   *     }
+   * 
+   *     bool mMyBool;
+   *     TQColor mMyColor;
+   *     TQFont mMyFont;
+   * }
+   * \endcode
+   * 
+   * It might be convenient in many cases to make this subclass of KConfigSkeleton a
+   * singleton for global access from all over the application without passing
+   * references to the KConfigSkeleton object around.
+   * 
+   * You can write the data to the configuration file by calling @ref writeConfig()
+   * and read the data from the configuration file by calling @ref readConfig().
+   * 
+   * If you have items, which are not covered by the existing addItem() functions
+   * you can add customized code for reading, writing and default setting by
+   * implementing the functions @ref usrUseDefaults(), @ref usrReadConfig() and
+   * @ref usrWriteConfig().
+   * 
+   * Internally preferences settings are stored in instances of subclasses of
+   * @ref KConfigSkeletonItem. You can also add KConfigSkeletonItem subclasses 
+   * for your own types and call the generic @ref addItem() to register them.
+   *
+   * In many cases you don't have to write the specific KConfigSkeleton
+   * subclasses yourself, but you can use \ref kconfig_compiler to automatically
+   * generate the C++ code from an XML description of the configuration options.
+   */
+class KDECORE_EXPORT KConfigSkeleton
+{
+public:
+
+  /**
+   * Class for handling a string preferences item.
+   */
+  class KDECORE_EXPORT ItemString:public KConfigSkeletonGenericItem < TQString >
+  {
+  public:
+    enum Type { Normal, Password, Path };
+
+    ItemString(const TQString & group, const TQString & key,
+               TQString & reference,
+               const TQString & defaultValue = TQString::tqfromLatin1(""), // NOT TQString::null !!
+               Type type = Normal);
+
+    void writeConfig(KConfig * config);
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+
+  private:
+    Type mType;
+  };
+
+  /**
+   * Class for handling a password preferences item.
+   */
+  class KDECORE_EXPORT ItemPassword:public ItemString
+  {
+  public:
+    ItemPassword(const TQString & group, const TQString & key,
+               TQString & reference,
+               const TQString & defaultValue = TQString::tqfromLatin1("")); // NOT TQString::null !!
+  };
+
+  /**
+   * Class for handling a path preferences item.
+   */
+  class KDECORE_EXPORT ItemPath:public ItemString
+  {
+  public:
+    ItemPath(const TQString & group, const TQString & key,
+             TQString & reference,
+             const TQString & defaultValue = TQString::null);
+  };
+
+
+  /**
+   * Class for handling a TQVariant preferences item.
+   */
+  class KDECORE_EXPORT ItemProperty:public KConfigSkeletonGenericItem < TQVariant >
+  {
+  public:
+    ItemProperty(const TQString & group, const TQString & key,
+                 TQVariant & reference, TQVariant defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a bool preferences item.
+   */
+  class KDECORE_EXPORT ItemBool:public KConfigSkeletonGenericItem < bool >
+  {
+  public:
+    ItemBool(const TQString & group, const TQString & key, bool & reference,
+             bool defaultValue = true);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling an integer preferences item.
+   */
+  class KDECORE_EXPORT ItemInt:public KConfigSkeletonGenericItem < int >
+  {
+  public:
+    ItemInt(const TQString & group, const TQString & key, int &reference,
+            int defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(int);
+    void setMaxValue(int);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    int mMin;
+    int mMax;
+  };
+
+  /**
+   * Class for handling an 64-bit integer preferences item.
+   */
+  class KDECORE_EXPORT ItemInt64:public KConfigSkeletonGenericItem < TQ_INT64 >
+  {
+  public:
+    ItemInt64(const TQString & group, const TQString & key, TQ_INT64 &reference,
+            TQ_INT64 defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(TQ_INT64);
+    void setMaxValue(TQ_INT64);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    TQ_INT64 mMin;
+    TQ_INT64 mMax;
+  };
+
+  /**
+   * Class for handling enums.
+   */
+  class KDECORE_EXPORT ItemEnum:public ItemInt
+  {
+  public:
+    struct Choice
+    {
+      TQString name;
+      TQString label;
+      TQString whatsThis;
+    };
+
+    ItemEnum(const TQString & group, const TQString & key, int &reference,
+             const TQValueList<Choice> &choices, int defaultValue = 0);
+
+    TQValueList<Choice> choices() const;
+
+    void readConfig(KConfig * config);
+    void writeConfig(KConfig * config);
+
+  private:
+      TQValueList<Choice> mChoices;
+  };
+
+
+  /**
+   * Class for handling an unsingend integer preferences item.
+   */
+  class KDECORE_EXPORT ItemUInt:public KConfigSkeletonGenericItem < unsigned int >
+  {
+  public:
+    ItemUInt(const TQString & group, const TQString & key,
+             unsigned int &reference, unsigned int defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(unsigned int);
+    void setMaxValue(unsigned int);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    unsigned int mMin;
+    unsigned int mMax;
+  };
+
+
+  /**
+   * Class for hanlding a long integer preferences item.
+   */
+  class KDECORE_EXPORT ItemLong:public KConfigSkeletonGenericItem < long >
+  {
+  public:
+    ItemLong(const TQString & group, const TQString & key, long &reference,
+             long defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(long);
+    void setMaxValue(long);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    long mMin;
+    long mMax;
+  };
+
+
+  /**
+   * Class for handling an unsigned long integer preferences item.
+   */
+  class KDECORE_EXPORT ItemULong:public KConfigSkeletonGenericItem < unsigned long >
+  {
+  public:
+    ItemULong(const TQString & group, const TQString & key,
+              unsigned long &reference, unsigned long defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(unsigned long);
+    void setMaxValue(unsigned long);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    unsigned long mMin;
+    unsigned long mMax;
+  };
+
+  /**
+   * Class for handling unsigned 64-bit integer preferences item.
+   */
+  class KDECORE_EXPORT ItemUInt64:public KConfigSkeletonGenericItem < TQ_UINT64 >
+  {
+  public:
+    ItemUInt64(const TQString & group, const TQString & key, TQ_UINT64 &reference,
+            TQ_UINT64 defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(TQ_UINT64);
+    void setMaxValue(TQ_UINT64);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    TQ_UINT64 mMin;
+    TQ_UINT64 mMax;
+  };
+
+  /**
+   * Class for handling a floating point preference item.
+   */
+  class KDECORE_EXPORT ItemDouble:public KConfigSkeletonGenericItem < double >
+  {
+  public:
+    ItemDouble(const TQString & group, const TQString & key,
+               double &reference, double defaultValue = 0);
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+    TQVariant minValue() const;
+    TQVariant maxValue() const;
+
+    void setMinValue(double);
+    void setMaxValue(double);
+    
+  private:  
+    bool mHasMin : 1;
+    bool mHasMax : 1;
+    double mMin;
+    double mMax;
+  };
+
+
+  /**
+   * Class for handling a color preferences item.
+   */
+  class KDECORE_EXPORT ItemColor:public KConfigSkeletonGenericItem < TQColor >
+  {
+  public:
+    ItemColor(const TQString & group, const TQString & key,
+              TQColor & reference,
+              const TQColor & defaultValue = TQColor(128, 128, 128));
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a font preferences item.
+   */
+  class KDECORE_EXPORT ItemFont:public KConfigSkeletonGenericItem < TQFont >
+  {
+  public:
+    ItemFont(const TQString & group, const TQString & key, TQFont & reference,
+             const TQFont & defaultValue = KGlobalSettings::generalFont());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a TQRect preferences item.
+   */
+  class KDECORE_EXPORT ItemRect:public KConfigSkeletonGenericItem < TQRect >
+  {
+  public:
+    ItemRect(const TQString & group, const TQString & key, TQRect & reference,
+             const TQRect & defaultValue = TQRect());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a TQPoint preferences item.
+   */
+  class KDECORE_EXPORT ItemPoint:public KConfigSkeletonGenericItem < TQPoint >
+  {
+  public:
+    ItemPoint(const TQString & group, const TQString & key, TQPoint & reference,
+              const TQPoint & defaultValue = TQPoint());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a TQSize preferences item.
+   */
+  class KDECORE_EXPORT ItemSize:public KConfigSkeletonGenericItem < TQSize >
+  {
+  public:
+    ItemSize(const TQString & group, const TQString & key, TQSize & reference,
+             const TQSize & defaultValue = TQSize());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a TQDateTime preferences item.
+   */
+  class KDECORE_EXPORT ItemDateTime:public KConfigSkeletonGenericItem < TQDateTime >
+  {
+  public:
+    ItemDateTime(const TQString & group, const TQString & key,
+                 TQDateTime & reference,
+                 const TQDateTime & defaultValue = TQDateTime());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a string list preferences item.
+   */
+  class KDECORE_EXPORT ItemStringList:public KConfigSkeletonGenericItem < TQStringList >
+  {
+  public:
+    ItemStringList(const TQString & group, const TQString & key,
+                   TQStringList & reference,
+                   const TQStringList & defaultValue = TQStringList());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+  /**
+   * Class for handling a path list preferences item.
+   */
+  class KDECORE_EXPORT ItemPathList:public ItemStringList
+  {
+  public:
+    ItemPathList(const TQString & group, const TQString & key,
+                   TQStringList & reference,
+                   const TQStringList & defaultValue = TQStringList());
+
+    void readConfig(KConfig * config);
+    void writeConfig(KConfig * config);
+  };
+
+
+  /**
+   * Class for handling an integer list preferences item.
+   */
+  class KDECORE_EXPORT ItemIntList:public KConfigSkeletonGenericItem < TQValueList < int > >
+  {
+  public:
+    ItemIntList(const TQString & group, const TQString & key,
+                TQValueList < int >&reference,
+                const TQValueList < int >&defaultValue = TQValueList < int >());
+
+    void readConfig(KConfig * config);
+    void setProperty(const TQVariant & p);
+    TQVariant property() const;
+  };
+
+
+public:
+  /**
+   * Constructor.
+   * 
+   * @param configname name of config file. If no name is given, the default
+   * config file as returned by kapp()->config() is used.
+   */
+  KConfigSkeleton(const TQString & configname = TQString::null);
+
+  /**
+   * Constructor.
+   * 
+   * @param config configuration object to use.
+   */
+  KConfigSkeleton(KSharedConfig::Ptr config);
+
+  /**
+   * Destructor
+   */
+    virtual ~ KConfigSkeleton();
+
+  /**
+    Set all registered items to their default values.
+  */
+  void setDefaults();
+
+  /**
+   * Read preferences from config file. All registered items are set to the
+   * values read from disk.
+   */
+  void readConfig();
+
+  /**
+   * Write preferences to config file. The values of all registered items are
+   * written to disk.
+   */
+  void writeConfig();
+
+  /**
+   * Set the config file group for subsequent addItem() calls. It is valid
+   * until setCurrentGroup() is called with a new argument. Call this before
+   * you add any items. The default value is "No Group".
+   */
+  void setCurrentGroup(const TQString & group);
+
+  /**
+   * Returns the current group used for addItem() calls. 
+   */
+  TQString currentGroup() // ### KDE 4.0: make const
+  {
+    return mCurrentGroup;
+  }
+
+  /**
+   * Register a custom @ref KConfigSkeletonItem with a given name. If the name
+   * parameter is null, take the name from KConfigSkeletonItem::key().
+   * Note that all names must be unique but that multiple entries can have
+   * the same key if they reside in different groups. 
+   */
+  void addItem(KConfigSkeletonItem *, const TQString & name = TQString::null );
+
+  /**
+   * Register an item of type TQString.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file 
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemString *addItemString(const TQString & name, TQString & reference,
+                            const TQString & defaultValue = TQString::tqfromLatin1(""), // NOT TQString::null !!
+                            const TQString & key = TQString::null);
+
+  /**
+   * Register a password item of type TQString. The string value is written 
+   * encrypted to the config file. Note that the current encryption scheme 
+   * is very weak.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemPassword *addItemPassword(const TQString & name, TQString & reference,
+                              const TQString & defaultValue = TQString::tqfromLatin1(""),
+                              const TQString & key = TQString::null);
+
+  /**
+   * Register a path item of type TQString. The string value is interpreted
+   * as a path. This means, dollar expension is activated for this value, so
+   * that e.g. $HOME gets expanded. 
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemPath *addItemPath(const TQString & name, TQString & reference,
+                          const TQString & defaultValue = TQString::tqfromLatin1(""),
+                          const TQString & key = TQString::null);
+
+  /**
+   * Register a property item of type TQVariant. Note that only the following
+   * TQVariant types are allowed: String, StringList, Font, Point, Rect, Size,
+   * Color, Int, UInt, Bool, Double, DateTime and Date.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemProperty *addItemProperty(const TQString & name, TQVariant & reference,
+                                const TQVariant & defaultValue = TQVariant(),
+                                const TQString & key = TQString::null);
+  /**
+   * Register an item of type bool.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemBool *addItemBool(const TQString & name, bool & reference,
+                        bool defaultValue = false,
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type int.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemInt *addItemInt(const TQString & name, int &reference, int defaultValue = 0,
+                      const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type unsigned int.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemUInt *addItemUInt(const TQString & name, unsigned int &reference,
+                        unsigned int defaultValue = 0,
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type long.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemLong *addItemLong(const TQString & name, long &reference,
+                        long defaultValue = 0,
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type unsigned long.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemULong *addItemULong(const TQString & name, unsigned long &reference,
+                          unsigned long defaultValue = 0,
+                          const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQ_INT64.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemInt64 *addItemInt64(const TQString & name, TQ_INT64 &reference,
+                          TQ_INT64 defaultValue = 0,
+                          const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQ_UINT64
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemUInt64 *addItemUInt64(const TQString & name, TQ_UINT64 &reference,
+                            TQ_UINT64 defaultValue = 0,
+                            const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type double.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemDouble *addItemDouble(const TQString & name, double &reference,
+                            double defaultValue = 0.0,
+                            const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQColor.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemColor *addItemColor(const TQString & name, TQColor & reference,
+                          const TQColor & defaultValue = TQColor(128, 128, 128),
+                          const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQFont.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemFont *addItemFont(const TQString & name, TQFont & reference,
+                        const TQFont & defaultValue =
+                        KGlobalSettings::generalFont(),
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQRect.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemRect *addItemRect(const TQString & name, TQRect & reference,
+                        const TQRect & defaultValue = TQRect(),
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQPoint.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemPoint *addItemPoint(const TQString & name, TQPoint & reference,
+                          const TQPoint & defaultValue = TQPoint(),
+                          const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQSize.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemSize *addItemSize(const TQString & name, TQSize & reference,
+                        const TQSize & defaultValue = TQSize(),
+                        const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQDateTime.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemDateTime *addItemDateTime(const TQString & name, TQDateTime & reference,
+                                const TQDateTime & defaultValue = TQDateTime(),
+                                const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQStringList.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemStringList *addItemStringList(const TQString & name, TQStringList & reference,
+                                    const TQStringList & defaultValue = TQStringList(),
+                                    const TQString & key = TQString::null);
+
+  /**
+   * Register an item of type TQValueList<int>.
+   * 
+   * @param name Name used to indentify this setting. Names must be unique.
+   * @param reference Pointer to the variable, which is set by readConfig()
+   * calls and read by writeConfig() calls.
+   * @param defaultValue Default value, which is used when the config file
+   * does not yet contain the key of this item.
+   * @param key Key used in config file. If key is null, name is used as key.
+   * @return The created item
+   */
+  ItemIntList *addItemIntList(const TQString & name, TQValueList < int >&reference,
+                              const TQValueList < int >&defaultValue =
+                              TQValueList < int >(),
+                              const TQString & key = TQString::null);
+
+  /**
+   * Return the @ref KConfig object used for reading and writing the settings.
+   */
+  KConfig *config() const;
+
+  /**
+   * Return list of items managed by this KConfigSkeleton object.
+   */
+  KConfigSkeletonItem::List items() const
+  {
+    return mItems;
+  }
+
+  /**
+   * Return whether a certain item is immutable
+   */
+  bool isImmutable(const TQString & name);
+
+  /**
+   * Lookup item by name
+   */
+  KConfigSkeletonItem * findItem(const TQString & name);
+
+  /**
+   * Indicate whether this object should reflect the actual
+   * values or the default values.
+   * @param b If true this object reflects the default values.
+   * @return The state prior to this call
+   */
+  bool useDefaults(bool b);
+
+protected:
+  /**
+   * Implemented by subclasses that use special defaults.
+   * It should replace the default values with the actual
+   * values and vice versa.
+   */
+  virtual void usrUseDefaults(bool)
+  {
+  }
+
+  virtual void usrSetDefaults()
+  {
+  }
+
+  /**
+   * Implemented by subclasses that read special config values.
+   */
+  virtual void usrReadConfig()
+  {
+  }
+
+  /**
+   * Implemented by subclasses that write special config values.
+   */
+  virtual void usrWriteConfig()
+  {
+  }
+
+private:
+  TQString mCurrentGroup;
+
+  KSharedConfig::Ptr mConfig; // pointer to KConfig object
+
+  KConfigSkeletonItem::List mItems;
+  KConfigSkeletonItem::Dict mItemDict;
+  
+  bool mUseDefaults;
+
+  class Private;
+  Private *d;
+
+};
+
+#endif