qgslayoutobject.h

Go to the documentation of this file.

/***************************************************************************
                         qgslayoutobject.h
                             -------------------
    begin                : June 2017
    copyright            : (C) 2017 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 QGSLAYOUTOBJECT_H
#define QGSLAYOUTOBJECT_H

#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgspropertycollection.h"
#include "qgsobjectcustomproperties.h"
#include "qgsexpressioncontextgenerator.h"
#include <QObject>
#include <QDomNode>
#include <QMap>
#include <QPointer>

class QgsLayout;
class QPainter;
class QgsReadWriteContext;

class CORE_EXPORT QgsLayoutObject: public QObject, public QgsExpressionContextGenerator
{
    Q_OBJECT
  public:

    enum DataDefinedProperty
    {
      NoProperty = 0, 
      AllProperties, 
      TestProperty, 
      //composer page properties
      PresetPaperSize, 
      PaperWidth, 
      PaperHeight, 
      NumPages, 
      PaperOrientation, 
      //general composer item properties
      PageNumber, 
      PositionX, 
      PositionY, 
      ItemWidth, 
      ItemHeight, 
      ItemRotation, 
      Transparency, 
      Opacity, 
      BlendMode, 
      ExcludeFromExports, 
      FrameColor, 
      BackgroundColor, 
      //composer map
      MapRotation, 
      MapScale, 
      MapXMin, 
      MapYMin, 
      MapXMax, 
      MapYMax, 
      MapAtlasMargin, 
      MapLayers, 
      MapStylePreset, 
      //composer picture
      PictureSource, 
      PictureSvgBackgroundColor, 
      PictureSvgStrokeColor, 
      PictureSvgStrokeWidth, 
      //html item
      SourceUrl, 
      //legend item
      LegendTitle, 
      LegendColumnCount, 
      //scalebar item
      ScalebarFillColor, 
      ScalebarFillColor2, 
      ScalebarLineColor, 
      ScalebarLineWidth, 
    };

    enum PropertyValueType
    {
      EvaluatedValue = 0, 
      OriginalValue 
    };

    static const QgsPropertiesDefinition &propertyDefinitions();

    explicit QgsLayoutObject( QgsLayout *layout );

    SIP_SKIP const QgsLayout *layout() const;

    QgsLayout *layout();

    QgsPropertyCollection &dataDefinedProperties() { return mDataDefinedProperties; }

    const QgsPropertyCollection &dataDefinedProperties() const { return mDataDefinedProperties; } SIP_SKIP

    void setDataDefinedProperties( const QgsPropertyCollection &collection ) { mDataDefinedProperties = collection; }


    void setCustomProperty( const QString &key, const QVariant &value );

    QVariant customProperty( const QString &key, const QVariant &defaultValue = QVariant() ) const;

    void removeCustomProperty( const QString &key );

    QStringList customProperties() const;

    QgsExpressionContext createExpressionContext() const override;

  public slots:

    virtual void refresh() {}

  signals:

    void changed();

  protected:

    bool writeObjectPropertiesToElement( QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context ) const;

    bool readObjectPropertiesFromElement( const QDomElement &parentElement, const QDomDocument &document, const QgsReadWriteContext &context );

    QPointer< QgsLayout > mLayout;

    QgsPropertyCollection mDataDefinedProperties;

    QgsObjectCustomProperties mCustomProperties;

  private:

    static QgsPropertiesDefinition sPropertyDefinitions;

    static void initPropertyDefinitions();

    friend class TestQgsLayoutObject;
    friend class QgsCompositionConverter;
};

#endif //QGSLAYOUTOBJECT_H