KRootProp Class Reference

#include <krootprop.h>

List of all members.

Public Member Functions

 KRootProp (const QString &rProp=QString::null)
 ~KRootProp ()
void setProp (const QString &rProp=QString())
QString prop () const
void destroy ()
QString readEntry (const QString &rKey, const QString &pDefault=QString::null) const
int readNumEntry (const QString &rKey, int nDefault=0) const
QFont readFontEntry (const QString &rKey, const QFont *pDefault=0) const
QColor readColorEntry (const QString &rKey, const QColor *pDefault=0) const
QString writeEntry (const QString &rKey, const QString &rValue)
QString writeEntry (const QString &rKey, int nValue)
QString writeEntry (const QString &rKey, const QFont &rFont)
QString writeEntry (const QString &rKey, const QColor &rColor)
QString removeEntry (const QString &rKey)
QStringList listEntries () const
void sync ()

Detailed Description

Access KDE desktop resources stored on the root window.

A companion to the KConfig class.

The KRootProp class is used for reading and writing configuration entries to properties on the root window.

All configuration entries are of the form "key=value".

See also:
KConfig::KConfig
Author:
Mark Donohoe (donohe@kde.org)

Definition at line 46 of file krootprop.h.


Constructor & Destructor Documentation

KRootProp::KRootProp ( const QString rProp = QString::null)

Constructs a KRootProp object for the property rProp.

Parameters:
rPropthe property that will be searched, null to do nothing
See also:
setProp()

Destructs the KRootProp object.

Writes back any dirty configuration entries.


Member Function Documentation

Destroys the property completely.

I.e. all entries will be cleared and the property will be removed from the root window.

Returns a list of all keys.

Returns:
A QStringList containing all the keys.

Returns the name of the property under which keys are searched.

Returns:
the property that will be searched
QColor KRootProp::readColorEntry ( const QString rKey,
const QColor pDefault = 0 
) const

Reads a QColor.

Reads the value of an entry specified by rKey in the current property and interprets it as a color.

Parameters:
rKeyThe key to search for.
pDefaultA default value returned if the key was not found.
Returns:
The value for this key or a default color if no value was found.
QString KRootProp::readEntry ( const QString rKey,
const QString pDefault = QString::null 
) const

Reads the value of an entry specified by rKey in the current property.

Parameters:
rKeyThe key to search for.
pDefaultA default value returned if the key was not found.
Returns:
The value for this key or the default if no value was found.
QFont KRootProp::readFontEntry ( const QString rKey,
const QFont pDefault = 0 
) const

Reads a QFont value.

Reads the value of an entry specified by rKey in the current property and interpret it as a font object.

Parameters:
rKeyThe key to search for.
pDefaultA default value returned if the key was not found.
Returns:
The value for this key or a default font if no value was found.
int KRootProp::readNumEntry ( const QString rKey,
int  nDefault = 0 
) const

Reads a numerical value.

Reads the value of an entry specified by rKey in the current property and interprets it numerically.

Parameters:
rKeyThe key to search for.
nDefaultA default value returned if the key was not found.
Returns:
The value for this key or the default if no value was found.

Removes an entry.

Parameters:
rKeyThe key to remove.
Returns:
The old value for this key. If this key did not exist, a null string is returned.
void KRootProp::setProp ( const QString rProp = QString())

Sets the property in which keys will be searched.

Parameters:
rPropthe property that will be searched
void KRootProp::sync ( )

Flushes the entry cache.

Writes back dirty configuration entries to the current property, This is called automatically from the destructor.

QString KRootProp::writeEntry ( const QString rKey,
const QString rValue 
)

Writes a (key/value) pair.

This is stored to the current property when destroying the config object or when calling sync().

Parameters:
rKeyThe key to write.
rValueThe value to write.
Returns:
The old value for this key. If this key did not exist, a null string is returned.
QString KRootProp::writeEntry ( const QString rKey,
int  nValue 
)

Writes the (key/value) pair.

Same as above, but writes a numerical value.

Parameters:
rKeyThe key to write.
nValueThe value to write.
Returns:
The old value for this key. If this key did not exist, a null string is returned.
QString KRootProp::writeEntry ( const QString rKey,
const QFont rFont 
)

Writes the (key/value) pair.

Same as above, but writes a font.

Parameters:
rKeyThe key to write.
rFontThe font to write.
Returns:
The old value for this key. If this key did not exist, a null string is returned.
QString KRootProp::writeEntry ( const QString rKey,
const QColor rColor 
)

Writes the (key/value) pair.

Same as above, but writes a color.

Parameters:
rKeyThe key to write.
rColorThe color to write.
Returns:
The old value for this key. If this key did not exist, a null string is returned.

The documentation for this class was generated from the following file:
KDE Home | KDE Accessibility Home | Description of Access Keys