#ifndef _KVI_CONFIG_H_INCLUDED_
#define _KVI_CONFIG_H_INCLUDED_

//=============================================================================
//
//   File : kvi_config.h (/usr/build/NEW_kvirc/kvirc/kvilib/kvi_config.h)
//   Last major modification : Thu Jan 14 1999 18:01:22 by Szymon Stefanek
//
//   This file is part of the KVirc irc client distribution
//   Copyright (C) 1999-2000 Szymon Stefanek (pragma at kvirc dot net)
//
//   This program is FREE software. You can redistribute it and/or
//   modify it under the terms of the GNU General Public License
//   as published by the Free Software Foundation; either version 2
//   of the License, or (at your opinion) any later version.
//
//   This program 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 General Public License for more details.
//
//   You should have received a copy of the GNU General Public License
//   along with this program. If not, write to the Free Software Foundation,
//   Inc. ,59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
//
//=============================================================================

#include "kvi_string.h"
#include "kvi_settings.h"
#include "kvi_heapobject.h"

#include <qdict.h>
#include <qcolor.h>
#include <qfont.h>
#include <qrect.h>
#include <qstringlist.h>
#include <qvaluelist.h>

#define KVI_CONFIG_DEFAULT_GROUP "KVIrc"

class KviPixmap;
class KviMsgType;

typedef QDict<QString> KviConfigGroup;
typedef QDictIterator<QString> KviConfigGroupIterator;
typedef QDictIterator<KviConfigGroup> KviConfigIterator;

class KVILIB_API KviConfig : public KviHeapObject
{
public:
	enum FileMode { Read = 1 , Write = 2 , ReadWrite = 3 };
public:
	KviConfig(const QString &filename,FileMode f/* = ReadWrite*/);
	~KviConfig();
private:
	QDict<KviConfigGroup>      * m_pDict;
	QString                      m_szFileName;
	bool                         m_bDirty;
	QString                      m_szStrBuffer;
	QString                      m_szGroup;
	bool                         m_bPreserveEmptyGroups;
	bool                         m_bReadOnly;
private:
	bool load();
	bool save();
	KviConfigGroup * getCurrentGroup();
public:
	//
	// Useful when saving...
	// Normally this class does not save empty groups
	// and setGroup() is never a config modification.
	// If the group is not existing it will be effectively
	// created only at the first attempt to read from it or write to it.
	// With this flag set to true the KviConfig class will
	// write down also the empty groups , and calls to setGroup()
	// will create the groups if not existing yet (and set the config data
	// as modified).
	//
	void preserveEmptyGroups(bool bPreserve){ m_bPreserveEmptyGroups = bPreserve; };
	const QString & fileName(){ return m_szFileName; };
	bool readOnly(){ return m_bReadOnly; };
	void setReadOnly(bool bReadOnly){ m_bReadOnly = bReadOnly; };
	bool dirty(){ return m_bDirty; };
	//
	// This sets the save path for the config file
	// In this way you can load a system-wide read-only config file
	// as default configuration, alter its settings and save it to the
	// user local configuration directory
	void setSavePath(const QString & savePath){ m_szFileName = savePath; };
	QDict<KviConfigGroup> *dict(){ return m_pDict; };

	void clearDirtyFlag(){ m_bDirty = false; };
	void clear();
	void clearGroup(const QString & szGroup);
	void clearKey(const QString & szKey);
	unsigned int groupsCount(){ return m_pDict->count(); };
	bool sync(){ return save(); };
	bool hasKey(const QString & szKey);
	bool hasGroup(const QString & szGroup);
	void setGroup(const QString & szGroup);
	//void getContentsString(KviStr &buffer);
	const QString & group(){ return m_szGroup; };
	void writeEntry(const QString & szKey,const QString & szValue);
	void writeEntry(const QString & szKey,const char * szValue)
		{ writeEntry(szKey,QString::fromUtf8(szValue)); };
	QString readEntry(const QString & szKey,const QString & szDefault = QString::null);
	// HACK for KviOptions.. (FIXME)
	QString readKviStrEntry(const QString &szKey,const KviStr &szDefault)
		{ return readEntry(szKey,szDefault.ptr()); };
	//void writeEntry(const char *szKey,KviStr &szValue);
	//const char * readEntry(const char *szKey,KviStr &szDefault);
	void writeEntry(const QString & szKey,const KviPixmap &pixmap);
	KviPixmap readPixmapEntry(const QString & szKey,const KviPixmap &pixDef);
	void writeEntry(const QString & szKey,const KviMsgType &msg);
	KviMsgType readMsgTypeEntry(const QString & szKey,const KviMsgType &msgDef);
	void writeEntry(const QString & szKey,const QColor &clr);
	QColor readColorEntry(const QString & szKey,const QColor &clr);
	void writeEntry(const QString & szKey,QFont &fnt);
	QFont readFontEntry(const QString & szKey,const QFont &fnt);
	void writeEntry(const QString & szKey,bool bTrue);
	bool readBoolEntry(const QString & szKey,bool bTrue);
	QRect readRectEntry(const QString & szKey,const QRect &rct);
	void writeEntry(const QString & szKey,const QRect &rct);
	QStringList readStringListEntry(const QString & szKey,const QStringList &list);
	void writeEntry(const QString & szKey,const QStringList &list);
	QValueList<int> readIntListEntry(const QString & ,const QValueList<int> &list);
	void writeEntry(const QString & szKey,const QValueList<int> &list);
	QString readQStringEntry(const QString & szKey,const QString &szDefault)
		{ return readEntry(szKey,szDefault); };
	//void writeEntry(const QString & szKey,const QString &szValue);
	//void writeEntry(const char *szKey,unsigned long lValue);
	//unsigned long readULongEntry(const char *szKey,unsigned long lDefault);
	//void writeEntry(const char *szKey,long lValue);
	//long readLongEntry(const char *szKey,long lDefault);
	void writeEntry(const QString & szKey,int iValue);
	int readIntEntry(const QString & szKey,int iDefault);
	void writeEntry(const QString & szKey,unsigned short int usValue);
	unsigned short int readUShortEntry(const QString & szKey,unsigned short int usDefault);
	void writeEntry(const QString & szKey,unsigned int iValue);
	unsigned int readUIntEntry(const QString & szKey,unsigned int iDefault);
	void writeEntry(const QString & szKey,char iValue);
	char readCharEntry(const QString & szKey,char iDefault);
	void writeEntry(const QString & szKey,unsigned char iValue);
	unsigned char readUCharEntry(const QString & szKey,unsigned char iDefault);

	static void getFontProperties(KviStr & buffer,QFont *fnt);
	static void setFontProperties(KviStr & str,QFont *fnt);

#ifdef COMPILE_ON_WINDOWS
	// On windows we need to override new and delete operators
	// to ensure that always the right new/delete pair is called for an object instance
	// This bug is present in all the classes exported by a module that
	// can be instantiated/destroyed from external modules.
	// (this is a well known bug described in Q122675 of MSDN)
	void       * operator new(size_t tSize);
	void         operator delete(void * p);
#endif
};

#endif //!_KVI_CONFIG_H_INCLUDED_
