src/core/qgsproject.h

Go to the documentation of this file.

/***************************************************************************
                                  qgsproject.h

                      Implements persistent project state.

                              -------------------
  begin                : July 23, 2004
  copyright            : (C) 2004 by Mark Coletti
  email                : mcoletti at gmail.com
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/
/* $Id$ */

#ifndef QGSPROJECT_H
#define QGSPROJECT_H

#include <memory>
#include "qgsprojectversion.h"
#include <QObject>
#include <QList>
#include <QPair>

//#include <QDomDocument>

class QFileInfo;
class QDomDocument;
class QDomNode;

class QgsProjectBadLayerHandler;

class CORE_EXPORT QgsProject : public QObject
{
    Q_OBJECT

  public:

    ~QgsProject();

    static QgsProject * instance();

    void title( QString const & title );

    QString const & title() const;

    bool isDirty() const;

    void dirty( bool b );


    void setFileName( QString const & name );

    QString fileName() const;


    bool read( QFileInfo const & file );
    bool read( );


    bool read( QDomNode & layerNode );


    bool write( QFileInfo const & file );
    bool write( );


    // DEPRECATED typedef QPair< QString, QVariant >  PropertyValue;
    // DEPRECATED typedef QValueList< PropertyValue > Properties;

    // DEPRECATED Properties & properties( QString const & scope );

    void clearProperties();


    /* key value mutators

      keys would be the familiar QSettings-like '/' delimited entries, implying
      a hierarchy of keys and corresponding values

      @note The key string <em>must</em> include '/'s.  E.g., "/foo" not "foo".
    */
    bool writeEntry( QString const & scope, const QString & key, bool value );
    bool writeEntry( QString const & scope, const QString & key, double value );
    bool writeEntry( QString const & scope, const QString & key, int value );
    bool writeEntry( QString const & scope, const QString & key, const QString & value );
    bool writeEntry( QString const & scope, const QString & key, const QStringList & value );

    QStringList readListEntry( QString const & scope, const QString & key, bool * ok = 0 ) const;

    QString readEntry( QString const & scope, const QString & key, const QString & def = QString::null, bool * ok = 0 ) const;
    int readNumEntry( QString const & scope, const QString & key, int def = 0, bool * ok = 0 ) const;
    double readDoubleEntry( QString const & scope, const QString & key, double def = 0, bool * ok = 0 ) const;
    bool readBoolEntry( QString const & scope, const QString & key, bool def = false, bool * ok = 0 ) const;


    bool removeEntry( QString const & scope, const QString & key );


    QStringList entryList( QString const & scope, QString const & key ) const;

    QStringList subkeyList( QString const & scope, QString const & key ) const;


    void dumpProperties() const;


    QString writePath( QString filename ) const;

    QString readPath( QString filename ) const;

    QString error() const;

    void setBadLayerHandler( QgsProjectBadLayerHandler* handler );

  protected:

    void setError( QString errorMessage );

    void clearError();

  signals:

    void readProject( const QDomDocument & );

    void writeProject( QDomDocument & );

    void oldProjectVersionWarning( QString );

    // @param i current layer
    // @param n number of layers
    void layerLoaded( int i, int n );

  private:

    QgsProject(); // private 'cause it's a singleton

    QgsProject( QgsProject const & ); // private 'cause it's a singleton

    struct Imp;

    std::auto_ptr<Imp> imp_;

    static QgsProject * theProject_;

    QPair< bool, QList<QDomNode> > _getMapLayers( QDomDocument const &doc );

    QString mErrorMessage;

    QgsProjectBadLayerHandler* mBadLayerHandler;

}; // QgsProject


class CORE_EXPORT QgsProjectBadLayerHandler
{
  public:
    virtual void handleBadLayers( QList<QDomNode> layers, QDomDocument projectDom ) = 0;
    virtual ~QgsProjectBadLayerHandler() {}
};


class CORE_EXPORT QgsProjectBadLayerDefaultHandler : public QgsProjectBadLayerHandler
{
  public:
    virtual void handleBadLayers( QList<QDomNode> layers, QDomDocument projectDom );

};

#endif