qgsabstractrelationeditorwidget.h

Go to the documentation of this file.

/***************************************************************************
                         qgsabstractrelationeditorwidget.h
                         ----------------------
    begin                : October 2020
    copyright            : (C) 2020 by Ivan Ivanov
    email                : [email protected]
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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 QGSABSTRACTRELATIONEDITORWIDGET_H
#define QGSABSTRACTRELATIONEDITORWIDGET_H
 
#include <QWidget>
#include "qobjectuniqueptr.h"
 
#include "qgsattributeeditorcontext.h"
#include "qgsrelation.h"
#include "qgis_sip.h"
#include "qgis_gui.h"
 
#ifdef SIP_RUN
// this is needed for the "convert to subclass" code below to compile
//%ModuleHeaderCode
#include "qgsrelationeditorwidget.h"
//%End
#endif
 
class QgsFeature;
class QgsVectorLayer;
 
class GUI_EXPORT QgsAbstractRelationEditorWidget : public QWidget
{
#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( qobject_cast<QgsRelationEditorWidget *>( sipCpp ) )
      sipType = sipType_QgsRelationEditorWidget;
    else
      sipType = 0;
    SIP_END
#endif
 
    Q_OBJECT
 
  public:
    QgsAbstractRelationEditorWidget( const QVariantMap &config, QWidget *parent SIP_TRANSFERTHIS = nullptr );
 
    void setRelationFeature( const QgsRelation &relation, const QgsFeature &feature );
 
    void setRelations( const QgsRelation &relation, const QgsRelation &nmrelation );
 
    QgsRelation relation() const { return mRelation; }
 
    QgsRelation nmRelation() const { return mNmRelation; }
 
    void setFeature( const QgsFeature &feature, bool update = true );
 
    void setMultiEditFeatureIds( const QgsFeatureIds &fids );
 
    virtual void setEditorContext( const QgsAttributeEditorContext &context );
 
    QgsAttributeEditorContext editorContext() const;
 
    Q_DECL_DEPRECATED bool showLabel() const SIP_DEPRECATED;
 
    Q_DECL_DEPRECATED void setShowLabel( bool showLabel ) SIP_DEPRECATED;
 
    QVariant nmRelationId() const;
 
    void setNmRelationId( const QVariant &nmRelationId = QVariant() );
 
    Q_DECL_DEPRECATED QString label() const SIP_DEPRECATED;
 
    void setLabel( const QString &label = QString() );
 
    QgsFeature feature() const;
 
    QList<QgsFeature> features() const;
 
    bool forceSuppressFormPopup() const;
 
    void setForceSuppressFormPopup( bool forceSuppressFormPopup );
 
    virtual QVariantMap config() const = 0;
 
    virtual void setConfig( const QVariantMap &config ) = 0;
 
    bool multiEditModeActive() const;
 
  signals:
 
    void relatedFeaturesChanged();
 
  public slots:
 
    virtual void parentFormValueChanged( const QString &attribute, const QVariant &newValue ) = 0;
 
  protected slots:
 
    void toggleEditing( bool state );
 
    void saveEdits();
 
    QgsFeatureIds addFeature( const QgsGeometry &geometry = QgsGeometry() );
 
    void deleteFeature( QgsFeatureId fid = QgsFeatureId() );
 
    void linkFeature( const QString &filterExpression = QString() );
 
    void onLinkFeatureDlgAccepted();
 
    void unlinkFeature( QgsFeatureId fid = QgsFeatureId() );
 
    void duplicateFeature( const QgsFeatureId &fid );
 
    void duplicateFeatures( const QgsFeatureIds &fids );
 
  protected:
    QgsAttributeEditorContext mEditorContext;
    QgsRelation mRelation;
    QgsRelation mNmRelation;
    QgsFeatureList mFeatureList;
 
    bool mLayerInSameTransactionGroup = false;
 
    bool mForceSuppressFormPopup = false;
 
    void showEvent( QShowEvent * );
 
    Q_DECL_DEPRECATED void updateTitle() SIP_DEPRECATED;
 
    void deleteFeatures( const QgsFeatureIds &fids );
 
    void unlinkFeatures( const QgsFeatureIds &fids );
 
    // Following virtual methods need to be protected so they can be overridden in bindings
 
    virtual void updateUi();
 
    Q_DECL_DEPRECATED virtual void setTitle( const QString &title ) SIP_DEPRECATED;
 
    virtual void beforeSetRelationFeature( const QgsRelation &newRelation, const QgsFeature &newFeature );
 
    virtual void afterSetRelationFeature();
 
    virtual void beforeSetRelations( const QgsRelation &newRelation, const QgsRelation &newNmRelation );
 
    virtual void afterSetRelations();
};
 
 
class GUI_EXPORT QgsAbstractRelationEditorConfigWidget : public QWidget
{
#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( qobject_cast<QgsRelationEditorConfigWidget *>( sipCpp ) )
      sipType = sipType_QgsRelationEditorConfigWidget;
    else
      sipType = 0;
    SIP_END
#endif
 
    Q_OBJECT
  public:
    explicit QgsAbstractRelationEditorConfigWidget( const QgsRelation &relation, QWidget *parent SIP_TRANSFERTHIS );
 
    virtual QVariantMap config() = 0;
 
    virtual void setConfig( const QVariantMap &config ) = 0;
 
    QgsVectorLayer *layer();
 
    QgsRelation relation() const;
 
    virtual void setNmRelation( const QgsRelation &nmRelation );
 
    virtual QgsRelation nmRelation() const;
 
  private:
    QgsVectorLayer *mLayer = nullptr;
    QgsRelation mRelation;
    QgsRelation mNmRelation;
};
 
 
 
 
class GUI_EXPORT QgsAbstractRelationEditorWidgetFactory
{
  public:
    QgsAbstractRelationEditorWidgetFactory();
 
    virtual ~QgsAbstractRelationEditorWidgetFactory() = default;
 
    virtual QString type() const = 0;
 
    virtual QString name() const = 0;
 
    virtual QgsAbstractRelationEditorWidget *create( const QVariantMap &config, QWidget *parent = nullptr ) const = 0 SIP_FACTORY;
 
    virtual QgsAbstractRelationEditorConfigWidget *configWidget( const QgsRelation &relation, QWidget *parent ) const = 0 SIP_FACTORY;
};
 
#endif // QGSABSTRACTRELATIONEDITORWIDGET_H