QGIS API Documentation 3.39.0-Master (3783037d301)
Loading...
Searching...
No Matches
qgswidgetwrapper.h
Go to the documentation of this file.
1/***************************************************************************
2 qgswidgetwrapper.h
3 --------------------------------------
4 Date : 14.5.2014
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 QGSWIDGETWRAPPER_H
17#define QGSWIDGETWRAPPER_H
18
19#include <QObject>
20#include <QMap>
21#include <QVariant>
22
23class QgsVectorLayer;
24
26#include "qgis_gui.h"
27#include "qgis_sip.h"
29
30#ifdef SIP_RUN
31// This is required for the ConvertToSubClassCode to work properly
32// so RTTI for casting is available in the whole module.
33% ModuleCode
35#include "qgsqmlwidgetwrapper.h"
37% End
38#endif
39
52class GUI_EXPORT QgsWidgetWrapper : public QObject
53{
54
55#ifdef SIP_RUN
57 if ( qobject_cast<QgsEditorWidgetWrapper *>( sipCpp ) )
58 sipType = sipType_QgsEditorWidgetWrapper;
59 else if ( qobject_cast<QgsRelationWidgetWrapper *>( sipCpp ) )
60 sipType = sipType_QgsRelationWidgetWrapper;
61 else if ( qobject_cast<QgsQmlWidgetWrapper *>( sipCpp ) )
62 sipType = sipType_QgsQmlWidgetWrapper;
63 else if ( qobject_cast<QgsHtmlWidgetWrapper *>( sipCpp ) )
64 sipType = sipType_QgsHtmlWidgetWrapper;
65 else
66 sipType = 0;
68#endif
69
70 Q_OBJECT
71 public:
72
73 // *INDENT-OFF*
74
79 {
80 RootPath = 0,
81 DocumentViewerContent,
82 StorageUrl
83 };
84 // *INDENT-ON*
85
89 static const QgsPropertiesDefinition &propertyDefinitions();
90
98 explicit QgsWidgetWrapper( QgsVectorLayer *vl, QWidget *editor = nullptr, QWidget *parent = nullptr );
99
105 QWidget *widget();
106
118 template <class T> SIP_SKIP
119 T *widget() { return dynamic_cast<T>( mWidget ); }
120
126 void setConfig( const QVariantMap &config );
127
133 void setContext( const QgsAttributeEditorContext &context );
134
143 QVariant config( const QString &key, const QVariant &defaultVal = QVariant() ) const;
144
148 QVariantMap config() const;
149
153 const QgsAttributeEditorContext &context() const;
154
158 QgsVectorLayer *layer() const;
159
165 static QgsWidgetWrapper *fromWidget( QWidget *widget );
166
177 virtual bool valid() const = 0;
178
179
186 QgsPropertyCollection &dataDefinedProperties() { return mPropertyCollection; } SIP_SKIP
187
193 const QgsPropertyCollection &dataDefinedProperties() const { return mPropertyCollection; }
194
201 void setDataDefinedProperties( const QgsPropertyCollection &collection ) { mPropertyCollection = collection; }
202
210 void notifyAboutToSave();
211
212 signals:
213
220
221 protected:
222
234 virtual QWidget *createWidget( QWidget *parent ) = 0;
235
241 virtual void initWidget( QWidget *editor );
242
245
246 public slots:
247
254 virtual void setFeature( const QgsFeature &feature ) = 0;
255
262 virtual void setEnabled( bool enabled );
263
264 private:
265
272 virtual void aboutToSave();
273
275 QVariantMap mConfig;
276 QWidget *mWidget = nullptr;
277 QWidget *mParent = nullptr;
278 QgsVectorLayer *mLayer = nullptr;
279 bool mInitialized;
280};
281
282// We'll use this class inside a QVariant in the widgets properties
284
285#endif // QGSWIDGETWRAPPER_H
This class contains context information for attribute editor widgets.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
A grouped map of multiple QgsProperty objects, each referenced by a integer key value.
Represents a vector layer which manages a vector based data sets.
Manages an editor widget Widget and wrapper share the same parent.
virtual void setFeature(const QgsFeature &feature)=0
Is called when the value of the widget needs to be changed.
virtual bool valid() const =0
Returns true if the widget has been properly initialized.
T * widget()
Access the widget managed by this wrapper and cast it to a given type.
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the editor widget's property collection, used for data defined overrides.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the editor widget's property collection, used for data defined overrides.
void contextChanged()
Signal when QgsAttributeEditorContext mContext changed.
const QgsPropertyCollection & dataDefinedProperties() const
Returns a reference to the editor widget's property collection, used for data defined overrides.
QgsPropertyCollection mPropertyCollection
Data defined property collection.
Property
Data defined properties for different editor widgets.
virtual QWidget * createWidget(QWidget *parent)=0
This method should create a new widget with the provided parent.
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition qgis_sip.h:191
#define SIP_SKIP
Definition qgis_sip.h:126
#define SIP_MONKEYPATCH_SCOPEENUM_UNNEST(OUTSIDE_CLASS, FORMERNAME)
Definition qgis_sip.h:271
#define SIP_END
Definition qgis_sip.h:208
Q_DECLARE_METATYPE(QgsDatabaseQueryLogEntry)
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.