SettingGroup Class Reference

SettingGroup contains settings which are releated. More...

#include <settinggroup.h>

Collaboration diagram for SettingGroup:

Public Member Functions
	SettingGroup (QString name)
	Creates configuration variables using default avlues. More...
	~SettingGroup ()
	Destructor. More...
QString	getName ()
	Returns group's name. More...
QString	getValue (QString key)
	Returns a setting value. More...
void	setValue (QString key, QString value)
	Sets a setting value, create new setting if setting not found. More...
SettingGroup *	getNext ()
	returns the next groupsetting More...
void	setNext (SettingGroup *next)
	sets the next group setting More...
void	loadSettings (QDomNode &node)
void	saveSettings (Q3TextStream &stream)
	writes out this group to file More...
void	resetSetting (QString key)
	resets a setting to its default value More...

Private Attributes
QString	name
	groups identifying name More...
Setting *	firstSetting
	pointer to first setting in group More...
Setting *	lastSetting
	pointer to last setting in group More...
SettingGroup *	next
	pointer to next settingroup More...

Detailed Description

SettingGroup contains settings which are releated.

Definition at line 27 of file settinggroup.h.

Constructor & Destructor Documentation

SettingGroup()

SettingGroup::SettingGroup

(

QString

name

)

Creates configuration variables using default avlues.

Definition at line 21 of file settinggroup.cpp.

{
  this->name = name;
  firstSetting = NULL;
  lastSetting = NULL;
  next = NULL;
}

References firstSetting, lastSetting, name, and next.

~SettingGroup()

SettingGroup::~SettingGroup

(

)

Destructor.

Definition at line 29 of file settinggroup.cpp.

{
  Setting* cur = firstSetting;
  while(cur != NULL)
  {
    Setting* t = cur->getNext();
    delete cur;
    cur = t;
  }
}

References firstSetting, and Setting::getNext().

Member Function Documentation

getName()

QString SettingGroup::getName

(

)

Returns group's name.

Definition at line 40 of file settinggroup.cpp.

{
  return name;
}

References name.

Referenced by Configuration::getString(), Configuration::loadSettings(), Configuration::removeGroup(), Configuration::resetSetting(), saveSettings(), and Configuration::setString().

getNext()

SettingGroup * SettingGroup::getNext

(

)

returns the next groupsetting

Definition at line 94 of file settinggroup.cpp.

{
  return next;
}

References next.

Referenced by Configuration::getString(), Configuration::loadSettings(), Configuration::removeGroup(), Configuration::resetSetting(), Configuration::saveSettings(), Configuration::setString(), and Configuration::~Configuration().

getValue()

QString SettingGroup::getValue

(

QString

key

)

Returns a setting value.

Definition at line 45 of file settinggroup.cpp.

{
  Setting* cur = firstSetting;
  while(cur != NULL)
  {
    if(cur->getKey().compare(key) == 0)
    {
      return cur->getValue();
    }
    cur = cur->getNext();
  }
  return "-1";
}

References firstSetting, Setting::getKey(), Setting::getNext(), and Setting::getValue().

Referenced by Configuration::getString().

loadSettings()

void SettingGroup::loadSettings

(

QDomNode &

node

)

Definition at line 119 of file settinggroup.cpp.

{
  //iterate over all children (Settings)
  QDomNode node = root.firstChild();
  QDomText val;
  while( !node.isNull() )
  {
    if( node.isElement() && node.nodeName() == "setting" )
    {
      //find key and value, if either is missing move on to next setting
      QDomNamedNodeMap attributes = node.attributes();
      if(attributes.namedItem("key").isNull() || attributes.namedItem("value").isNull())
      {
        node = node.nextSibling();
        continue;
      }
 
 
      QString k = attributes.namedItem("key").nodeValue();
      QString v = attributes.namedItem("value").nodeValue();
 
      //key and value found -> add new setting
      setValue( attributes.namedItem("key").nodeValue(),
                    attributes.namedItem("value").nodeValue() );
    }
 
    //move on to next setting
    node = node.nextSibling();
  }
}

References setValue().

Referenced by Configuration::loadSettings().

resetSetting()

void SettingGroup::resetSetting

(

QString

key

)

resets a setting to its default value

Definition at line 59 of file settinggroup.cpp.

{
  Setting* cur = firstSetting;
  while(cur != NULL)
  {
    if(cur->getKey().compare(key) == 0)
    {
      cur->resetSetting();
    }
    cur = cur->getNext();
  }
}

References firstSetting, Setting::getKey(), Setting::getNext(), and Setting::resetSetting().

Referenced by Configuration::resetSetting().

saveSettings()

void SettingGroup::saveSettings

(

Q3TextStream &

stream

)

writes out this group to file

Definition at line 104 of file settinggroup.cpp.

{
  stream << "  <group name=\"" << getName() << "\">\n";
 
  //iterate over every setting
  Setting* cur = firstSetting;
  while(cur != NULL)
  {
    stream << "    <setting key=\"" << cur->getKey() << "\" value=\"" << cur->getValue() << "\"/>\n";
    cur = cur->getNext();
  }
 
  stream << "  </group>\n";
}

References firstSetting, Setting::getKey(), getName(), Setting::getNext(), and Setting::getValue().

Referenced by Configuration::saveSettings().

setNext()

void SettingGroup::setNext

(

SettingGroup *

next

)

sets the next group setting

Definition at line 99 of file settinggroup.cpp.

{
  this->next = next;
}

References next.

Referenced by Configuration::loadSettings(), Configuration::removeGroup(), and Configuration::setString().

setValue()

void SettingGroup::setValue	(	QString	key,
		QString	value
	)

Sets a setting value, create new setting if setting not found.

Definition at line 72 of file settinggroup.cpp.

{
  Setting* cur = firstSetting;
  while(cur != NULL)
  {
    if(cur->getKey().compare(key) == 0)
    {
      cur->setValue(value);
      return;
    }
    cur = cur->getNext();
  }
 
  //setting not found, create new one and append to list
  cur = new Setting(key, value);
  if(firstSetting == NULL)
    firstSetting = cur;
  else
    lastSetting->setNext(cur);
  lastSetting = cur;
}

References firstSetting, Setting::getKey(), Setting::getNext(), lastSetting, Setting::setNext(), and Setting::setValue().

Referenced by loadSettings(), and Configuration::setString().

Member Data Documentation

firstSetting

Setting* SettingGroup::firstSetting

private

pointer to first setting in group

Definition at line 66 of file settinggroup.h.

Referenced by getValue(), resetSetting(), saveSettings(), SettingGroup(), setValue(), and ~SettingGroup().

lastSetting

Setting* SettingGroup::lastSetting

private

pointer to last setting in group

Definition at line 69 of file settinggroup.h.

Referenced by SettingGroup(), and setValue().

name

QString SettingGroup::name

private

groups identifying name

Definition at line 63 of file settinggroup.h.

Referenced by getName(), and SettingGroup().

next

SettingGroup* SettingGroup::next

private

pointer to next settingroup

Definition at line 72 of file settinggroup.h.

Referenced by getNext(), setNext(), and SettingGroup().

---

The documentation for this class was generated from the following files:

• settinggroup.h
• settinggroup.cpp