QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsrelationeditorwidget.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsrelationeditorwidget.h
3 --------------------------------------
4 Date : 17.5.2013
5 Copyright : (C) 2013 Matthias Kuhn
6 Email : matthias at opengis dot ch
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSRELATIONEDITORWIDGET_H
17#define QGSRELATIONEDITORWIDGET_H
18
19#include <QWidget>
20#include <QToolButton>
21#include <QButtonGroup>
22#include <QGridLayout>
23#include "qobjectuniqueptr.h"
24
25#include "ui_qgsrelationeditorconfigwidgetbase.h"
26
28#include "qobjectuniqueptr.h"
30#include "qgsdualview.h"
31#include "qgsrelation.h"
33#include "qgis_gui.h"
34
35class QTreeWidget;
36class QTreeWidgetItem;
37class QgsFeature;
38class QgsVectorLayer;
40class QgsMapTool;
42
43#ifdef SIP_RUN
44% ModuleHeaderCode
45// fix to allow compilation with sip that for some reason
46// doesn't add this include to the file where the code from
47// ConvertToSubClassCode goes.
49% End
50#endif
51
52
54#ifndef SIP_RUN
55
60class QgsFilteredSelectionManager : public QgsVectorLayerSelectionManager
61{
62 Q_OBJECT
63
64 public:
65 QgsFilteredSelectionManager( QgsVectorLayer *layer, const QgsFeatureRequest &request, QObject *parent = nullptr );
66
67 const QgsFeatureIds &selectedFeatureIds() const override;
68 int selectedFeatureCount() override;
69
70 private slots:
71
72 void onSelectionChanged( const QgsFeatureIds &selected, const QgsFeatureIds &deselected, bool clearAndSelect ) override;
73
74 private:
75
76 QgsFeatureRequest mRequest;
77 QgsFeatureIds mSelectedFeatureIds;
78};
79#endif
81
82
90{
91
92 Q_OBJECT
93 Q_PROPERTY( QgsDualView::ViewMode viewMode READ viewMode WRITE setViewMode )
94 Q_PROPERTY( Buttons visibleButtons READ visibleButtons WRITE setVisibleButtons )
95
96 public:
97
102 enum Button SIP_ENUM_BASETYPE( IntFlag )
103 {
104 NoButton = 0,
105 Link = 1 << 1,
106 Unlink = 1 << 2,
107 SaveChildEdits = 1 << 3,
108 AddChildFeature = 1 << 4,
109 DuplicateChildFeature = 1 << 5,
110 DeleteChildFeature = 1 << 6,
111 ZoomToChildFeature = 1 << 7,
112 AllButtons = Link | Unlink | SaveChildEdits | AddChildFeature | DuplicateChildFeature | DeleteChildFeature | ZoomToChildFeature
113 };
114 Q_ENUM( Button )
115 Q_DECLARE_FLAGS( Buttons, Button )
116 Q_FLAG( Buttons )
117
123 QgsRelationEditorWidget( const QVariantMap &config, QWidget *parent SIP_TRANSFERTHIS = nullptr );
124
126 void setViewMode( QgsDualView::ViewMode mode );
127
129 QgsDualView::ViewMode viewMode() {return mViewMode;}
130
135 QgsIFeatureSelectionManager *featureSelectionManager();
136
142 void setEditorContext( const QgsAttributeEditorContext &context ) override;
143
147 void setVisibleButtons( const Buttons &buttons );
148
152 Buttons visibleButtons() const;
153
158 Q_DECL_DEPRECATED void duplicateFeature() SIP_DEPRECATED;
159
164 void duplicateSelectedFeatures();
165
169 void unlinkSelectedFeatures();
170
174 void deleteSelectedFeatures();
175
179 void zoomToSelectedFeatures();
180
184 QVariantMap config() const override;
185
189 void setConfig( const QVariantMap &config ) override;
190
191 public slots:
192 void parentFormValueChanged( const QString &attribute, const QVariant &newValue ) override;
193
194 protected:
195 virtual void updateUi() override;
196 void beforeSetRelationFeature( const QgsRelation &newRelation, const QgsFeature &newFeature ) override;
197 void afterSetRelationFeature() override;
198 void beforeSetRelations( const QgsRelation &newRelation, const QgsRelation &newNmRelation ) override;
199 void afterSetRelations() override;
200
201 private slots:
202 void setViewMode( int mode ) {setViewMode( static_cast<QgsDualView::ViewMode>( mode ) );}
203 void updateButtons();
204
205 void addFeature();
206 void addFeatureGeometry();
207 void toggleEditing( bool state );
208 void showContextMenu( QgsActionMenu *menu, QgsFeatureId fid );
209 void mapToolDeactivated();
210 void onDigitizingCompleted( const QgsFeature &feature );
211 void onDigitizingCanceled( );
212 void multiEditItemSelectionChanged();
213
214 private:
215
216 void digitizingFinished( );
217
218 enum class MultiEditFeatureType : int
219 {
220 Parent,
221 Child
222 };
223
224 enum class MultiEditTreeWidgetRole : int
225 {
226 FeatureType = Qt::UserRole + 1,
227 FeatureId = Qt::UserRole + 2
228 };
229
230 void initDualView( QgsVectorLayer *layer, const QgsFeatureRequest &request );
231 void setMapTool( QgsMapTool *mapTool );
232 void unsetMapTool();
233 QgsFeatureIds selectedChildFeatureIds() const;
234 void updateUiSingleEdit();
235 void updateUiMultiEdit();
236 QTreeWidgetItem *createMultiEditTreeWidgetItem( const QgsFeature &feature, QgsVectorLayer *layer, MultiEditFeatureType type );
237
238 QgsDualView *mDualView = nullptr;
239 QPointer<QgsMessageBarItem> mMessageBarItem;
241
242 QToolButton *mToggleEditingButton = nullptr;
243 QToolButton *mSaveEditsButton = nullptr;
244 QToolButton *mAddFeatureButton = nullptr;
245 QToolButton *mDuplicateFeatureButton = nullptr;
246 QToolButton *mDeleteFeatureButton = nullptr;
247 QToolButton *mLinkFeatureButton = nullptr;
248 QToolButton *mUnlinkFeatureButton = nullptr;
249 QToolButton *mZoomToFeatureButton = nullptr;
250 QToolButton *mFormViewButton = nullptr;
251 QToolButton *mTableViewButton = nullptr;
252 QToolButton *mAddFeatureGeometryButton = nullptr;
253 QLabel *mMultiEditInfoLabel = nullptr;
254 QStackedWidget *mStackedWidget = nullptr;
255 QWidget *mMultiEditStackedWidgetPage = nullptr;
256 QTreeWidget *mMultiEditTreeWidget = nullptr;
258 QButtonGroup *mViewModeButtonGroup = nullptr;
259 QgsVectorLayerSelectionManager *mFeatureSelectionMgr = nullptr;
260
261 Buttons mButtonsVisibility = Button::AllButtons;
262 bool mShowFirstFeature = true;
263 bool mAllowAddChildFeatureWithNoGeometry = true;
264
265 QList<QTreeWidgetItem *> mMultiEditPreviousSelectedItems;
266 QgsFeatureIds mMultiEdit1NJustAddedIds;
267
268 friend class TestQgsRelationEditorWidget;
269};
270
271
278class GUI_EXPORT QgsRelationEditorConfigWidget : public QgsAbstractRelationEditorConfigWidget, private Ui::QgsRelationEditorConfigWidgetBase
279{
280 Q_OBJECT
281
282 public:
283
290 explicit QgsRelationEditorConfigWidget( const QgsRelation &relation, QWidget *parent SIP_TRANSFERTHIS );
291
297 QVariantMap config() override;
298
304 void setConfig( const QVariantMap &config ) override;
305
306};
307
308
309#ifndef SIP_RUN
310
319{
320 public:
322
323 QString type() const override;
324
325 QString name() const override;
326
327 QgsAbstractRelationEditorWidget *create( const QVariantMap &config, QWidget *parent = nullptr ) const override;
328
329 QgsAbstractRelationEditorConfigWidget *configWidget( const QgsRelation &relation, QWidget *parent ) const override;
330
331};
332#endif
333
334
335#endif // QGSRELATIONEDITORWIDGET_H
This class should be subclassed for every configurable relation widget type.
Factory class for creating relation widgets and their corresponding config widgets.
Base class to build new relation widgets.
void toggleEditing(bool state)
Toggles editing state of the widget.
QgsFeatureIds addFeature(const QgsGeometry &geometry=QgsGeometry())
Adds new features with given geometry Returns the Id of added features.
virtual void setConfig(const QVariantMap &config)=0
Defines the widget configuration.
virtual void setEditorContext(const QgsAttributeEditorContext &context)
Sets the editor context.
virtual QVariantMap config() const =0
Returns the widget configuration.
void duplicateFeature(const QgsFeatureId &fid)
Duplicates a feature.
This class is a menu that is populated automatically with the actions defined for a given layer.
Definition: qgsactionmenu.h:39
This class contains context information for attribute editor widgets.
This widget is used to show the attributes of a set of features of a QgsVectorLayer.
Definition: qgsdualview.h:45
ViewMode
The view modes, in which this widget can present information.
Definition: qgsdualview.h:56
@ AttributeEditor
Show a list of the features, where one can be chosen and the according attribute dialog will be prese...
Definition: qgsdualview.h:68
This class wraps a request for features to a vector layer (or directly its vector data provider).
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition: qgsfeature.h:56
Is an interface class to abstract feature selection handling.
This tool digitizes geometry of new point/line/polygon features on already existing vector layers Onc...
Abstract base class for all map tools.
Definition: qgsmaptool.h:71
Creates a new configuration widget for the relation editor widget.
Factory class for creating a relation editor widget and the respective config widget.
The default relation widget in QGIS.
Button
Possible buttons shown in the relation editor.
int selectedFeatureCount() override
Returns the number of features that are selected in this layer.
const QgsFeatureIds & selectedFeatureIds() const override
Returns reference to identifiers of selected features.
Methods in this class are used to handle basic operations on vector layers.
Represents a vector layer which manages a vector based data sets.
#define SIP_DEPRECATED
Definition: qgis_sip.h:106
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:53
#define SIP_ENUM_BASETYPE(type)
Definition: qgis_sip.h:278
QSet< QgsFeatureId > QgsFeatureIds
Definition: qgsfeatureid.h:37
qint64 QgsFeatureId
64 bit feature ids negative numbers are used for uncommitted/newly added features
Definition: qgsfeatureid.h:28