qgsrelationeditorwidget.h

Go to the documentation of this file.

/***************************************************************************
    qgsrelationeditorwidget.h
     --------------------------------------
    Date                 : 17.5.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 QGSRELATIONEDITORWIDGET_H
#define QGSRELATIONEDITORWIDGET_H
 
#include "ui_qgsrelationeditorconfigwidgetbase.h"
 
#include "qgis_gui.h"
#include "qgsabstractrelationeditorwidget.h"
#include "qgsattributeeditorcontext.h"
#include "qgsdualview.h"
#include "qgsrelation.h"
#include "qgsvectorlayerselectionmanager.h"
#include "qobjectuniqueptr.h"
 
#include <QButtonGroup>
#include <QGridLayout>
#include <QToolButton>
#include <QWidget>
 
class QTreeWidget;
class QTreeWidgetItem;
class QgsFeature;
class QgsVectorLayer;
class QgsVectorLayerTools;
class QgsMapTool;
class QgsMapToolDigitizeFeature;
 
#ifdef SIP_RUN
//%ModuleHeaderCode
// fix to allow compilation with sip that for some reason
// doesn't add this include to the file where the code from
// ConvertToSubClassCode goes.
#include <qgsrelationeditorwidget.h>
//%End
#endif
 

#ifndef SIP_RUN

class QgsFilteredSelectionManager : public QgsVectorLayerSelectionManager
{
    Q_OBJECT
 
  public:
    QgsFilteredSelectionManager( QgsVectorLayer *layer, const QgsFeatureRequest &request, QObject *parent = nullptr );
 
    const QgsFeatureIds &selectedFeatureIds() const override;
    int selectedFeatureCount() override;
 
  private slots:
 
    void onSelectionChanged( const QgsFeatureIds &selected, const QgsFeatureIds &deselected, bool clearAndSelect ) override;
 
  private:
    QgsFeatureRequest mRequest;
    QgsFeatureIds mSelectedFeatureIds;
};
#endif
 

class GUI_EXPORT QgsRelationEditorWidget : public QgsAbstractRelationEditorWidget
{
    Q_OBJECT
    Q_PROPERTY( QgsDualView::ViewMode viewMode READ viewMode WRITE setViewMode )
    Q_PROPERTY( Buttons visibleButtons READ visibleButtons WRITE setVisibleButtons )
 
  public:

    enum Button SIP_ENUM_BASETYPE( IntFlag )
    {
      NoButton = 0,                                                                                                                   
      Link = 1 << 1,                                                                                                                  
      Unlink = 1 << 2,                                                                                                                
      SaveChildEdits = 1 << 3,                                                                                                        
      AddChildFeature = 1 << 4,                                                                                                       
      DuplicateChildFeature = 1 << 5,                                                                                                 
      DeleteChildFeature = 1 << 6,                                                                                                    
      ZoomToChildFeature = 1 << 7,                                                                                                    
      AllButtons = Link | Unlink | SaveChildEdits | AddChildFeature | DuplicateChildFeature | DeleteChildFeature | ZoomToChildFeature 
    };
    Q_ENUM( Button )
    Q_DECLARE_FLAGS( Buttons, Button )
    Q_FLAG( Buttons )

    QgsRelationEditorWidget( const QVariantMap &config, QWidget *parent SIP_TRANSFERTHIS = nullptr );

    void setViewMode( QgsDualView::ViewMode mode );

    QgsDualView::ViewMode viewMode() { return mViewMode; }

    QgsIFeatureSelectionManager *featureSelectionManager();

    void setEditorContext( const QgsAttributeEditorContext &context ) override;

    void setVisibleButtons( const Buttons &buttons );

    Buttons visibleButtons() const;

    Q_DECL_DEPRECATED void duplicateFeature() SIP_DEPRECATED;

    void duplicateSelectedFeatures();

    void unlinkSelectedFeatures();

    void deleteSelectedFeatures();

    void zoomToSelectedFeatures();

    QVariantMap config() const override;

    void setConfig( const QVariantMap &config ) override;
 
  public slots:
    void parentFormValueChanged( const QString &attribute, const QVariant &newValue ) override;
 
  protected:
    void updateUi() override;
    void beforeSetRelationFeature( const QgsRelation &newRelation, const QgsFeature &newFeature ) override;
    void afterSetRelationFeature() override;
    void beforeSetRelations( const QgsRelation &newRelation, const QgsRelation &newNmRelation ) override;
    void afterSetRelations() override;
 
  private slots:
    void setViewMode( int mode ) { setViewMode( static_cast<QgsDualView::ViewMode>( mode ) ); }
    void updateButtons();
 
    void addFeature();
    void addFeatureGeometry();
 
    // TODO -- someone familiar with this widget needs to fix this:
    void toggleEditing( bool state ); // cppcheck-suppress duplInheritedMember
 
    void showContextMenu( QgsActionMenu *menu, QgsFeatureId fid );
    void mapToolDeactivated();
    void onDigitizingCompleted( const QgsFeature &feature );
    void onDigitizingCanceled();
    void multiEditItemSelectionChanged();
    void linkFeature();
 
  private:
    void digitizingFinished();
 
    enum class MultiEditFeatureType : int
    {
      Parent,
      Child
    };
 
    enum class MultiEditTreeWidgetRole : int
    {
      FeatureType = Qt::UserRole + 1,
      FeatureId = Qt::UserRole + 2
    };
 
    void initDualView( QgsVectorLayer *layer, const QgsFeatureRequest &request );
    void setMapTool( QgsMapTool *mapTool );
    void unsetMapTool();
    QgsFeatureIds selectedChildFeatureIds() const;
    void updateUiSingleEdit();
    void updateUiMultiEdit();
    QTreeWidgetItem *createMultiEditTreeWidgetItem( const QgsFeature &feature, QgsVectorLayer *layer, MultiEditFeatureType type );
 
    QgsDualView *mDualView = nullptr;
    QPointer<QgsMessageBarItem> mMessageBarItem;
    QgsDualView::ViewMode mViewMode = QgsDualView::AttributeEditor;
 
    QToolButton *mToggleEditingButton = nullptr;
    QToolButton *mSaveEditsButton = nullptr;
    QToolButton *mAddFeatureButton = nullptr;
    QToolButton *mDuplicateFeatureButton = nullptr;
    QToolButton *mDeleteFeatureButton = nullptr;
    QToolButton *mLinkFeatureButton = nullptr;
    QToolButton *mUnlinkFeatureButton = nullptr;
    QToolButton *mZoomToFeatureButton = nullptr;
    QToolButton *mFormViewButton = nullptr;
    QToolButton *mTableViewButton = nullptr;
    QToolButton *mAddFeatureGeometryButton = nullptr;
    QLabel *mMultiEditInfoLabel = nullptr;
    QStackedWidget *mStackedWidget = nullptr;
    QWidget *mMultiEditStackedWidgetPage = nullptr;
    QTreeWidget *mMultiEditTreeWidget = nullptr;
    QObjectUniquePtr<QgsMapToolDigitizeFeature> mMapToolDigitize;
    QButtonGroup *mViewModeButtonGroup = nullptr;
    QgsVectorLayerSelectionManager *mFeatureSelectionMgr = nullptr;
 
    Buttons mButtonsVisibility = Button::AllButtons;
    bool mShowFirstFeature = true;
    bool mAllowAddChildFeatureWithNoGeometry = true;
    QString mFilterExpression;
 
    QList<QTreeWidgetItem *> mMultiEditPreviousSelectedItems;
    QgsFeatureIds mMultiEdit1NJustAddedIds;
 
    friend class TestQgsRelationEditorWidget;
};
 

class GUI_EXPORT QgsRelationEditorConfigWidget : public QgsAbstractRelationEditorConfigWidget, private Ui::QgsRelationEditorConfigWidgetBase
{
    Q_OBJECT
 
  public:

    explicit QgsRelationEditorConfigWidget( const QgsRelation &relation, QWidget *parent SIP_TRANSFERTHIS );

    QVariantMap config() override;

    void setConfig( const QVariantMap &config ) override;

    void mEditExpression_clicked();
};
 
 
#ifndef SIP_RUN

class GUI_EXPORT QgsRelationEditorWidgetFactory : public QgsAbstractRelationEditorWidgetFactory
{
  public:
    QgsRelationEditorWidgetFactory();
 
    QString type() const override;
 
    QString name() const override;
 
    QgsAbstractRelationEditorWidget *create( const QVariantMap &config, QWidget *parent = nullptr ) const override;
 
    QgsAbstractRelationEditorConfigWidget *configWidget( const QgsRelation &relation, QWidget *parent ) const override;
};
#endif
 
 
#endif // QGSRELATIONEDITORWIDGET_H