/*
**************************************************************************
                                 description
                             --------------------
    copyright            : (C) 2000-2002 by Andreas Zehender
    email                : zehender@kde.org
**************************************************************************

**************************************************************************
*                                                                        *
*  This program is free software; you can redistribute it and/or modify  *
*  it under the terms of the GNU General Public License as published by  *
*  the Free Software Foundation; either version 2 of the License, or     *
*  (at your option) any later version.                                   *
*                                                                        *
**************************************************************************/

#ifndef PMXMLHELPER_H
#define PMXMLHELPER_H

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <tqdom.h>
#include <tqstring.h>

#include "pmobject.h"
#include "pmcolor.h"
#include "pmvector.h"
#include "pmmatrix.h"

class PMPart;
class PMParser;

/**
 * Class for reading attributes out of a @ref TQDomElement
 */
class PMXMLHelper
{
public:
   /**
    * Creates a PMXMLHelper for the TQDomElement& e
    */
   PMXMLHelper( const TQDomElement& e, PMPart* p, PMParser* par,
                int majorDocumentFormat, int minorDocumentFormat );
   /**
    * Returns the TQDomElement
    */
   TQDomElement element( ) const { return m_e; }

   /**
    * Returns true if the element contains the attribute
    */
   bool hasAttribute( const TQString& name ) const;
   /**
    * Reads an integer attribute
    */
   int intAttribute( const TQString& name, int def ) const;
   /**
    * Reads a double attribute
    */
   double doubleAttribute( const TQString& name, double def ) const;
   /**
    * Reads a bool attribute
    */
   bool boolAttribute( const TQString& name, bool def ) const;
   /**
    * Reads a PMThreeState attribute
    */
   PMThreeState threeStateAttribute( const TQString& name ) const;
   /**
    * Reads a string attribute
    */
   TQString stringAttribute( const TQString& name, const TQString& def ) const;
   /**
    * Reads a vector attribute
    */
   PMVector vectorAttribute( const TQString& name, const PMVector& def ) const;
   /**
    * Reads a matrix attribute
    */
   PMMatrix matrixAttribute( const TQString& name, const PMMatrix& def ) const;
   /**
    * Reads a color attribute
    */
   PMColor colorAttribute( const TQString& name, const PMColor& def ) const;

   /**
    * Returns the "extra_data" child element or a null element, if there
    * is no child element with tag name "extra_data"
    */
   TQDomElement extraData( ) const;
       
   /**
    * Returns a pointer to the part
    */
   PMPart* part( ) const { return m_pPart; }
   /**
    * Returns a pointer to the parser
    */
   PMParser* parser( ) const { return m_pParser; }
   /**
    * Returns the documents major format number
    */
   int majorDocumentFormat( ) const { return m_major; }
   /**
    * Returns the documents minor format number
    */
   int minorDocumentFormat( ) const { return m_minor; }
   
private:
   TQDomElement m_e;
   PMPart* m_pPart;
   PMParser* m_pParser;
   int m_major;
   int m_minor;
};

#endif
