qgslayoutitemattributetable.h

Go to the documentation of this file.

/***************************************************************************
                         qgslayoutitemattributetable.h
                         ---------------------------
    begin                : November 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 QGSLAYOUTITEMATTRIBUTETABLE_H
#define QGSLAYOUTITEMATTRIBUTETABLE_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgslayoutitemmap.h"
#include "qgslayouttable.h"
#include "qgsvectorlayerref.h"
 
class QgsVectorLayer;

class CORE_EXPORT QgsLayoutItemAttributeTable : public QgsLayoutTable
{
    Q_OBJECT
 
  public:
    enum ContentSource
    {
      LayerAttributes = 0, 
      AtlasFeature,        
      RelationChildren     
    };

    QgsLayoutItemAttributeTable( QgsLayout *layout SIP_TRANSFERTHIS );
 
    int type() const override;
    QIcon icon() const override;
    QString displayName() const override;

    static QgsLayoutItemAttributeTable *create( QgsLayout *layout ) SIP_FACTORY;

    void setSource( ContentSource source );

    ContentSource source() const { return mSource; }

    QgsVectorLayer *sourceLayer() const;

    void setVectorLayer( QgsVectorLayer *layer );

    QgsVectorLayer *vectorLayer() const { return mVectorLayer.get(); }

    void setRelationId( const QString &id );

    QString relationId() const { return mRelationId; }

    void resetColumns();

    void setMap( QgsLayoutItemMap *map );

    QgsLayoutItemMap *map() const { return mMap; }

    void setMaximumNumberOfFeatures( int features );

    int maximumNumberOfFeatures() const { return mMaximumNumberOfFeatures; }

    void setUniqueRowsOnly( bool uniqueOnly );

    bool uniqueRowsOnly() const { return mShowUniqueRowsOnly; }

    void setDisplayOnlyVisibleFeatures( bool visibleOnly );

    bool displayOnlyVisibleFeatures() const { return mShowOnlyVisibleFeatures; }

    void setFilterToAtlasFeature( bool filterToAtlas );

    bool filterToAtlasFeature() const { return mFilterToAtlasIntersection; }

    bool filterFeatures() const { return mFilterFeatures; }

    void setFilterFeatures( bool filter );

    QString featureFilter() const { return mFeatureFilter; }

    void setFeatureFilter( const QString &expression );

    void setDisplayedFields( const QStringList &fields, bool refresh = true );

    void setWrapString( const QString &wrapString );

    QString wrapString() const { return mWrapString; }

    bool getTableContents( QgsLayoutTableContents &contents ) override;
 
    QgsConditionalStyle conditionalCellStyle( int row, int column ) const override;
    QgsTextFormat textFormatForCell( int row, int column ) const override;
    QgsExpressionContextScope *scopeForCell( int row, int column ) const override SIP_FACTORY;
 
    QgsExpressionContext createExpressionContext() const override;
    void finalizeRestoreFromXml() override;
 
    void refreshDataDefinedProperty( QgsLayoutObject::DataDefinedProperty property = QgsLayoutObject::DataDefinedProperty::AllProperties ) override;

    bool useConditionalStyling() const;

    void setUseConditionalStyling( bool enabled );
 
  protected:
    bool writePropertiesToElement( QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context ) const override;
    bool readPropertiesFromElement( const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context ) override;
 
  private slots:
 
    void disconnectCurrentMap();
 
  private:
    ContentSource mSource = LayerAttributes;
    QgsVectorLayerRef mVectorLayer = nullptr;

    QPointer< QgsVectorLayer > mDataDefinedVectorLayer;

    QString mRelationId;

    QgsVectorLayer *mCurrentAtlasLayer = nullptr;

    QPointer< QgsLayoutItemMap > mMap = nullptr;
    QString mMapUuid;

    int mMaximumNumberOfFeatures = 30;

    bool mShowUniqueRowsOnly = false;

    bool mShowOnlyVisibleFeatures = false;

    bool mFilterToAtlasIntersection = false;

    bool mFilterFeatures = false;

    QString mFeatureFilter;
 
    QString mWrapString;
 
    bool mUseConditionalStyling = false;
 
    QList< QList< QgsConditionalStyle > > mConditionalStyles;
    QList< QgsFeature > mFeatures;
    QMap<QString, QVariant> mLayerCache;
 
    struct Cell
    {
        Cell() = default;
 
        Cell( const QVariant &content, const QgsConditionalStyle &style, const QgsFeature &feature )
          : content( content )
          , style( style )
          , feature( feature )
        {}
        QVariant content;
        QgsConditionalStyle style;
        QgsFeature feature;
    };

    QList<int> fieldsToDisplay() const;

    void restoreFieldAliasMap( const QMap<int, QString> &map );

    QVariant replaceWrapChar( const QVariant &variant ) const;
 
#ifdef HAVE_SERVER_PYTHON_PLUGINS

    QgsLayoutTableColumns filteredColumns();
#endif
 
  private slots:
    void removeLayer( const QString &layerId );
 
    void atlasLayerChanged( QgsVectorLayer *layer );
};
 
#endif // QGSLAYOUTITEMATTRIBUTETABLE_H