• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • tdecore
 

tdecore

KRootProp Class Reference

Access KDE desktop resources stored on the root window. More...

#include <krootprop.h>

List of all members.

Public Member Functions

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

Detailed Description

Access KDE desktop resources stored on the root window.

A companion to the TDEConfig 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:
TDEConfig::TDEConfig
Author:
Mark Donohoe (donohe@kde.org)

Definition at line 46 of file krootprop.h.


Constructor & Destructor Documentation

KRootProp::KRootProp ( const TQString &  rProp = TQString::null  ) 

Constructs a KRootProp object for the property rProp.

Parameters:
rProp the property that will be searched, null to do nothing
See also:
setProp()
KRootProp::~KRootProp (  ) 

Destructs the KRootProp object.

Writes back any dirty configuration entries.


Member Function Documentation

void KRootProp::destroy (  ) 

Destroys the property completely.

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

TQStringList KRootProp::listEntries (  )  const

Returns a list of all keys.

Returns:
A TQStringList containing all the keys.
TQString KRootProp::prop (  )  const

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

Returns:
the property that will be searched
TQColor KRootProp::readColorEntry ( const TQString &  rKey,
const TQColor *  pDefault = 0 
) const

Reads a TQColor.

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

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

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

Parameters:
rKey The key to search for.
pDefault A default value returned if the key was not found.
Returns:
The value for this key or the default if no value was found.
TQFont KRootProp::readFontEntry ( const TQString &  rKey,
const TQFont *  pDefault = 0 
) const

Reads a TQFont value.

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

Parameters:
rKey The key to search for.
pDefault A 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 TQString &  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:
rKey The key to search for.
nDefault A default value returned if the key was not found.
Returns:
The value for this key or the default if no value was found.
TQString KRootProp::removeEntry ( const TQString &  rKey  ) 

Removes an entry.

Parameters:
rKey The 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 TQString &  rProp = TQString()  ) 

Sets the property in which keys will be searched.

Parameters:
rProp the 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.

TQString KRootProp::writeEntry ( const TQString &  rKey,
const TQColor &  rColor 
)

Writes the (key/value) pair.

Same as above, but writes a color.

Parameters:
rKey The key to write.
rColor The color to write.
Returns:
The old value for this key. If this key did not exist, a null string is returned.
TQString KRootProp::writeEntry ( const TQString &  rKey,
const TQFont &  rFont 
)

Writes the (key/value) pair.

Same as above, but writes a font.

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

Writes the (key/value) pair.

Same as above, but writes a numerical value.

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

Writes a (key/value) pair.

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

Parameters:
rKey The key to write.
rValue The value 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:
  • krootprop.h

tdecore

Skip menu "tdecore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

tdecore

Skip menu "tdecore"
  • arts
  • dcop
  • dnssd
  • interfaces
  •   kspeech
  •     interface
  •     library
  •   tdetexteditor
  • kate
  • kded
  • kdoctools
  • kimgio
  • kjs
  • libtdemid
  • libtdescreensaver
  • tdeabc
  • tdecmshell
  • tdecore
  • tdefx
  • tdehtml
  • tdeinit
  • tdeio
  •   bookmarks
  •   httpfilter
  •   kpasswdserver
  •   kssl
  •   tdefile
  •   tdeio
  •   tdeioexec
  • tdeioslave
  •   http
  • tdemdi
  •   tdemdi
  • tdenewstuff
  • tdeparts
  • tdeprint
  • tderandr
  • tderesources
  • tdespell2
  • tdesu
  • tdeui
  • tdeunittest
  • tdeutils
  • tdewallet
Generated for tdecore by doxygen 1.6.3
This website is maintained by Timothy Pearson.