.TH "KConfigBase" 3 "28 Jan 2004" "kdecore Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KConfigBase \- Abstract base class for \fBKDE\fP configuration entries. \fBKDE\fP Configuration Management abstract base class.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kconfigbase.h>\fP
.PP
Inherits \fBQObject\fP.
.PP
Inherited by \fBKConfig\fP, and KConfigGroup.
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBConfigState\fP { \fBNoAccess\fP, \fBReadOnly\fP, \fBReadWrite\fP }"
.br
.RI "\fIPossible return values for \fBgetConfigState\fP(). \fP"
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKConfigBase\fP ()"
.br
.RI "\fIConstruct a KConfigBase object. \fP"
.ti -1c
.RI "virtual \fB~KConfigBase\fP ()"
.br
.RI "\fIDestructs the KConfigBase object. \fP"
.ti -1c
.RI "void \fBsetGroup\fP (const  \fBQString\fP &group)"
.br
.RI "\fISpecifies the group in which keys will be read and written. \fP"
.ti -1c
.RI "void \fBsetDesktopGroup\fP ()"
.br
.RI "\fISets the group to the 'Desktop Entry' group used for desktop configuration files for applications, mime types, etc. \fP"
.ti -1c
.RI "\fBQString\fP \fBgroup\fP () const "
.br
.RI "\fIReturns the name of the group in which we are searching for keys and from which we are retrieving entries. \fP"
.ti -1c
.RI "bool \fBhasGroup\fP (const  \fBQString\fP &group) const "
.br
.RI "\fIReturns true if the specified group is known about. \fP"
.ti -1c
.RI "virtual \fBQStringList\fP \fBgroupList\fP () const =0"
.br
.RI "\fIReturns a list of groups that are known about. \fP"
.ti -1c
.RI "\fBQString\fP \fBlocale\fP () const "
.br
.RI "\fIReturns a the current locale. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadEntry\fP (const  \fBQString\fP &pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadEntry\fP (const  char *pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQVariant\fP \fBreadPropertyEntry\fP (const  \fBQString\fP &pKey, QVariant::Type) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQVariant\fP \fBreadPropertyEntry\fP (const  char *pKey, QVariant::Type) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQVariant\fP \fBreadPropertyEntry\fP (const  \fBQString\fP &pKey, const  \fBQVariant\fP &adefault) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQVariant\fP \fBreadPropertyEntry\fP (const  char *pKey, const  \fBQVariant\fP &aDefault) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "int \fBreadListEntry\fP (const  \fBQString\fP &pKey, \fBQStrList\fP &list, char sep= ',') const "
.br
.RI "\fIReads a list of strings. \fP"
.ti -1c
.RI "int \fBreadListEntry\fP (const  char *pKey, \fBQStrList\fP &list, char sep= ',') const "
.br
.RI "\fIReads a list of strings. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBreadListEntry\fP (const  \fBQString\fP &pKey, char sep= ',') const "
.br
.RI "\fIReads a list of strings. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBreadListEntry\fP (const  char *pKey, char sep= ',') const "
.br
.RI "\fIReads a list of strings. \fP"
.ti -1c
.RI "\fBQValueList\fP< int > \fBreadIntListEntry\fP (const  \fBQString\fP &pKey) const "
.br
.RI "\fIReads a list of Integers. \fP"
.ti -1c
.RI "\fBQValueList\fP< int > \fBreadIntListEntry\fP (const  char *pKey) const "
.br
.RI "\fIReads a list of Integers. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadPathEntry\fP (const  \fBQString\fP &pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads a path. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadPathEntry\fP (const  char *pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads a path. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBreadPathListEntry\fP (const  \fBQString\fP &pKey, char sep= ',') const "
.br
.RI "\fIReads a list of string paths. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBreadPathListEntry\fP (const  char *pKey, char sep= ',') const "
.br
.RI "\fIReads a list of string paths. \fP"
.ti -1c
.RI "int \fBreadNumEntry\fP (const  \fBQString\fP &pKey, int nDefault=0) const "
.br
.RI "\fIReads a numerical value. \fP"
.ti -1c
.RI "int \fBreadNumEntry\fP (const  char *pKey, int nDefault=0) const "
.br
.RI "\fIReads a numerical value. \fP"
.ti -1c
.RI "unsigned int \fBreadUnsignedNumEntry\fP (const  \fBQString\fP &pKey, unsigned int nDefault=0) const "
.br
.RI "\fIReads an unsigned numerical value. \fP"
.ti -1c
.RI "unsigned int \fBreadUnsignedNumEntry\fP (const  char *pKey, unsigned int nDefault=0) const "
.br
.RI "\fIReads an unsigned numerical value. \fP"
.ti -1c
.RI "long \fBreadLongNumEntry\fP (const  \fBQString\fP &pKey, long nDefault=0) const "
.br
.RI "\fIReads a numerical value. \fP"
.ti -1c
.RI "long \fBreadLongNumEntry\fP (const  char *pKey, long nDefault=0) const "
.br
.RI "\fIReads a numerical value. \fP"
.ti -1c
.RI "unsigned long \fBreadUnsignedLongNumEntry\fP (const  \fBQString\fP &pKey, unsigned long nDefault=0) const "
.br
.RI "\fIRead an unsigned numerical value. \fP"
.ti -1c
.RI "unsigned long \fBreadUnsignedLongNumEntry\fP (const  char *pKey, unsigned long nDefault=0) const "
.br
.RI "\fIRead an unsigned numerical value. \fP"
.ti -1c
.RI "double \fBreadDoubleNumEntry\fP (const  \fBQString\fP &pKey, double nDefault=0.0) const "
.br
.RI "\fIReads a floating point value. \fP"
.ti -1c
.RI "double \fBreadDoubleNumEntry\fP (const  char *pKey, double nDefault=0.0) const "
.br
.RI "\fIReads a floating point value. \fP"
.ti -1c
.RI "\fBQFont\fP \fBreadFontEntry\fP (const  \fBQString\fP &pKey, const  \fBQFont\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQFont\fP value. \fP"
.ti -1c
.RI "\fBQFont\fP \fBreadFontEntry\fP (const  char *pKey, const  \fBQFont\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQFont\fP value. \fP"
.ti -1c
.RI "bool \fBreadBoolEntry\fP (const  \fBQString\fP &pKey, const  bool bDefault=false) const "
.br
.RI "\fIReads a boolean entry. \fP"
.ti -1c
.RI "bool \fBreadBoolEntry\fP (const  char *pKey, const  bool bDefault=false) const "
.br
.RI "\fIReads a boolean entry. \fP"
.ti -1c
.RI "\fBQRect\fP \fBreadRectEntry\fP (const  \fBQString\fP &pKey, const  \fBQRect\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQRect\fP entry. \fP"
.ti -1c
.RI "\fBQRect\fP \fBreadRectEntry\fP (const  char *pKey, const  \fBQRect\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQRect\fP entry. \fP"
.ti -1c
.RI "\fBQPoint\fP \fBreadPointEntry\fP (const  \fBQString\fP &pKey, const  \fBQPoint\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQPoint\fP entry. \fP"
.ti -1c
.RI "\fBQPoint\fP \fBreadPointEntry\fP (const  char *pKey, const  \fBQPoint\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQPoint\fP entry. \fP"
.ti -1c
.RI "\fBQSize\fP \fBreadSizeEntry\fP (const  \fBQString\fP &pKey, const  \fBQSize\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQSize\fP entry. \fP"
.ti -1c
.RI "\fBQSize\fP \fBreadSizeEntry\fP (const  char *pKey, const  \fBQSize\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQSize\fP entry. \fP"
.ti -1c
.RI "\fBQColor\fP \fBreadColorEntry\fP (const  \fBQString\fP &pKey, const  \fBQColor\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQColor\fP entry. \fP"
.ti -1c
.RI "\fBQColor\fP \fBreadColorEntry\fP (const  char *pKey, const  \fBQColor\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQColor\fP entry. \fP"
.ti -1c
.RI "\fBQDateTime\fP \fBreadDateTimeEntry\fP (const  \fBQString\fP &pKey, const  \fBQDateTime\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQDateTime\fP entry. \fP"
.ti -1c
.RI "\fBQDateTime\fP \fBreadDateTimeEntry\fP (const  char *pKey, const  \fBQDateTime\fP *pDefault=0L) const "
.br
.RI "\fIReads a \fBQDateTime\fP entry. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadEntryUntranslated\fP (const  \fBQString\fP &pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "\fBQString\fP \fBreadEntryUntranslated\fP (const  char *pKey, const  \fBQString\fP &aDefault=QString::null) const "
.br
.RI "\fIReads the value of an entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQString\fP &pValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a key/value pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQString\fP &pValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a key/value pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQVariant\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() Overridden to accept a property. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQVariant\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() Overridden to accept a property. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQStrList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of strings. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQStrList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of strings. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQStringList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of strings. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQStringList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of strings. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQValueList\fP< int > &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of Integers. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQValueList\fP< int > &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwriteEntry\fP() overridden to accept a list of Integers. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  char *pValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrite a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  char *pValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrite a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, int nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrite a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, int nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrite a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, unsigned int nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, unsigned int nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, long nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, long nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, unsigned long nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, unsigned long nValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, double nValue, bool bPersistent=true, bool bGlobal=false, char format= 'g', int precision=6, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, double nValue, bool bPersistent=true, bool bGlobal=false, char format= 'g', int precision=6, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, bool bValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, bool bValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQFont\fP &rFont, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQFont\fP &rFont, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQColor\fP &rColor, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQColor\fP &rColor, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQDateTime\fP &rDateTime, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQDateTime\fP &rDateTime, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQRect\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQRect\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQPoint\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQPoint\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  \fBQString\fP &pKey, const  \fBQSize\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwriteEntry\fP (const  char *pKey, const  \fBQSize\fP &rValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a (key/value) pair. \fP"
.ti -1c
.RI "void \fBwritePathEntry\fP (const  \fBQString\fP &pKey, const  \fBQString\fP &path, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a file path. \fP"
.ti -1c
.RI "void \fBwritePathEntry\fP (const  char *pKey, const  \fBQString\fP &path, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fIWrites a file path. \fP"
.ti -1c
.RI "void \fBwritePathEntry\fP (const  \fBQString\fP &pKey, const  \fBQStringList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwritePathEntry\fP() overridden to accept a list of paths (strings). \fP"
.ti -1c
.RI "void \fBwritePathEntry\fP (const  char *pKey, const  \fBQStringList\fP &rValue, char sep= ',', bool bPersistent=true, bool bGlobal=false, bool bNLS=false)"
.br
.RI "\fI\fBwritePathEntry\fP() overridden to accept a list of paths (strings). \fP"
.ti -1c
.RI "void \fBdeleteEntry\fP (const  \fBQString\fP &pKey, bool bNLS=false, bool bGlobal=false)"
.br
.RI "\fIDeletes the entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "void \fBdeleteEntry\fP (const  char *pKey, bool bNLS=false, bool bGlobal=false)"
.br
.RI "\fIDeletes the entry specified by \fCpKey\fP in the current group. \fP"
.ti -1c
.RI "bool \fBdeleteGroup\fP (const  \fBQString\fP &group, bool bDeep=true, bool bGlobal=false)"
.br
.RI "\fIDeletes a configuration entry group. \fP"
.ti -1c
.RI "void \fBsetDollarExpansion\fP (bool _bExpand=true)"
.br
.RI "\fITurns on or off 'dollar  expansion' (see KConfigBase introduction) when reading config entries. \fP"
.ti -1c
.RI "bool \fBisDollarExpansion\fP () const "
.br
.RI "\fIReturns whether dollar expansion is on or off. \fP"
.ti -1c
.RI "virtual void \fBrollback\fP (bool bDeep=true)"
.br
.RI "\fIMark the config object as 'clean,' i.e. \fP"
.ti -1c
.RI "virtual void \fBsync\fP ()"
.br
.RI "\fIFlushes all changes that currently reside only in memory back to disk / permanent storage. \fP"
.ti -1c
.RI "bool \fBisDirty\fP () const "
.br
.RI "\fIChecks whether the config file has any dirty (modified) entries. \fP"
.ti -1c
.RI "virtual void \fBsetReadOnly\fP (bool _ro)"
.br
.RI "\fISets the config object's read-only status. \fP"
.ti -1c
.RI "bool \fBisReadOnly\fP () const "
.br
.RI "\fIReturns the read-only status of the config object. \fP"
.ti -1c
.RI "bool \fBhasKey\fP (const  \fBQString\fP &key) const "
.br
.RI "\fIChecks whether the key has an entry in the currently active group. \fP"
.ti -1c
.RI "virtual \fBQMap\fP< \fBQString\fP, \fBQString\fP > \fBentryMap\fP (const  \fBQString\fP &group) const =0"
.br
.RI "\fIReturns a map (tree) of entries for all entries in a particular group. \fP"
.ti -1c
.RI "virtual void \fBreparseConfiguration\fP ()=0"
.br
.RI "\fIReparses all configuration files. \fP"
.ti -1c
.RI "bool \fBisImmutable\fP () const "
.br
.RI "\fIChecks whether this configuration file can be modified. \fP"
.ti -1c
.RI "bool \fBgroupIsImmutable\fP (const  \fBQString\fP &group) const "
.br
.RI "\fIChecks whether it is possible to change the given group. \fP"
.ti -1c
.RI "bool \fBentryIsImmutable\fP (const  \fBQString\fP &key) const "
.br
.RI "\fIChecks whether it is possible to change the given entry. \fP"
.ti -1c
.RI "\fBConfigState\fP \fBgetConfigState\fP () const "
.br
.RI "\fIReturns the state of the app-config object. \fP"
.ti -1c
.RI "void \fBsetGroup\fP (const  \fBQCString\fP &pGroup)"
.br
.RI "\fIOverloaded public methods:. \fP"
.ti -1c
.RI "void \fBsetGroup\fP (const  char *pGroup)"
.br
.ti -1c
.RI "bool \fBhasGroup\fP (const  \fBQCString\fP &_pGroup) const "
.br
.ti -1c
.RI "bool \fBhasGroup\fP (const  char *_pGroup) const "
.br
.ti -1c
.RI "bool \fBhasKey\fP (const  char *pKey) const "
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBsetLocale\fP ()"
.br
.RI "\fIReads the locale and put in the configuration data struct. \fP"
.ti -1c
.RI "virtual void \fBsetDirty\fP (bool _bDirty=true)"
.br
.RI "\fISets the global dirty flag of the config object. \fP"
.ti -1c
.RI "virtual void \fBparseConfigFiles\fP ()"
.br
.RI "\fIParses all configuration files for a configuration object. \fP"
.ti -1c
.RI "virtual \fBKEntryMap\fP \fBinternalEntryMap\fP (const  \fBQString\fP &pGroup) const =0"
.br
.RI "\fIReturns a map (tree) of the entries in the specified group. \fP"
.ti -1c
.RI "virtual \fBKEntryMap\fP \fBinternalEntryMap\fP () const =0"
.br
.RI "\fIReturns a map (tree) of the entries in the tree. \fP"
.ti -1c
.RI "virtual void \fBputData\fP (const  \fBKEntryKey\fP &_key, const  \fBKEntry\fP &_data, bool _checkGroup=true)=0"
.br
.RI "\fIInserts a (key/value) pair into the internal storage mechanism of the configuration object. \fP"
.ti -1c
.RI "virtual \fBKEntry\fP \fBlookupData\fP (const  \fBKEntryKey\fP &_key) const =0"
.br
.RI "\fILooks up an entry in the config object's internal structure. \fP"
.ti -1c
.RI "virtual bool \fBinternalHasGroup\fP (const  \fBQCString\fP &group) const =0"
.br
.ti -1c
.RI "\fBQCString\fP \fBreadEntryUtf8\fP (const  char *pKey) const "
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBKConfigBackEnd\fP * \fBbackEnd\fP"
.br
.RI "\fIA back end for loading/saving to disk in a particular format. \fP"
.ti -1c
.RI "\fBQCString\fP \fBmGroup\fP"
.br
.RI "\fIThe currently selected group. \fP"
.ti -1c
.RI "\fBQCString\fP \fBaLocaleString\fP"
.br
.RI "\fIThe locale to retrieve keys under if possible, i.e en_US or fr. \fP"
.ti -1c
.RI "bool \fBbDirty\fP"
.br
.RI "\fIIndicates whether there are any dirty entries in the config object that need to be written back to disk. \fP"
.ti -1c
.RI "bool \fBbLocaleInitialized\fP"
.br
.ti -1c
.RI "bool \fBbReadOnly\fP"
.br
.ti -1c
.RI "bool \fBbExpand\fP"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKConfigINIBackEnd\fP"
.br
.ti -1c
.RI "class \fBKConfigGroup\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
Abstract base class for \fBKDE\fP configuration entries. \fBKDE\fP Configuration Management abstract base class. 

This class forms the base for all \fBKDE\fP configuration. It is an abstract base class, meaning that you cannot directly instantiate objects of this class. Either use \fBKConfig\fP (for usual \fBKDE\fP configuration) or \fBKSimpleConfig\fP (for special needs as in ksamba), or even KSharedConfig (stores values in shared memory).
.PP
All configuration entries are key, value pairs. Each entry also belongs to a specific group of related entries. All configuration entries that do not explicitly specify which group they are in are in a special group called the default group.
.PP
If there is a $ character in an entry, KConfigBase tries to expand environment variable and uses its value instead of its name. You can avoid this feature by having two consecutive $ characters in your config file which get expanded to one.
.PP
Note: the '=' char is not allowed in keys and the ']' char is not allowed in group name.
.PP
\fBAuthor:\fP
.RS 4
Kalle Dalheimer <kalle@kde.org>, Preston Brown <pbrown@kde.org> 
.RE
.PP
\fBVersion:\fP
.RS 4
\fBId\fP.RS 4
\fBkconfigbase.h\fP,v 1.83.2.1 2003/06/22 21:39:31 deller Exp 
.RE
.PP
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKGlobal::config()\fP \fBKConfig\fP \fBKSimpleConfig\fP 
.RE
.PP

.PP
Definition at line 70 of file kconfigbase.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKConfigBase::ConfigState\fP"
.PP
Possible return values for \fBgetConfigState\fP(). \fBSee also:\fP
.RS 4
\fBgetConfigState()\fP 
.RE
.PP
Definition at line 1661 of file kconfigbase.h.
.PP
Referenced by getConfigState(), and KConfigBackEnd::getConfigState().
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KConfigBase::KConfigBase ()"
.PP
Construct a KConfigBase object. Definition at line 123 of file kconfigbase.cpp.
.PP
References setGroup().
.SS "KConfigBase::~\fBKConfigBase\fP ()\fC [virtual]\fP"
.PP
Destructs the KConfigBase object. Definition at line 130 of file kconfigbase.cpp.
.SH "Member Function Documentation"
.PP 
.SS "void KConfigBase::setGroup (const \fBQString\fP & group)"
.PP
Specifies the group in which keys will be read and written. Subsequent calls to \fBreadEntry\fP() and \fBwriteEntry\fP() will be aplied only in the activated group.
.PP
Switch back to the default group by passing a null string. 
.PP
\fBParameters:\fP
.RS 4
\fIgroup\fP The name of the new group. 
.RE
.PP
Definition at line 151 of file kconfigbase.cpp.
.PP
References mGroup.
.PP
Referenced by KStandardDirs::addCustomized(), KConfig::checkUpdate(), KInstance::config(), KNotifyClient::getDefaultFile(), KNotifyClient::getDefaultPresentation(), KNotifyClient::getFile(), KNotifyClient::getPresentation(), KIconEffect::init(), KApplication::invokeMailer(), KConfigBase(), KConfigGroupSaver::KConfigGroupSaver(), KIconTheme::KIconTheme(), KLocale::languagesTwoAlpha(), KDesktopFile::setActionGroup(), and KLocale::twoAlphaToCountryName().
.SS "void KConfigBase::setDesktopGroup ()"
.PP
Sets the group to the 'Desktop Entry' group used for desktop configuration files for applications, mime types, etc. Definition at line 176 of file kconfigbase.cpp.
.PP
References mGroup.
.PP
Referenced by KDesktopFile::KDesktopFile().
.SS "\fBQString\fP KConfigBase::group () const"
.PP
Returns the name of the group in which we are searching for keys and from which we are retrieving entries. \fBReturns:\fP
.RS 4
The current group. 
.RE
.PP
Definition at line 172 of file kconfigbase.cpp.
.PP
References QString::fromUtf8(), and mGroup.
.PP
Referenced by KStandardDirs::addCustomized(), KConfig::checkUpdate(), and KConfig::groupList().
.SS "bool KConfigBase::hasGroup (const \fBQString\fP & group) const"
.PP
Returns true if the specified group is known about. \fBParameters:\fP
.RS 4
\fIgroup\fP The group to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
Whether the group exists. 
.RE
.PP
Definition at line 205 of file kconfigbase.cpp.
.PP
Referenced by KDesktopFile::hasActionGroup(), KShortcutList::readSettings(), and KShortcutList::writeSettings().
.SS "virtual \fBQStringList\fP KConfigBase::groupList () const\fC [pure virtual]\fP"
.PP
Returns a list of groups that are known about. \fBReturns:\fP
.RS 4
The list of groups. 
.RE
.PP
Implemented in \fBKConfig\fP.
.SS "\fBQString\fP KConfigBase::locale () const"
.PP
Returns a the current locale. \fBReturns:\fP
.RS 4
A string representing the current locale. 
.RE
.PP
Definition at line 146 of file kconfigbase.cpp.
.PP
References aLocaleString, and QString::fromUtf8().
.SS "\fBQString\fP KConfigBase::readEntry (const \fBQString\fP & pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. Can be QString::null if aDefault it null. 
.RE
.PP
Definition at line 274 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KGlobalSettings::contextMenuKey(), KIconTheme::current(), KDesktopFile::hasApplicationType(), KDesktopFile::hasDeviceType(), KDesktopFile::hasLinkType(), KDesktopFile::hasMimeTypeType(), KIconEffect::init(), KIconTheme::KIconTheme(), KGlobalSettings::mouseSettings(), readColorEntry(), KDesktopFile::readComment(), KDesktopFile::readDevice(), readFontEntry(), KDesktopFile::readGenericName(), KDesktopFile::readIcon(), readListEntry(), KDesktopFile::readName(), readPathEntry(), readPropertyEntry(), KShortcutList::readSettings(), KDesktopFile::readType(), KDesktopFile::tryExec(), KLocale::twoAlphaToCountryName(), and KShortcutList::writeSettings().
.SS "\fBQString\fP KConfigBase::readEntry (const char * pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. Can be QString::null if aDefault it null. 
.RE
.PP
Definition at line 280 of file kconfigbase.cpp.
.PP
References QString::ascii(), KEntry::bExpand, KEntryKey::bLocal, KEntryKey::c_key, QFile::encodeName(), QString::find(), QString::fromLocal8Bit(), QString::fromUtf8(), QString::isEmpty(), QString::isNull(), QCString::isNull(), QString::length(), lookupData(), mGroup, QString::mid(), KEntry::mValue, QTextStream::read(), QString::remove(), QString::replace(), setLocale(), and KGlobal::staticQString().
.SS "\fBQVariant\fP KConfigBase::readPropertyEntry (const \fBQString\fP & pKey, QVariant::Type) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The value is treated as if it is of the given type.
.PP
Note that only the following \fBQVariant\fP types are allowed : String, StringList, List, Font, Point, Rect, Size, Color, Int, UInt, Bool, Double, DateTime and Date. \fBThis class or method is obsolete, it is provided for compatibility only.\fP
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
An invalid \fBQVariant\fP if the key was not found or if the read value cannot be converted to the given QVariant::Type. 
.RE
.PP
Definition at line 418 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "\fBQVariant\fP KConfigBase::readPropertyEntry (const char * pKey, QVariant::Type) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The value is treated as if it is of the given type.
.PP
Note that only the following \fBQVariant\fP types are allowed : String, StringList, List, Font, Point, Rect, Size, Color, Int, UInt, Bool, Double, DateTime and Date.
.PP
\fBThis class or method is obsolete, it is provided for compatibility only.\fP
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
An invalid \fBQVariant\fP if the key was not found or if the read value cannot be converted to the given QVariant::Type. 
.RE
.PP
Definition at line 424 of file kconfigbase.cpp.
.PP
References QVariant::cast(), hasKey(), and readPropertyEntry().
.SS "\fBQVariant\fP KConfigBase::readPropertyEntry (const \fBQString\fP & pKey, const \fBQVariant\fP & adefault) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The value is treated as if it is of the type of the given default value.
.PP
Note that only the following \fBQVariant\fP types are allowed : String, StringList, List, Font, Point, Rect, Size, Color, Int, UInt, Bool, Double, DateTime and Date.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found or if the read value cannot be converted to the QVariant::Type. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for the key or the default value if the key was not found. 
.RE
.PP
Definition at line 433 of file kconfigbase.cpp.
.PP
References readPropertyEntry(), and QString::utf8().
.SS "\fBQVariant\fP KConfigBase::readPropertyEntry (const char * pKey, const \fBQVariant\fP & aDefault) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The value is treated as if it is of the type of the given default value.
.PP
Note that only the following \fBQVariant\fP types are allowed : String, StringList, List, Font, Point, Rect, Size, Color, Int, UInt, Bool, Double, DateTime and Date.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found or if the read value cannot be converted to the QVariant::Type. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for the key or the default value if the key was not found. 
.RE
.PP
Definition at line 439 of file kconfigbase.cpp.
.PP
References QValueList::append(), QVariant::asColor(), QVariant::asDateTime(), QVariant::asFont(), QVariant::asPoint(), QVariant::asRect(), QVariant::asSize(), QDateTime::date(), KStdAccel::end(), hasKey(), readBoolEntry(), readColorEntry(), readDateTimeEntry(), readDoubleNumEntry(), readEntry(), readFontEntry(), readListEntry(), readNumEntry(), readPointEntry(), readRectEntry(), readSizeEntry(), readUnsignedNumEntry(), QVariant::toBool(), QVariant::toDouble(), QVariant::toInt(), QVariant::toString(), QVariant::toUInt(), and QVariant::type().
.SS "int KConfigBase::readListEntry (const \fBQString\fP & pKey, \fBQStrList\fP & list, char sep = ',') const"
.PP
Reads a list of strings. \fBThis class or method is obsolete, it is provided for compatibility only.\fP
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIlist\fP In this object, the read list will be returned. 
.br
\fIsep\fP The list separator (default ',') 
.RE
.PP
\fBReturns:\fP
.RS 4
The number of entries in the list. 
.RE
.PP
Definition at line 514 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KStandardDirs::addCustomized(), KConfig::checkUpdate(), KIconTheme::KIconTheme(), KLocale::languagesTwoAlpha(), KDesktopFile::readActions(), readDateTimeEntry(), readIntListEntry(), readListEntry(), readPathListEntry(), readPropertyEntry(), KDesktopFile::sortOrder(), and KDesktopFile::tryExec().
.SS "int KConfigBase::readListEntry (const char * pKey, \fBQStrList\fP & list, char sep = ',') const"
.PP
Reads a list of strings. \fBThis class or method is obsolete, it is provided for compatibility only.\fP
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIlist\fP In this object, the read list will be returned. 
.br
\fIsep\fP The list separator (default ',') 
.RE
.PP
\fBReturns:\fP
.RS 4
The number of entries in the list. 
.RE
.PP
Definition at line 520 of file kconfigbase.cpp.
.PP
References hasKey(), QCString::isEmpty(), QCString::length(), and QCString::truncate().
.SS "\fBQStringList\fP KConfigBase::readListEntry (const \fBQString\fP & pKey, char sep = ',') const"
.PP
Reads a list of strings. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIsep\fP The list separator (default is ','). 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
Definition at line 558 of file kconfigbase.cpp.
.PP
References readListEntry(), and QString::utf8().
.SS "\fBQStringList\fP KConfigBase::readListEntry (const char * pKey, char sep = ',') const"
.PP
Reads a list of strings. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIsep\fP The list separator (default is ','). 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
Definition at line 563 of file kconfigbase.cpp.
.PP
References hasKey(), QString::isEmpty(), QString::length(), readEntry(), and QString::truncate().
.SS "\fBQValueList\fP< int > KConfigBase::readIntListEntry (const \fBQString\fP & pKey) const"
.PP
Reads a list of Integers. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
Definition at line 594 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KIconTheme::KIconTheme().
.SS "\fBQValueList\fP< int > KConfigBase::readIntListEntry (const char * pKey) const"
.PP
Reads a list of Integers. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
Definition at line 599 of file kconfigbase.cpp.
.PP
References readListEntry().
.SS "\fBQString\fP KConfigBase::readPathEntry (const \fBQString\fP & pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads a path. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a path. This means, dollar expansion is activated for this value, so that e.g. $HOME gets expanded.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. Can be QString::null if aDefault is null. 
.RE
.PP
Definition at line 611 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KCharsets::codecForName(), KNotifyClient::getDefaultFile(), KNotifyClient::getFile(), KApplication::invokeMailer(), KIconTheme::KIconTheme(), KDesktopFile::readDocPath(), KDesktopFile::readPath(), KDesktopFile::readURL(), and KDesktopFile::tryExec().
.SS "\fBQString\fP KConfigBase::readPathEntry (const char * pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads a path. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a path. This means, dollar expansion is activated for this value, so that e.g. $HOME gets expanded.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. Can be QString::null if aDefault is null. 
.RE
.PP
Definition at line 616 of file kconfigbase.cpp.
.PP
References readEntry().
.SS "\fBQStringList\fP KConfigBase::readPathListEntry (const \fBQString\fP & pKey, char sep = ',') const"
.PP
Reads a list of string paths. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a list of paths. This means, dollar expansion is activated for this value, so that e.g. $HOME gets expanded.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIsep\fP The list separator (default is ','). 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
\fBSince:\fP
.RS 4
3.1.3 
.RE
.PP
Definition at line 625 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KIconTheme::KIconTheme().
.SS "\fBQStringList\fP KConfigBase::readPathListEntry (const char * pKey, char sep = ',') const"
.PP
Reads a list of string paths. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a list of paths. This means, dollar expansion is activated for this value, so that e.g. $HOME gets expanded.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIsep\fP The list separator (default is ','). 
.RE
.PP
\fBReturns:\fP
.RS 4
The list. Empty if the entry does not exist. 
.RE
.PP
\fBSince:\fP
.RS 4
3.1.3 
.RE
.PP
Definition at line 630 of file kconfigbase.cpp.
.PP
References readListEntry().
.SS "int KConfigBase::readNumEntry (const \fBQString\fP & pKey, int nDefault = 0) const"
.PP
Reads a numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 639 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KGlobalSettings::autoSelectDelay(), KGlobalSettings::completionMode(), KGlobalSettings::contrast(), KGlobalSettings::dndEventDelay(), KNotifyClient::getDefaultPresentation(), KNotifyClient::getPresentation(), KGlobalSettings::insertTearOffHandle(), KIconTheme::KIconTheme(), readPropertyEntry(), and KGlobalSettings::visualActivateSpeed().
.SS "int KConfigBase::readNumEntry (const char * pKey, int nDefault = 0) const"
.PP
Reads a numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 644 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toInt().
.SS "unsigned int KConfigBase::readUnsignedNumEntry (const \fBQString\fP & pKey, unsigned int nDefault = 0) const"
.PP
Reads an unsigned numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 660 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "unsigned int KConfigBase::readUnsignedNumEntry (const char * pKey, unsigned int nDefault = 0) const"
.PP
Reads an unsigned numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 665 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toUInt().
.SS "long KConfigBase::readLongNumEntry (const \fBQString\fP & pKey, long nDefault = 0) const"
.PP
Reads a numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 679 of file kconfigbase.cpp.
.PP
References QString::utf8().
.SS "long KConfigBase::readLongNumEntry (const char * pKey, long nDefault = 0) const"
.PP
Reads a numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 684 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toLong().
.SS "unsigned long KConfigBase::readUnsignedLongNumEntry (const \fBQString\fP & pKey, unsigned long nDefault = 0) const"
.PP
Read an unsigned numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 698 of file kconfigbase.cpp.
.PP
References QString::utf8().
.SS "unsigned long KConfigBase::readUnsignedLongNumEntry (const char * pKey, unsigned long nDefault = 0) const"
.PP
Read an unsigned numerical value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 703 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toULong().
.SS "double KConfigBase::readDoubleNumEntry (const \fBQString\fP & pKey, double nDefault = 0.0) const"
.PP
Reads a floating point value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 716 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KIconEffect::init(), and readPropertyEntry().
.SS "double KConfigBase::readDoubleNumEntry (const char * pKey, double nDefault = 0.0) const"
.PP
Reads a floating point value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it numerically.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fInDefault\fP A default value returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 721 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toDouble().
.SS "\fBQFont\fP KConfigBase::readFontEntry (const \fBQString\fP & pKey, const \fBQFont\fP * pDefault = 0L) const"
.PP
Reads a \fBQFont\fP value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a font object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (null \fBQFont\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 762 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KGlobalSettings::fixedFont(), KGlobalSettings::generalFont(), KGlobalSettings::menuFont(), readPropertyEntry(), KGlobalSettings::taskbarFont(), KGlobalSettings::toolBarFont(), and KGlobalSettings::windowTitleFont().
.SS "\fBQFont\fP KConfigBase::readFontEntry (const char * pKey, const \fBQFont\fP * pDefault = 0L) const"
.PP
Reads a \fBQFont\fP value. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a font object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (null \fBQFont\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 767 of file kconfigbase.cpp.
.PP
References QString::contains(), QString::find(), QFont::fromString(), QString::isNull(), QString::left(), QString::length(), QString::mid(), readEntry(), QString::right(), QFont::setFamily(), QFont::setFixedPitch(), QFont::setItalic(), QFont::setPointSize(), QFont::setRawMode(), QFont::setStrikeOut(), QFont::setStyleHint(), QFont::setUnderline(), and QFont::setWeight().
.SS "bool KConfigBase::readBoolEntry (const \fBQString\fP & pKey, const bool bDefault = false) const"
.PP
Reads a boolean entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a boolean value. Currently 'on' and 'true' are accepted as true, everything else if false.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIbDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 735 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KStandardDirs::addCustomized(), KApplication::authorize(), KGlobalSettings::changeCursorOverIcon(), KInstance::config(), KIconEffect::init(), KNotifyClient::Instance::Instance(), KApplication::invokeMailer(), KIconTheme::KIconTheme(), readPropertyEntry(), KGlobalSettings::showContextMenusOnPress(), KGlobalSettings::singleClick(), KDesktopFile::tryExec(), and KGlobalSettings::visualActivate().
.SS "bool KConfigBase::readBoolEntry (const char * pKey, const bool bDefault = false) const"
.PP
Reads a boolean entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a boolean value. Currently 'on' and 'true' are accepted as true, everything else if false.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIbDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 740 of file kconfigbase.cpp.
.PP
References QCString::isNull(), and QCString::toInt().
.SS "\fBQRect\fP KConfigBase::readRectEntry (const \fBQString\fP & pKey, const \fBQRect\fP * pDefault = 0L) const"
.PP
Reads a \fBQRect\fP entry. Read the value of an entry specified by pKey in the current group and interpret it as a \fBQRect\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQRect\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 859 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "\fBQRect\fP KConfigBase::readRectEntry (const char * pKey, const \fBQRect\fP * pDefault = 0L) const"
.PP
Reads a \fBQRect\fP entry. Read the value of an entry specified by pKey in the current group and interpret it as a \fBQRect\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQRect\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 864 of file kconfigbase.cpp.
.PP
References QCString::isEmpty().
.SS "\fBQPoint\fP KConfigBase::readPointEntry (const \fBQString\fP & pKey, const \fBQPoint\fP * pDefault = 0L) const"
.PP
Reads a \fBQPoint\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a \fBQPoint\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQPoint\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 883 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "\fBQPoint\fP KConfigBase::readPointEntry (const char * pKey, const \fBQPoint\fP * pDefault = 0L) const"
.PP
Reads a \fBQPoint\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a \fBQPoint\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQPoint\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 889 of file kconfigbase.cpp.
.PP
References QCString::isEmpty().
.SS "\fBQSize\fP KConfigBase::readSizeEntry (const \fBQString\fP & pKey, const \fBQSize\fP * pDefault = 0L) const"
.PP
Reads a \fBQSize\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a \fBQSize\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQSize\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 908 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "\fBQSize\fP KConfigBase::readSizeEntry (const char * pKey, const \fBQSize\fP * pDefault = 0L) const"
.PP
Reads a \fBQSize\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a \fBQSize\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for 
.br
\fIpDefault\fP A default value (null \fBQSize\fP by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 914 of file kconfigbase.cpp.
.PP
References QCString::isEmpty().
.SS "\fBQColor\fP KConfigBase::readColorEntry (const \fBQString\fP & pKey, const \fBQColor\fP * pDefault = 0L) const"
.PP
Reads a \fBQColor\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a color.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (null \fBQColor\fP by default) returned if the key was not found or if the value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 934 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KGlobalSettings::activeTextColor(), KGlobalSettings::activeTitleColor(), KGlobalSettings::alternateBackgroundColor(), KGlobalSettings::baseColor(), KGlobalSettings::highlightColor(), KGlobalSettings::highlightedTextColor(), KGlobalSettings::inactiveTextColor(), KGlobalSettings::inactiveTitleColor(), KIconEffect::init(), KGlobalSettings::linkColor(), readPropertyEntry(), KGlobalSettings::textColor(), KGlobalSettings::toolBarHighlightColor(), and KGlobalSettings::visitedLinkColor().
.SS "\fBQColor\fP KConfigBase::readColorEntry (const char * pKey, const \fBQColor\fP * pDefault = 0L) const"
.PP
Reads a \fBQColor\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a color.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (null \fBQColor\fP by default) returned if the key was not found or if the value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 940 of file kconfigbase.cpp.
.PP
References QString::at(), QString::find(), QString::isEmpty(), QString::left(), QString::length(), QString::mid(), readEntry(), QString::right(), QColor::setNamedColor(), and QColor::setRgb().
.SS "\fBQDateTime\fP KConfigBase::readDateTimeEntry (const \fBQString\fP & pKey, const \fBQDateTime\fP * pDefault = 0L) const"
.PP
Reads a \fBQDateTime\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a date and time.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (\fBcurrentDateTime\fP() by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 999 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by readPropertyEntry().
.SS "\fBQDateTime\fP KConfigBase::readDateTimeEntry (const char * pKey, const \fBQDateTime\fP * pDefault = 0L) const"
.PP
Reads a \fBQDateTime\fP entry. Read the value of an entry specified by \fCpKey\fP in the current group and interpret it as a date and time.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIpDefault\fP A default value (\fBcurrentDateTime\fP() by default) returned if the key was not found or if the read value cannot be interpreted. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 1006 of file kconfigbase.cpp.
.PP
References QDateTime::currentDateTime(), hasKey(), and readListEntry().
.SS "\fBQString\fP KConfigBase::readEntryUntranslated (const \fBQString\fP & pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The untranslated entry is returned, you normally do not need this.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 257 of file kconfigbase.cpp.
.PP
References QString::utf8().
.SS "\fBQString\fP KConfigBase::readEntryUntranslated (const char * pKey, const \fBQString\fP & aDefault = QString::null) const"
.PP
Reads the value of an entry specified by \fCpKey\fP in the current group. The untranslated entry is returned, you normally do not need this.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.br
\fIaDefault\fP A default value returned if the key was not found. 
.RE
.PP
\fBReturns:\fP
.RS 4
The value for this key. 
.RE
.PP
Definition at line 264 of file kconfigbase.cpp.
.PP
References QString::fromUtf8(), and QCString::isNull().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQString\fP & pValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a key/value pair. This is stored in the most specific config file when destroying the config object or when calling \fBsync\fP().
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1031 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by writeEntry(), writePathEntry(), and KShortcutList::writeSettings().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQString\fP & pValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a key/value pair. This is stored in the most specific config file when destroying the config object or when calling \fBsync\fP().
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1039 of file kconfigbase.cpp.
.PP
References KEntry::bDirty, KEntry::bGlobal, KEntryKey::bLocal, KEntry::bNLS, KGlobal::locale(), mGroup, KEntry::mValue, putData(), setDirty(), setLocale(), and QString::utf8().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQVariant\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() Overridden to accept a property. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The property to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1224 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQVariant\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() Overridden to accept a property. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The property to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1231 of file kconfigbase.cpp.
.PP
References QValueList::begin(), QValueList::end(), KStdAccel::end(), QVariant::toBool(), QVariant::toColor(), QVariant::toDate(), QVariant::toDateTime(), QVariant::toDouble(), QVariant::toFont(), QVariant::toInt(), QVariant::toList(), QVariant::toPoint(), QVariant::toRect(), QVariant::toSize(), QVariant::toString(), QVariant::toStringList(), QVariant::toUInt(), QVariant::type(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQStrList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of strings. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1317 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQStrList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of strings. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1324 of file kconfigbase.cpp.
.PP
References QString::at(), QString::fromLatin1(), QString::fromLocal8Bit(), QString::fromUtf8(), QString::length(), QString::truncate(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQStringList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of strings. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1359 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQStringList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of strings. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1366 of file kconfigbase.cpp.
.PP
References QString::at(), QString::fromLatin1(), QString::length(), QString::truncate(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQValueList\fP< int > & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of Integers. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1394 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQValueList\fP< int > & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwriteEntry\fP() overridden to accept a list of Integers. Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwriteEntry()\fP 
.RE
.PP
Definition at line 1400 of file kconfigbase.cpp.
.PP
References QValueList::begin(), QValueList::end(), KStdAccel::end(), QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const char * pValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)\fC [inline]\fP"
.PP
Write a (key/value) pair. This is stored to the most specific config file when destroying the config object or when calling \fBsync\fP().
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 907 of file kconfigbase.h.
.PP
References QString::fromLatin1(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const char * pValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)\fC [inline]\fP"
.PP
Write a (key/value) pair. This is stored to the most specific config file when destroying the config object or when calling \fBsync\fP().
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 928 of file kconfigbase.h.
.PP
References QString::fromLatin1(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, int nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Write a (key/value) pair. Same as above, but writes a numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1410 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, int nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Write a (key/value) pair. Same as above, but writes a numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1417 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, unsigned int nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes an unsigned numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1425 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, unsigned int nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes an unsigned numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1432 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, long nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but write a long numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1440 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, long nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but write a long numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1447 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, unsigned long nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes an unsigned long numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1455 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, unsigned long nValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes an unsigned long numerical value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1462 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, double nValue, bool bPersistent = true, bool bGlobal = false, char format = 'g', int precision = 6, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a floating-point value. 
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIformat\fP \fCformat\fP determines the format to which the value is converted. Default is 'g'. 
.br
\fIprecision\fP \fCprecision\fP sets the precision with which the value is converted. Default is 6 as in \fBQString\fP. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1470 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, double nValue, bool bPersistent = true, bool bGlobal = false, char format = 'g', int precision = 6, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a floating-point value. 
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fInValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIformat\fP \fCformat\fP determines the format to which the value is converted. Default is 'g'. 
.br
\fIprecision\fP \fCprecision\fP sets the precision with which the value is converted. Default is 6 as in \fBQString\fP. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1479 of file kconfigbase.cpp.
.PP
References QString::number(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, bool bValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a boolean value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIbValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1489 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, bool bValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a boolean value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIbValue\fP The value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1497 of file kconfigbase.cpp.
.PP
References writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQFont\fP & rFont, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a font value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrFont\fP The font value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1513 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQFont\fP & rFont, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a font value.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrFont\fP The font value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1520 of file kconfigbase.cpp.
.PP
References QFont::toString(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQColor\fP & rColor, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but write a color entry.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The color value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1589 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQColor\fP & rColor, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but write a color entry.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The color value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1597 of file kconfigbase.cpp.
.PP
References QColor::blue(), QColor::green(), QColor::isValid(), QColor::red(), QString::sprintf(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQDateTime\fP & rDateTime, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a date and time entry.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is \fInot\fP returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The date and time value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1611 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQDateTime\fP & rDateTime, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a date and time entry.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is \fInot\fP returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The date and time value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1618 of file kconfigbase.cpp.
.PP
References QDateTime::date(), QDate::day(), QTime::hour(), QTime::minute(), QDate::month(), QTime::second(), QCString::setNum(), QDateTime::time(), writeEntry(), and QDate::year().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQRect\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a rectangle.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The rectangle value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1528 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQRect\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a rectangle.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The rectangle value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1535 of file kconfigbase.cpp.
.PP
References QRect::height(), QRect::left(), QCString::setNum(), QRect::top(), QRect::width(), and writeEntry().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQPoint\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a point.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The point value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1550 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQPoint\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a point.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The point value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1557 of file kconfigbase.cpp.
.PP
References QCString::setNum(), writeEntry(), QPoint::x(), and QPoint::y().
.SS "void KConfigBase::writeEntry (const \fBQString\fP & pKey, const \fBQSize\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a size.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The size value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1570 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writeEntry().
.SS "void KConfigBase::writeEntry (const char * pKey, const \fBQSize\fP & rValue, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a (key/value) pair. Same as above, but writes a size.
.PP
Note: Unlike the other \fBwriteEntry\fP() functions, the old value is _not_ returned here!
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIrValue\fP The size value to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1577 of file kconfigbase.cpp.
.PP
References QSize::height(), QCString::setNum(), QSize::width(), and writeEntry().
.SS "void KConfigBase::writePathEntry (const \fBQString\fP & pKey, const \fBQString\fP & path, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a file path. It is checked whether the path is located under $HOME. If so the path is written out with the user's home-directory replaced with $HOME. The path should be read back with \fBreadPathEntry\fP()
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpath\fP The path to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1070 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by writePathEntry().
.SS "void KConfigBase::writePathEntry (const char * pKey, const \fBQString\fP & path, bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
Writes a file path. It is checked whether the path is located under $HOME. If so the path is written out with the user's home-directory replaced with $HOME. The path should be read back with \fBreadPathEntry\fP()
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write. 
.br
\fIpath\fP The path to write. 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back. 
.RE
.PP
Definition at line 1127 of file kconfigbase.cpp.
.PP
References writeEntry().
.SS "void KConfigBase::writePathEntry (const \fBQString\fP & pKey, const \fBQStringList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwritePathEntry\fP() overridden to accept a list of paths (strings). It is checked whether the paths are located under $HOME. If so each of the paths are written out with the user's home-directory replaced with $HOME. The paths should be read back with \fBreadPathListEntry\fP()
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwritePathEntry()\fP 
.PP
\fBreadPathListEntry()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1.3 
.RE
.PP
Definition at line 1134 of file kconfigbase.cpp.
.PP
References QString::utf8(), and writePathEntry().
.SS "void KConfigBase::writePathEntry (const char * pKey, const \fBQStringList\fP & rValue, char sep = ',', bool bPersistent = true, bool bGlobal = false, bool bNLS = false)"
.PP
\fBwritePathEntry\fP() overridden to accept a list of paths (strings). It is checked whether the paths are located under $HOME. If so each of the paths are written out with the user's home-directory replaced with $HOME. The paths should be read back with \fBreadPathListEntry\fP()
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to write 
.br
\fIrValue\fP The list to write 
.br
\fIbPersistent\fP If \fCbPersistent\fP is false, the entry's dirty flag will not be set and thus the entry will not be written to disk at deletion time. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not saved to the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the locale tag is added to the key when writing it back.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBwritePathEntry()\fP 
.PP
\fBreadPathListEntry()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1.3 
.RE
.PP
Definition at line 1141 of file kconfigbase.cpp.
.PP
References QString::fromLatin1(), and writeEntry().
.SS "void KConfigBase::deleteEntry (const \fBQString\fP & pKey, bool bNLS = false, bool bGlobal = false)"
.PP
Deletes the entry specified by \fCpKey\fP in the current group. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to delete. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not removed from the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the key with the locale tag is removed. 
.RE
.PP
Definition at line 1160 of file kconfigbase.cpp.
.PP
References QString::utf8().
.PP
Referenced by KShortcutList::writeSettings().
.SS "void KConfigBase::deleteEntry (const char * pKey, bool bNLS = false, bool bGlobal = false)"
.PP
Deletes the entry specified by \fCpKey\fP in the current group. \fBParameters:\fP
.RS 4
\fIpKey\fP The key to delete. 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not removed from the application specific config file, but to the global \fBKDE\fP config file. 
.br
\fIbNLS\fP If \fCbNLS\fP is true, the key with the locale tag is removed. 
.RE
.PP
Definition at line 1167 of file kconfigbase.cpp.
.PP
References KEntry::bDeleted, KEntry::bDirty, KEntry::bGlobal, KEntry::bNLS, KGlobal::locale(), mGroup, putData(), setDirty(), and setLocale().
.SS "bool KConfigBase::deleteGroup (const \fBQString\fP & group, bool bDeep = true, bool bGlobal = false)"
.PP
Deletes a configuration entry group. If the group is not empty and bDeep is false, nothing gets deleted and false is returned. If this group is the current group and it is deleted, the current group is undefined and should be set with \fBsetGroup()\fP before the next operation on the configuration object.
.PP
\fBParameters:\fP
.RS 4
\fIgroup\fP The name of the group 
.br
\fIbDeep\fP Specify whether non-empty groups should be completely deleted (including their entries). 
.br
\fIbGlobal\fP If \fCbGlobal\fP is true, the pair is not removed from the application specific config file, but to the global \fBKDE\fP config file. 
.RE
.PP
\fBReturns:\fP
.RS 4
If the group is not empty and bDeep is false, deleteGroup returns false. 
.RE
.PP
Definition at line 1193 of file kconfigbase.cpp.
.PP
References QMap::begin(), QMap::end(), internalEntryMap(), QMap::isEmpty(), putData(), and setDirty().
.PP
Referenced by KShortcutList::writeSettings().
.SS "void KConfigBase::setDollarExpansion (bool _bExpand = true)\fC [inline]\fP"
.PP
Turns on or off 'dollar  expansion' (see KConfigBase introduction) when reading config entries. Dollar sign expansion is initially OFF.
.PP
\fBParameters:\fP
.RS 4
\fI_bExpand\fP Tf true, dollar expansion is turned on. 
.RE
.PP
Definition at line 1535 of file kconfigbase.h.
.SS "bool KConfigBase::isDollarExpansion () const\fC [inline]\fP"
.PP
Returns whether dollar expansion is on or off. It is initially OFF.
.PP
\fBReturns:\fP
.RS 4
true if dollar expansion is on. 
.RE
.PP
Definition at line 1542 of file kconfigbase.h.
.SS "void KConfigBase::rollback (bool bDeep = true)\fC [virtual]\fP"
.PP
Mark the config object as 'clean,' i.e. don't write dirty entries at destruction time. If \fCbDeep\fP is false, only the global dirty flag of the \fBKConfig\fP object gets cleared. If you then call \fBwriteEntry\fP() again, the global dirty flag is set again and all dirty entries will be written at a subsequent \fBsync\fP() call.
.PP
Classes that derive from KConfigBase should override this method and implement storage-specific behavior, as well as calling the \fBKConfigBase::rollback\fP() explicitly in the initializer.
.PP
\fBParameters:\fP
.RS 4
\fIbDeep\fP If true, the dirty flags of all entries are cleared, as well as the global dirty flag. 
.RE
.PP
Reimplemented in \fBKConfig\fP.
.PP
Definition at line 1668 of file kconfigbase.cpp.
.PP
References bDirty.
.PP
Referenced by KConfig::rollback(), and sync().
.SS "void KConfigBase::sync ()\fC [virtual]\fP"
.PP
Flushes all changes that currently reside only in memory back to disk / permanent storage. Dirty configuration entries are written to the most specific file available.
.PP
Asks the back end to flush out all pending writes, and then calls \fBrollback\fP(). No changes are made if the object has \fCreadOnly\fP status.
.PP
You should call this from your destructor in derivative classes.
.PP
\fBSee also:\fP
.RS 4
\fBrollback()\fP, \fBisReadOnly()\fP 
.RE
.PP
Reimplemented in \fBKSimpleConfig\fP.
.PP
Definition at line 1651 of file kconfigbase.cpp.
.PP
References backEnd, bDirty, isReadOnly(), rollback(), and KConfigBackEnd::sync().
.PP
Referenced by KShortcutList::writeSettings(), and KConfig::~KConfig().
.SS "bool KConfigBase::isDirty () const\fC [inline]\fP"
.PP
Checks whether the config file has any dirty (modified) entries. \fBReturns:\fP
.RS 4
true if the config file has any dirty (modified) entries. 
.RE
.PP
Definition at line 1579 of file kconfigbase.h.
.PP
References bDirty.
.PP
Referenced by KSimpleConfig::sync(), and KConfigINIBackEnd::sync().
.SS "virtual void KConfigBase::setReadOnly (bool _ro)\fC [inline, virtual]\fP"
.PP
Sets the config object's read-only status. \fBParameters:\fP
.RS 4
\fI_ro\fP If true, the config object will not write out any changes to disk even if it is destroyed or \fBsync\fP() is called. 
.RE
.PP
Definition at line 1588 of file kconfigbase.h.
.PP
Referenced by KConfig::KConfig(), KDesktopFile::KDesktopFile(), and KSimpleConfig::KSimpleConfig().
.SS "bool KConfigBase::isReadOnly () const\fC [inline]\fP"
.PP
Returns the read-only status of the config object. \fBReturns:\fP
.RS 4
The read-only status. 
.RE
.PP
Definition at line 1595 of file kconfigbase.h.
.PP
Referenced by KConfigINIBackEnd::parseConfigFiles(), KSimpleConfig::sync(), sync(), and KConfigINIBackEnd::writeConfigFile().
.SS "bool KConfigBase::hasKey (const \fBQString\fP & key) const"
.PP
Checks whether the key has an entry in the currently active group. Use this to determine whether a key is not specified for the current group (\fBhasKey()\fP returns false). Keys with null data are considered nonexistent.
.PP
\fBParameters:\fP
.RS 4
\fIpKey\fP The key to search for. 
.RE
.PP
\fBReturns:\fP
.RS 4
If true, the key is available. 
.RE
.PP
Definition at line 181 of file kconfigbase.cpp.
.PP
References KStdAccel::key().
.PP
Referenced by KLocale::languagesTwoAlpha(), readDateTimeEntry(), readListEntry(), and readPropertyEntry().
.SS "virtual \fBQMap\fP<\fBQString\fP, \fBQString\fP> KConfigBase::entryMap (const \fBQString\fP & group) const\fC [pure virtual]\fP"
.PP
Returns a map (tree) of entries for all entries in a particular group. Only the actual entry string is returned, none of the other internal data should be included.
.PP
\fBParameters:\fP
.RS 4
\fIgroup\fP A group to get keys from. 
.RE
.PP
\fBReturns:\fP
.RS 4
A map of entries in the group specified, indexed by key. The returned map may be empty if the group is not found. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQMap\fP 
.RE
.PP
Implemented in \fBKConfig\fP.
.SS "virtual void KConfigBase::reparseConfiguration ()\fC [pure virtual]\fP"
.PP
Reparses all configuration files. This is useful for programs that use stand alone graphical configuration tools. The base method implemented here only clears the group list and then appends the default group.
.PP
Derivative classes should clear any internal data structures and then simply call \fBparseConfigFiles\fP() when implementing this method.
.PP
\fBSee also:\fP
.RS 4
\fBparseConfigFiles()\fP 
.RE
.PP
Implemented in \fBKConfig\fP.
.SS "bool KConfigBase::isImmutable () const"
.PP
Checks whether this configuration file can be modified. \fBReturns:\fP
.RS 4
whether changes may be made to this configuration file. 
.RE
.PP
Definition at line 220 of file kconfigbase.cpp.
.PP
References getConfigState().
.SS "bool KConfigBase::groupIsImmutable (const \fBQString\fP & group) const"
.PP
Checks whether it is possible to change the given group. \fBParameters:\fP
.RS 4
\fIgroup\fP the group to check 
.RE
.PP
\fBReturns:\fP
.RS 4
whether changes may be made to \fCgroup\fP in this configuration file. 
.RE
.PP
Definition at line 225 of file kconfigbase.cpp.
.PP
References KEntry::bImmutable, getConfigState(), and lookupData().
.SS "bool KConfigBase::entryIsImmutable (const \fBQString\fP & key) const"
.PP
Checks whether it is possible to change the given entry. \fBParameters:\fP
.RS 4
\fIthe\fP key to check 
.RE
.PP
\fBReturns:\fP
.RS 4
whether the entry \fCkey\fP may be changed in the current group in this configuration file. 
.RE
.PP
Definition at line 235 of file kconfigbase.cpp.
.PP
References KEntry::bImmutable, KEntryKey::bLocal, KEntryKey::c_key, getConfigState(), KStdAccel::key(), lookupData(), and mGroup.
.SS "\fBKConfigBase::ConfigState\fP KConfigBase::getConfigState () const"
.PP
Returns the state of the app-config object. Possible return values are NoAccess (the application-specific config file could not be opened neither read-write nor read-only), ReadOnly (the application-specific config file is opened read-only, but not read-write) and ReadWrite (the application-specific config file is opened read-write).
.PP
\fBSee also:\fP
.RS 4
\fBConfigState()\fP 
.RE
.PP
\fBReturns:\fP
.RS 4
the state of the app-config object 
.RE
.PP
Definition at line 1662 of file kconfigbase.cpp.
.PP
References backEnd, ConfigState, and KConfigBackEnd::getConfigState().
.PP
Referenced by entryIsImmutable(), groupIsImmutable(), and isImmutable().
.SS "void KConfigBase::setLocale ()\fC [protected]\fP"
.PP
Reads the locale and put in the configuration data struct. Note that this should be done in the constructor, but this is not possible due to some mutual dependencies in \fBKApplication::init\fP() Definition at line 134 of file kconfigbase.cpp.
.PP
References aLocaleString, backEnd, KLocale::defaultLanguage(), KLocale::language(), KGlobal::locale(), KConfigBackEnd::setLocaleString(), and QString::utf8().
.PP
Referenced by deleteEntry(), parseConfigFiles(), readEntry(), and writeEntry().
.SS "virtual void KConfigBase::setDirty (bool _bDirty = true)\fC [inline, protected, virtual]\fP"
.PP
Sets the global dirty flag of the config object. \fBParameters:\fP
.RS 4
\fI_bDirty\fP How to mark the object's dirty status 
.RE
.PP
Definition at line 1691 of file kconfigbase.h.
.PP
References bDirty.
.PP
Referenced by deleteEntry(), deleteGroup(), and writeEntry().
.SS "void KConfigBase::parseConfigFiles ()\fC [protected, virtual]\fP"
.PP
Parses all configuration files for a configuration object. The actual parsing is done by the associated \fBKConfigBackEnd\fP. Definition at line 1639 of file kconfigbase.cpp.
.PP
References backEnd, KConfigBackEnd::getConfigState(), KConfigBackEnd::parseConfigFiles(), and setLocale().
.PP
Referenced by KConfig::reparseConfiguration().
.SS "virtual \fBKEntryMap\fP KConfigBase::internalEntryMap (const \fBQString\fP & pGroup) const\fC [protected, pure virtual]\fP"
.PP
Returns a map (tree) of the entries in the specified group. This may or may not return all entries that belong to the config object. The only guarantee that you are given is that any entries that are dirty (i.e. modified and not yet written back to the disk) will be contained in the map. Some derivative classes may choose to return everything.
.PP
Do not use this function, the implementation / return type are subject to change.
.PP
\fBParameters:\fP
.RS 4
\fIpGroup\fP The group to provide a KEntryMap for. 
.RE
.PP
\fBReturns:\fP
.RS 4
The map of the entries in the group. 
.RE
.PP
Implemented in \fBKConfig\fP.
.PP
Referenced by KConfigINIBackEnd::writeConfigFile().
.SS "virtual \fBKEntryMap\fP KConfigBase::internalEntryMap () const\fC [protected, pure virtual]\fP"
.PP
Returns a map (tree) of the entries in the tree. Do not use this function, the implementation / return type are subject to change.
.PP
\fBReturns:\fP
.RS 4
A map of the entries in the tree. 
.RE
.PP
Implemented in \fBKConfig\fP.
.PP
Referenced by deleteGroup().
.SS "virtual void KConfigBase::putData (const \fBKEntryKey\fP & _key, const \fBKEntry\fP & _data, bool _checkGroup = true)\fC [protected, pure virtual]\fP"
.PP
Inserts a (key/value) pair into the internal storage mechanism of the configuration object. Classes that derive from KConfigBase will need to implement this method in a storage-specific manner.
.PP
Do not use this function, the implementation / return type are subject to change.
.PP
\fBParameters:\fP
.RS 4
\fI_key\fP The key to insert. It contains information both on the group of the key and the key itself. If the key already exists, the old value will be replaced. 
.br
\fI_data\fP the \fBKEntry\fP that is to be stored. 
.br
\fI_checkGroup\fP When false, assume that the group already exists. 
.RE
.PP
Implemented in \fBKConfig\fP.
.PP
Referenced by deleteEntry(), deleteGroup(), KConfigINIBackEnd::parseSingleConfigFile(), and writeEntry().
.SS "virtual \fBKEntry\fP KConfigBase::lookupData (const \fBKEntryKey\fP & _key) const\fC [protected, pure virtual]\fP"
.PP
Looks up an entry in the config object's internal structure. Classes that derive from KConfigBase will need to implement this method in a storage-specific manner.
.PP
Do not use this function, the implementation and return type are subject to change.
.PP
\fBParameters:\fP
.RS 4
\fI_key\fP The key to look up It contains information both on the group of the key and the entry's key itself. 
.RE
.PP
\fBReturns:\fP
.RS 4
The \fBKEntry\fP value (data) found for the key. \fCKEntry.aValue\fP will be the null string if nothing was located. 
.RE
.PP
Implemented in \fBKConfig\fP.
.PP
Referenced by entryIsImmutable(), groupIsImmutable(), KConfigINIBackEnd::parseSingleConfigFile(), and readEntry().
.SS "void KConfigBase::setGroup (const \fBQCString\fP & pGroup)"
.PP
Overloaded public methods:. Definition at line 164 of file kconfigbase.cpp.
.PP
References mGroup.
.SH "Member Data Documentation"
.PP 
.SS "\fBKConfigBackEnd\fP* \fBKConfigBase::backEnd\fP\fC [protected]\fP"
.PP
A back end for loading/saving to disk in a particular format. Definition at line 1768 of file kconfigbase.h.
.PP
Referenced by KDesktopFile::fileName(), getConfigState(), KConfig::KConfig(), KDesktopFile::KDesktopFile(), KSimpleConfig::KSimpleConfig(), parseConfigFiles(), KDesktopFile::resource(), KConfig::setFileWriteMode(), setLocale(), KSimpleConfig::sync(), sync(), and KConfig::~KConfig().
.SS "\fBQCString\fP \fBKConfigBase::mGroup\fP\fC [protected]\fP"
.PP
The currently selected group. Definition at line 1784 of file kconfigbase.h.
.PP
Referenced by deleteEntry(), entryIsImmutable(), group(), readEntry(), setDesktopGroup(), setGroup(), and writeEntry().
.SS "\fBQCString\fP \fBKConfigBase::aLocaleString\fP\fC [protected]\fP"
.PP
The locale to retrieve keys under if possible, i.e en_US or fr. Definition at line 1788 of file kconfigbase.h.
.PP
Referenced by locale(), and setLocale().
.SS "bool \fBKConfigBase::bDirty\fP\fC [protected]\fP"
.PP
Indicates whether there are any dirty entries in the config object that need to be written back to disk. Definition at line 1793 of file kconfigbase.h.
.PP
Referenced by isDirty(), rollback(), setDirty(), and sync().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdecore Library from the source code.
