QGIS API Documentation  2.99.0-Master (ba079d8)
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 
23 class QgsVectorLayer;
24 
26 #include "qgis_gui.h"
27 #include "qgis_sip.h"
28 #include "qgspropertycollection.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 % End
36 #endif
37 
49 class GUI_EXPORT QgsWidgetWrapper : public QObject
50 {
51 
52 #ifdef SIP_RUN
54  if ( qobject_cast<QgsEditorWidgetWrapper *>( sipCpp ) )
55  sipType = sipType_QgsEditorWidgetWrapper;
56  else if ( qobject_cast<QgsRelationWidgetWrapper *>( sipCpp ) )
57  sipType = sipType_QgsRelationWidgetWrapper;
58  else
59  sipType = 0;
60  SIP_END
61 #endif
62 
63  Q_OBJECT
64  public:
65 
69  enum Property
70  {
71  RootPath = 0,
72  DocumentViewerContent
73  };
74 
79  static const QgsPropertiesDefinition &propertyDefinitions();
80 
88  explicit QgsWidgetWrapper( QgsVectorLayer *vl, QWidget *editor = nullptr, QWidget *parent = nullptr );
89 
95  QWidget *widget();
96 
105  template <class T> SIP_SKIP
106  T *widget() { return dynamic_cast<T>( mWidget ); }
107 
113  void setConfig( const QVariantMap &config );
114 
120  void setContext( const QgsAttributeEditorContext &context );
121 
130  QVariant config( const QString &key, const QVariant &defaultVal = QVariant() ) const;
131 
137  QVariantMap config() const;
138 
144  const QgsAttributeEditorContext &context() const;
145 
153  QgsVectorLayer *layer() const;
154 
160  static QgsWidgetWrapper *fromWidget( QWidget *widget );
161 
173  virtual bool valid() const = 0;
174 
175 
182  QgsPropertyCollection &dataDefinedProperties() { return mPropertyCollection; } SIP_SKIP
183 
188  const QgsPropertyCollection &dataDefinedProperties() const { return mPropertyCollection; }
189 
195  void setDataDefinedProperties( const QgsPropertyCollection &collection ) { mPropertyCollection = collection; }
196 
197  protected:
198 
210  virtual QWidget *createWidget( QWidget *parent ) = 0;
211 
217  virtual void initWidget( QWidget *editor );
218 
221 
222  public slots:
223 
230  virtual void setFeature( const QgsFeature &feature ) = 0;
231 
238  virtual void setEnabled( bool enabled );
239 
240  private:
241  QgsAttributeEditorContext mContext;
242  QVariantMap mConfig;
243  QWidget *mWidget = nullptr;
244  QWidget *mParent = nullptr;
245  QgsVectorLayer *mLayer = nullptr;
246  bool mInitialized;
247 };
248 
249 // We'll use this class inside a QVariant in the widgets properties
251 
252 #endif // QGSWIDGETWRAPPER_H
T * widget()
Access the widget managed by this wrapper and cast it to a given type Example: QPushButton* pb = wrap...
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the editor widget&#39;s property collection, used for data defined overrides...
This class contains context information for attribute editor widgets.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:61
Q_DECLARE_METATYPE(QModelIndex)
QgsPropertyCollection mPropertyCollection
Data defined property collection.
const QgsPropertyCollection & dataDefinedProperties() const
Returns a reference to the editor widget&#39;s property collection, used for data defined overrides...
#define SIP_SKIP
Definition: qgis_sip.h:102
#define SIP_END
Definition: qgis_sip.h:148
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the editor widget&#39;s property collection, used for data defined overrides.
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition: qgis_sip.h:143
A grouped map of multiple QgsProperty objects, each referenced by a integer key value.
Property
Data defined properties for different editor widgets.
Represents a vector layer which manages a vector based data sets.
Manages an editor widget Widget and wrapper share the same parent.