QGIS API Documentation 3.43.0-Master (56aa1fd18d7)
qgsvectorlayerlabeling.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsvectorlayerlabeling.h
3 ---------------------
4 begin : September 2015
5 copyright : (C) 2015 by Martin Dobias
6 email : wonder dot sk at gmail dot com
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#ifndef QGSVECTORLAYERLABELING_H
16#define QGSVECTORLAYERLABELING_H
17
18#include <memory>
19
20#include <QString>
21#include <QStringList>
22#include <QDomNode>
23
24#include "qgis.h"
25
26class QDomDocument;
27class QDomElement;
28
31class QgsVectorLayer;
35
42{
43
44#ifdef SIP_RUN
46 if ( sipCpp->type() == "simple" )
47 sipType = sipType_QgsVectorLayerSimpleLabeling;
48 else if ( sipCpp->type() == "rule-based" )
49 sipType = sipType_QgsRuleBasedLabeling;
50 else
51 sipType = 0;
53#endif
54
55 public:
56
59
61 virtual QString type() const = 0;
62
65
70 virtual QgsVectorLayerLabelProvider *provider( QgsVectorLayer *layer ) const SIP_SKIP { Q_UNUSED( layer ) return nullptr; }
71
73 virtual QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) const = 0;
74
76 virtual QStringList subProviders() const { return QStringList( QString() ); }
77
82 virtual QgsPalLayerSettings settings( const QString &providerId = QString() ) const = 0;
83
91 virtual void setSettings( QgsPalLayerSettings *settings SIP_TRANSFER, const QString &providerId = QString() ) = 0;
92
98 virtual bool requiresAdvancedEffects() const = 0;
99
108 virtual void multiplyOpacity( double opacityFactor ) { Q_UNUSED( opacityFactor ); };
109
110
111 // static stuff
112
114 static QgsAbstractVectorLayerLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ) SIP_FACTORY;
115
121 Q_DECL_DEPRECATED virtual void toSld( QDomNode &parent, const QVariantMap &props ) const SIP_DEPRECATED;
122
128 virtual bool toSld( QDomNode &parent, QgsSldExportContext &context ) const;
129
139 virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
140
146 static QgsPalLayerSettings defaultSettingsForLayer( const QgsVectorLayer *layer );
147
148 protected:
149
157 Q_DECL_DEPRECATED virtual void writeTextSymbolizer( QDomNode &parent, QgsPalLayerSettings &settings, const QVariantMap &props ) const SIP_DEPRECATED;
158
166 virtual bool writeTextSymbolizer( QDomNode &parent, QgsPalLayerSettings &settings, QgsSldExportContext &context ) const;
167
168 private:
169 Q_DISABLE_COPY( QgsAbstractVectorLayerLabeling )
170
171#ifdef SIP_RUN
173#endif
174
175};
176
185{
186 public:
188 explicit QgsVectorLayerSimpleLabeling( const QgsPalLayerSettings &settings );
189
190 QString type() const override;
191 QgsAbstractVectorLayerLabeling *clone() const override SIP_FACTORY;
193 QgsVectorLayerLabelProvider *provider( QgsVectorLayer *layer ) const override SIP_SKIP;
194 QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) const override;
195 QgsPalLayerSettings settings( const QString &providerId = QString() ) const override;
196 bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;
197
205 void setSettings( QgsPalLayerSettings *settings SIP_TRANSFER, const QString &providerId = QString() ) override;
206
207 bool requiresAdvancedEffects() const override;
208 Q_DECL_DEPRECATED void toSld( QDomNode &parent, const QVariantMap &props ) const override SIP_DEPRECATED;
209 bool toSld( QDomNode &parent, QgsSldExportContext &context ) const override;
210 void multiplyOpacity( double opacityFactor ) override;
212 static QgsVectorLayerSimpleLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ); // cppcheck-suppress duplInheritedMember
213
214 private:
215 std::unique_ptr<QgsPalLayerSettings> mSettings;
216};
217
218#endif // QGSVECTORLAYERLABELING_H
Abstract base class - its implementations define different approaches to the labeling of a vector lay...
virtual QStringList subProviders() const
Gets list of sub-providers within the layer's labeling.
virtual void setSettings(QgsPalLayerSettings *settings, const QString &providerId=QString())=0
Set pal settings for a specific provider (takes ownership).
virtual ~QgsAbstractVectorLayerLabeling()=default
virtual QgsPalLayerSettings settings(const QString &providerId=QString()) const =0
Gets associated label settings.
virtual bool requiresAdvancedEffects() const =0
Returns true if drawing labels requires advanced effects like composition modes, which could prevent ...
virtual QString type() const =0
Unique type string of the labeling configuration implementation.
virtual QgsVectorLayerLabelProvider * provider(QgsVectorLayer *layer) const
Factory for label provider implementation.
virtual QDomElement save(QDomDocument &doc, const QgsReadWriteContext &context) const =0
Returns labeling configuration as XML element.
virtual void multiplyOpacity(double opacityFactor)
Multiply opacity by opacityFactor.
virtual QgsAbstractVectorLayerLabeling * clone() const =0
Returns a new copy of the object.
Contains settings for how a map layer will be labeled.
A container for the context for various read/write operations on objects.
Holds SLD export options and other information related to SLD export of a QGIS layer style.
An interface for classes which can visit style entity (e.g.
Implements a label provider for vector layers.
Basic implementation of the labeling interface.
Represents a vector layer which manages a vector based dataset.
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition qgis_sip.h:191
#define SIP_DEPRECATED
Definition qgis_sip.h:106
#define SIP_SKIP
Definition qgis_sip.h:126
#define SIP_TRANSFER
Definition qgis_sip.h:36
#define SIP_FACTORY
Definition qgis_sip.h:76
#define SIP_END
Definition qgis_sip.h:208