qgsattributeeditorcontext.h

Go to the documentation of this file.

/***************************************************************************
    qgsattributeeditorcontext.h
     --------------------------------------
    Date                 : 30.7.2013
    Copyright            : (C) 2013 Matthias Kuhn
    Email                : matthias at opengis dot ch
 ***************************************************************************
 *                                                                         *
 *   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 QGSATTRIBUTEEDITORCONTEXT_H
#define QGSATTRIBUTEEDITORCONTEXT_H
 
#include "qgis_gui.h"
#include "qgsdistancearea.h"
#include "qgsproject.h"
#include "qgsvectorlayer.h"
#include "qgsvectorlayertools.h"
 
#include <QMap>
#include <QMetaEnum>
#include <QWidget>
 
class QgsMapCanvas;
class QgsAdvancedDigitizingDockWidget;
class QgsMessageBar;

 
class GUI_EXPORT QgsAttributeEditorContext
{
    Q_GADGET
 
  public:
    enum Mode
    {
      SingleEditMode,      
      AddFeatureMode,      
      FixAttributeMode,    
      MultiEditMode,       
      SearchMode,          
      AggregateSearchMode, 
      IdentifyMode,        
      PreviewMode          
    };
    Q_ENUM( Mode )
 
    
    enum RelationMode
    {
      Undefined, 
      Multiple,  
      Single     
    };
 
    enum FormMode
    {
      Embed,            
      StandaloneDialog, 
      Popup             
    };
 
    QgsAttributeEditorContext() = default;
 
    QgsAttributeEditorContext( const QgsAttributeEditorContext &parentContext, FormMode formMode )
      : mParentContext( &parentContext )
      , mVectorLayerTools( parentContext.mVectorLayerTools )
      , mMapCanvas( parentContext.mMapCanvas )
      , mMainMessageBar( parentContext.mMainMessageBar )
      , mCadDockWidget( parentContext.mCadDockWidget )
      , mDistanceArea( parentContext.mDistanceArea )
      , mFormFeature( parentContext.mFormFeature )
      , mFormMode( formMode )
    {
      Q_ASSERT( parentContext.vectorLayerTools() );
    }
 
    QgsAttributeEditorContext( const QgsAttributeEditorContext &parentContext, const QgsRelation &relation, RelationMode relationMode, FormMode widgetMode )
      : mParentContext( &parentContext )
      , mVectorLayerTools( parentContext.mVectorLayerTools )
      , mMapCanvas( parentContext.mMapCanvas )
      , mMainMessageBar( parentContext.mMainMessageBar )
      , mCadDockWidget( parentContext.mCadDockWidget )
      , mDistanceArea( parentContext.mDistanceArea )
      , mRelation( relation )
      , mRelationMode( relationMode )
      , mFormMode( widgetMode )
    {
      Q_ASSERT( parentContext.vectorLayerTools() );
    }

    inline void setDistanceArea( const QgsDistanceArea &distanceArea )
    {
      if ( mLayer )
      {
        mDistanceArea = distanceArea;
        mDistanceArea.setSourceCrs( mLayer->crs(), QgsProject::instance()->transformContext() );
      }
    }

    inline const QgsDistanceArea &distanceArea() const { return mDistanceArea; }

    inline void setMapCanvas( QgsMapCanvas *mapCanvas ) { mMapCanvas = mapCanvas; }

    inline QgsMapCanvas *mapCanvas() const { return mMapCanvas; }

    void setCadDockWidget( QgsAdvancedDigitizingDockWidget *cadDockWidget );

    QgsAdvancedDigitizingDockWidget *cadDockWidget() const { return mCadDockWidget; }

    inline void setVectorLayerTools( QgsVectorLayerTools *vlTools ) { mVectorLayerTools = vlTools; }
    // TODO QGIS 5.0 - rename vlTools to tools

    inline const QgsVectorLayerTools *vectorLayerTools() const { return mVectorLayerTools; }

    inline void setRelation( const QgsRelation &relation, RelationMode mode )
    {
      mRelation = relation;
      mRelationMode = mode;
    }

    inline const QgsRelation &relation() const { return mRelation; }

    inline RelationMode relationMode() const { return mRelationMode; }

    inline FormMode formMode() const { return mFormMode; }

    inline void setFormMode( FormMode mode ) { mFormMode = mode; }

    bool allowCustomUi() const { return mAllowCustomUi; }

    void setAllowCustomUi( bool allow ) { mAllowCustomUi = allow; }
 
    inline const QgsAttributeEditorContext *parentContext() const { return mParentContext; }

    QgsFeature formFeature() const { return mFormFeature; }

    void setFormFeature( const QgsFeature &feature ) { mFormFeature = feature; }

    QgsFeature parentFormFeature() const { return mParentFormFeature; }

    void setParentFormFeature( const QgsFeature &feature ) { mParentFormFeature = feature; }

    Mode attributeFormMode() const { return mAttributeFormMode; }

    void setAttributeFormMode( const Mode &attributeFormMode ) { mAttributeFormMode = attributeFormMode; }

    QString attributeFormModeString() const
    {
      const QMetaEnum metaEnum( QMetaEnum::fromType<Mode>() );
      return metaEnum.valueToKey( static_cast<int>( mAttributeFormMode ) );
    }

    void setMainMessageBar( QgsMessageBar *messageBar ) { mMainMessageBar = messageBar; }

    QgsMessageBar *mainMessageBar() { return mMainMessageBar; }
 
  private:
    const QgsAttributeEditorContext *mParentContext = nullptr;
    QgsVectorLayer *mLayer = nullptr;
    QgsVectorLayerTools *mVectorLayerTools = nullptr;
    QgsMapCanvas *mMapCanvas = nullptr;
    QgsMessageBar *mMainMessageBar = nullptr;
    QgsAdvancedDigitizingDockWidget *mCadDockWidget = nullptr;
    QgsDistanceArea mDistanceArea;
    QgsRelation mRelation;
    RelationMode mRelationMode = Undefined;
    QgsFeature mFormFeature;
    QgsFeature mParentFormFeature;
    FormMode mFormMode = Embed;
    bool mAllowCustomUi = true;
    Mode mAttributeFormMode = SingleEditMode;
};
 
#endif // QGSATTRIBUTEEDITORCONTEXT_H