You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdegraphics/kpovmodeler/pmdocumentationmap.h

139 lines
3.4 KiB

//-*-C++-*-
/*
**************************************************************************
description
--------------------
copyright : (C) 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 PMDOCUMENTATIONMAP_H
#define PMDOCUMENTATIONMAP_H
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include <qstring.h>
#include <qmap.h>
#include <qptrlist.h>
#include <qvaluelist.h>
#include <kstaticdeleter.h>
class KConfig;
class QDomElement;
/**
* Class used internally by @ref PMDocumentationMap
*/
class PMDocumentationVersion
{
public:
/**
* Constructor
*/
PMDocumentationVersion( ) { }
/**
* Destructor
*/
~PMDocumentationVersion( ) { }
QString version( ) const { return m_version; }
void setVersion( const QString& str ) { m_version = str; }
QString index( ) const { return m_index; }
void setIndex( const QString& str ) { m_index = str; }
QString documentation( const QString& className ) const;
void loadData( QDomElement& e );
private:
QString m_version;
QString m_index;
QMap< QString, QString > m_map;
};
/**
* Class that maps the class name to the corresponding povray
* user documentation file
*/
class PMDocumentationMap
{
public:
/**
* Destructor
*/
~PMDocumentationMap( );
/**
* Returns the map instance (singleton)
*/
static PMDocumentationMap* theMap( );
/**
* Sets the path to the povray user documentation
*/
void setPovrayDocumentationPath( const QString& s )
{
m_documentationPath = s;
}
/**
* Returns the path to the povray user documentation
*/
QString povrayDocumentationPath( )
{
return m_documentationPath;
}
/**
* Sets the povray documentation version
*/
void setDocumentationVersion( const QString& str );
/**
* Returns the povray documentation version
*/
QString documentationVersion( ) const { return m_currentVersion; }
/**
* Returns the list of available documentation versions
*/
QValueList<QString> availableVersions( );
/**
* Returns the povray documentation file for the
* given object type
*/
QString documentation( const QString& objectName );
void saveConfig( KConfig* cfg );
void restoreConfig( KConfig* cfg );
private:
/**
* Constructor
*/
PMDocumentationMap( );
void loadMap( );
void findVersion( );
QString m_documentationPath;
bool m_mapLoaded;
QPtrList< PMDocumentationVersion > m_maps;
PMDocumentationVersion* m_pCurrentVersion;
QString m_currentVersion;
static PMDocumentationMap* s_pInstance;
static KStaticDeleter<PMDocumentationMap> s_staticDeleter;
};
#endif