QGIS API Documentation 3.99.0-Master (2fe06baccd8)
Loading...
Searching...
No Matches
qgsformannotation.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsformannotation.cpp
3 ------------------------
4 begin : February 26, 2010
5 copyright : (C) 2010 by Marco Hugentobler
6 email : marco dot hugentobler at hugis dot net
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#include "qgsformannotation.h"
19
23#include "qgsfeature.h"
24#include "qgsfeatureiterator.h"
25#include "qgsfillsymbol.h"
26#include "qgsgui.h"
27#include "qgslogger.h"
28#include "qgsmapcanvas.h"
29#include "qgsmaptool.h"
30#include "qgsproject.h"
31#include "qgsvectorlayer.h"
32
33#include <QDir>
34#include <QDomElement>
35#include <QFile>
36#include <QFileInfo>
37#include <QGraphicsProxyWidget>
38#include <QPainter>
39#include <QSettings>
40#include <QUiLoader>
41#include <QWidget>
42
43#include "moc_qgsformannotation.cpp"
44
46 : QgsAnnotation( parent )
47{}
48
50{
51 auto c = std::make_unique<QgsFormAnnotation>();
52 copyCommonProperties( c.get() );
53 c->setDesignerForm( mDesignerForm );
54 return c.release();
55}
56
57void QgsFormAnnotation::setDesignerForm( const QString &uiFile )
58{
59 mDesignerForm = uiFile;
60 mDesignerWidget.reset( createDesignerWidget( uiFile ) );
61 if ( mDesignerWidget )
62 {
63 mMinimumSize = mDesignerWidget->minimumSize();
64 if ( auto *lFillSymbol = fillSymbol() )
65 {
66 QgsFillSymbol *newFill = lFillSymbol->clone();
67 newFill->setColor( mDesignerWidget->palette().color( QPalette::Window ) );
68 setFillSymbol( newFill );
69 }
70 // convert from size in pixels at 96 dpi to mm
71 setFrameSizeMm( preferredFrameSize() / 3.7795275 );
72 }
73 emit appearanceChanged();
74}
75
76QWidget *QgsFormAnnotation::createDesignerWidget( const QString &filePath )
77{
78 QFile file( filePath );
79 if ( !file.open( QFile::ReadOnly ) )
80 {
81 return nullptr;
82 }
83
84 QUiLoader loader;
85 const QFileInfo fi( file );
86 loader.setWorkingDirectory( fi.dir() );
87 QWidget *widget = loader.load( &file, nullptr );
88 file.close();
89
90 //get feature and set attribute information
91 const QgsAttributeEditorContext context;
92 QgsVectorLayer *vectorLayer = qobject_cast<QgsVectorLayer *>( mapLayer() );
93 if ( vectorLayer && associatedFeature().isValid() )
94 {
95 const QgsFields fields = vectorLayer->fields();
96 const QgsAttributes attrs = associatedFeature().attributes();
97 for ( int i = 0; i < attrs.count(); ++i )
98 {
99 if ( i < fields.count() )
100 {
101 QWidget *attWidget = widget->findChild<QWidget *>( fields.at( i ).name() );
102 if ( attWidget )
103 {
104 QgsEditorWidgetWrapper *eww = QgsGui::editorWidgetRegistry()->create( vectorLayer, i, attWidget, widget, context );
105 if ( eww )
106 {
107 const QStringList additionalFields = eww->additionalFields();
108 QVariantList additionalFieldValues;
109 for ( const QString &additionalField : additionalFields )
110 {
111 const int index = vectorLayer->fields().indexFromName( additionalField );
112 additionalFieldValues.insert( index, attrs.at( index ) );
113 }
114 eww->setValues( attrs.at( i ), additionalFieldValues );
115 }
116 }
117 }
118 }
119 }
120 return widget;
121}
122
123void QgsFormAnnotation::renderAnnotation( QgsRenderContext &context, QSizeF size ) const
124{
125 if ( !mDesignerWidget || !context.painter() || ( context.feedback() && context.feedback()->isCanceled() ) )
126 return;
127
128 // scale painter back to 96 dpi, so that forms look good even in layout prints
129 const QgsScopedQPainterState painterState( context.painter() );
130 const double scaleFactor = context.painter()->device()->logicalDpiX() / 96.0;
131 context.painter()->scale( scaleFactor, scaleFactor );
132 size /= scaleFactor;
133
134 mDesignerWidget->setFixedSize( size.toSize() );
135 context.painter()->setBrush( Qt::NoBrush );
136 context.painter()->setPen( Qt::NoPen );
137 mDesignerWidget->render( context.painter(), QPoint( 0, 0 ) );
138}
139
141{
142 if ( mDesignerWidget )
143 {
144 const QSizeF widgetMinSize = mMinimumSize;
145 return QSizeF( contentsMargin().left() + contentsMargin().right() + widgetMinSize.width(), contentsMargin().top() + contentsMargin().bottom() + widgetMinSize.height() );
146 }
147 else
148 {
149 return QSizeF( 0, 0 );
150 }
151}
152
154{
155 if ( mDesignerWidget )
156 {
157 return mDesignerWidget->sizeHint();
158 }
159 else
160 {
161 return QSizeF( 0, 0 );
162 }
163}
164
165void QgsFormAnnotation::writeXml( QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context ) const
166{
167 QDomElement formAnnotationElem = doc.createElement( QStringLiteral( "FormAnnotationItem" ) );
168 formAnnotationElem.setAttribute( QStringLiteral( "designerForm" ), mDesignerForm );
169 _writeXml( formAnnotationElem, doc, context );
170 elem.appendChild( formAnnotationElem );
171}
172
173void QgsFormAnnotation::readXml( const QDomElement &itemElem, const QgsReadWriteContext &context )
174{
175 mDesignerForm = itemElem.attribute( QStringLiteral( "designerForm" ), QString() );
176 const QDomElement annotationElem = itemElem.firstChildElement( QStringLiteral( "AnnotationItem" ) );
177 if ( !annotationElem.isNull() )
178 {
179 _readXml( annotationElem, context );
180 }
181 // upgrade old layer
182 if ( !mapLayer() && itemElem.hasAttribute( QStringLiteral( "vectorLayer" ) ) )
183 {
184 setMapLayer( QgsProject::instance()->mapLayer( itemElem.attribute( QStringLiteral( "vectorLayer" ) ) ) );
185 }
186
187 mDesignerWidget.reset( createDesignerWidget( mDesignerForm ) );
188 if ( mDesignerWidget && fillSymbol() )
189 {
190 QgsFillSymbol *newFill = fillSymbol()->clone();
191 newFill->setColor( mDesignerWidget->palette().color( QPalette::Window ) );
192 setFillSymbol( newFill );
193 }
194}
195
197{
199
200 //create new embedded widget
201 mDesignerWidget.reset( createDesignerWidget( mDesignerForm ) );
202 if ( mDesignerWidget && fillSymbol() )
203 {
204 QgsFillSymbol *newFill = fillSymbol()->clone();
205 newFill->setColor( mDesignerWidget->palette().color( QPalette::Window ) );
206 setFillSymbol( newFill );
207 }
208 emit appearanceChanged();
209}
void appearanceChanged()
Emitted whenever the annotation's appearance changes.
void setFillSymbol(QgsFillSymbol *symbol)
Sets the fill symbol used for rendering the annotation frame.
QgsMargins contentsMargin() const
Returns the margins (in millimeters) between the outside of the frame and the annotation content.
void _writeXml(QDomElement &itemElem, QDomDocument &doc, const QgsReadWriteContext &context) const
Writes common annotation properties to a DOM element.
QgsMapLayer * mapLayer() const
Returns the map layer associated with the annotation.
void setFrameSizeMm(QSizeF size)
Sets the size (in millimeters) of the annotation's frame (the main area in which the annotation's con...
virtual void setAssociatedFeature(const QgsFeature &feature)
Sets the feature associated with the annotation.
QgsFeature associatedFeature() const
Returns the feature associated with the annotation, or an invalid feature if none has been set.
void _readXml(const QDomElement &annotationElem, const QgsReadWriteContext &context)
Reads common annotation properties from a DOM element.
void copyCommonProperties(QgsAnnotation *target) const
Copies common annotation properties to the targe annotation.
QgsAnnotation(QObject *parent=nullptr)
Constructor for QgsAnnotation.
QgsFillSymbol * fillSymbol() const
Returns the symbol that is used for rendering the annotation frame.
void setMapLayer(QgsMapLayer *layer)
Sets the map layer associated with the annotation.
QgsEditorWidgetWrapper * create(const QString &widgetId, QgsVectorLayer *vl, int fieldIdx, const QVariantMap &config, QWidget *editor, QWidget *parent, const QgsAttributeEditorContext &context=QgsAttributeEditorContext())
Create an attribute editor widget wrapper of a given type for a given field.
virtual QStringList additionalFields() const
Returns the list of additional fields which the editor handles.
void setValues(const QVariant &value, const QVariantList &additionalValues)
Is called when the value of the widget or additional field values needs to be changed.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsAttributes attributes
Definition qgsfeature.h:67
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition qgsfeedback.h:53
int count
Definition qgsfields.h:50
Q_INVOKABLE int indexFromName(const QString &fieldName) const
Gets the field index from the field name.
QgsField at(int i) const
Returns the field at particular index (must be in range 0..N-1).
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
QgsFillSymbol * clone() const override
Returns a deep copy of this symbol.
QgsFormAnnotation * clone() const override
Clones the annotation, returning a new copy of the annotation reflecting the annotation's current sta...
void renderAnnotation(QgsRenderContext &context, QSizeF size) const override
Renders the annotation's contents to a target /a context at the specified /a size.
QgsFormAnnotation(QObject *parent=nullptr)
Constructor for QgsFormAnnotation.
void setAssociatedFeature(const QgsFeature &feature) override
Sets the feature associated with the annotation.
void writeXml(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Writes the annotation state to a DOM element.
void readXml(const QDomElement &itemElem, const QgsReadWriteContext &context) override
Restores the annotation's state from a DOM element.
QSizeF minimumFrameSize() const override
Returns the minimum frame size for the annotation.
void setDesignerForm(const QString &uiFile)
Sets the path to the Qt Designer UI file to show in the annotation.
QSizeF preferredFrameSize() const
Returns the optimal frame size.
static QgsEditorWidgetRegistry * editorWidgetRegistry()
Returns the global editor widget registry, used for managing all known edit widget factories.
Definition qgsgui.cpp:106
static QgsProject * instance()
Returns the QgsProject singleton instance.
A container for the context for various read/write operations on objects.
Contains information about the context of a rendering operation.
QPainter * painter()
Returns the destination QPainter for the render operation.
QgsFeedback * feedback() const
Returns the feedback object that can be queried regularly during rendering to check if rendering shou...
Scoped object for saving and restoring a QPainter object's state.
void setColor(const QColor &color) const
Sets the color for the symbol.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c