qgscolorscheme.h

Go to the documentation of this file.

/***************************************************************************
                             qgscolorscheme.h
                             -------------------
    begin                : July 2014
    copyright            : (C) 2014 by Nyall Dawson
    email                : nyall dot dawson at gmail dot 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.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef QGSCOLORSCHEME_H
#define QGSCOLORSCHEME_H

#include <QString>
#include <QColor>
#include <QPair>

typedef QList< QPair< QColor, QString > > QgsNamedColorList;

class CORE_EXPORT QgsColorScheme
{
  public:

    enum SchemeFlag
    {
      ShowInColorDialog = 0x01, /*< show scheme in color picker dialog */
      ShowInColorButtonMenu = 0x02, /*< show scheme in color button drop down menu */
      ShowInAllContexts = ShowInColorDialog | ShowInColorButtonMenu /*< show scheme in all contexts */
    };
    Q_DECLARE_FLAGS( SchemeFlags, SchemeFlag )

    QgsColorScheme();

    virtual ~QgsColorScheme();

    virtual QString schemeName() const = 0;

    virtual SchemeFlags flags() const { return ShowInColorDialog; }

    virtual QgsNamedColorList fetchColors( const QString context = QString(),
                                           const QColor baseColor = QColor() ) = 0;

    virtual bool isEditable() const { return false; }

    virtual bool setColors( const QgsNamedColorList colors, const QString context = QString(), const QColor baseColor = QColor() );

    virtual QgsColorScheme* clone() const = 0;
};

Q_DECLARE_OPERATORS_FOR_FLAGS( QgsColorScheme::SchemeFlags )


class CORE_EXPORT QgsGplColorScheme : public QgsColorScheme
{
  public:

    QgsGplColorScheme();

    virtual ~QgsGplColorScheme();

    virtual QgsNamedColorList fetchColors( const QString context = QString(),
                                           const QColor baseColor = QColor() );

    virtual bool setColors( const QgsNamedColorList colors, const QString context = QString(), const QColor baseColor = QColor() );

  protected:

    virtual QString gplFilePath() = 0;

};

class CORE_EXPORT QgsUserColorScheme : public QgsGplColorScheme
{
  public:

    QgsUserColorScheme( const QString filename );

    virtual ~QgsUserColorScheme();

    virtual QString schemeName() const;

    virtual QgsColorScheme* clone() const;

    virtual bool isEditable() const { return true; }

    void setName( const QString name ) { mName = name; }

    bool erase();

  protected:

    QString mName;

    QString mFilename;

    virtual QString gplFilePath();

};

class CORE_EXPORT QgsRecentColorScheme : public QgsColorScheme
{
  public:

    QgsRecentColorScheme();

    virtual ~QgsRecentColorScheme();

    virtual QString schemeName() const { return QT_TR_NOOP( "Recent colors" ); }

    virtual SchemeFlags flags() const { return ShowInAllContexts; }

    virtual QgsNamedColorList fetchColors( const QString context = QString(),
                                           const QColor baseColor = QColor() );

    QgsColorScheme* clone() const;
};

class CORE_EXPORT QgsCustomColorScheme : public QgsColorScheme
{
  public:

    QgsCustomColorScheme();

    virtual ~QgsCustomColorScheme();

    virtual QString schemeName() const { return QT_TR_NOOP( "Standard colors" ); }

    virtual SchemeFlags flags() const { return ShowInAllContexts; }

    virtual QgsNamedColorList fetchColors( const QString context = QString(),
                                           const QColor baseColor = QColor() );

    virtual bool isEditable() const { return true; }

    virtual bool setColors( const QgsNamedColorList colors, const QString context = QString(), const QColor baseColor = QColor() );

    QgsColorScheme* clone() const;
};

class CORE_EXPORT QgsProjectColorScheme : public QgsColorScheme
{
  public:

    QgsProjectColorScheme();

    virtual ~QgsProjectColorScheme();

    virtual QString schemeName() const { return QT_TR_NOOP( "Project colors" ); }

    virtual SchemeFlags flags() const { return ShowInAllContexts; }

    virtual QgsNamedColorList fetchColors( const QString context = QString(),
                                           const QColor baseColor = QColor() );

    virtual bool isEditable() const { return true; }

    virtual bool setColors( const QgsNamedColorList colors, const QString context = QString(), const QColor baseColor = QColor() );

    QgsColorScheme* clone() const;
};

#endif