QGIS API Documentation  2.5.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
qgscategorizedsymbolrendererv2.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgscategorizedsymbolrendererv2.h
3  ---------------------
4  begin : November 2009
5  copyright : (C) 2009 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 QGSCATEGORIZEDSYMBOLRENDERERV2_H
16 #define QGSCATEGORIZEDSYMBOLRENDERERV2_H
17 
18 #include "qgssymbolv2.h"
19 #include "qgsrendererv2.h"
20 #include "qgsexpression.h"
21 
22 #include <QHash>
23 #include <QScopedPointer>
24 
26 class QgsVectorLayer;
27 
28 /* \brief categorized renderer */
29 class CORE_EXPORT QgsRendererCategoryV2
30 {
31  public:
33 
35  QgsRendererCategoryV2( QVariant value, QgsSymbolV2* symbol, QString label, bool render = true );
36 
39 
41 
42  QVariant value() const;
43  QgsSymbolV2* symbol() const;
44  QString label() const;
45 
46  void setValue( const QVariant &value );
47  void setSymbol( QgsSymbolV2* s );
48  void setLabel( const QString &label );
49 
50  // @note added in 2.5
51  bool renderState() const;
52  void setRenderState( bool render );
53 
54  // debugging
55  QString dump() const;
56 
57  void toSld( QDomDocument& doc, QDomElement &element, QgsStringMap props ) const;
58 
59  protected:
60  QVariant mValue;
61  QScopedPointer<QgsSymbolV2> mSymbol;
62  QString mLabel;
63  bool mRender;
64 
65  void swap( QgsRendererCategoryV2 & other );
66 };
67 
68 typedef QList<QgsRendererCategoryV2> QgsCategoryList;
69 
71 {
72  public:
73 
74  QgsCategorizedSymbolRendererV2( QString attrName = QString(), QgsCategoryList categories = QgsCategoryList() );
75 
77 
78  virtual QgsSymbolV2* symbolForFeature( QgsFeature& feature );
79 
80  virtual void startRender( QgsRenderContext& context, const QgsFields& fields );
81 
82  virtual void stopRender( QgsRenderContext& context );
83 
84  virtual QList<QString> usedAttributes();
85 
86  virtual QString dump() const;
87 
88  virtual QgsFeatureRendererV2* clone() const;
89 
90  virtual void toSld( QDomDocument& doc, QDomElement &element ) const;
91 
94  virtual int capabilities() { return SymbolLevels | RotationField | Filter; }
95 
96  virtual QgsSymbolV2List symbols();
98  void updateSymbols( QgsSymbolV2 * sym );
99 
100  const QgsCategoryList& categories() const { return mCategories; }
101 
103  int categoryIndexForValue( QVariant val );
104 
107  int categoryIndexForLabel( QString val );
108 
109  bool updateCategoryValue( int catIndex, const QVariant &value );
110  bool updateCategorySymbol( int catIndex, QgsSymbolV2* symbol );
111  bool updateCategoryLabel( int catIndex, QString label );
112 
114  bool updateCategoryRenderState( int catIndex, bool render );
115 
116  void addCategory( const QgsRendererCategoryV2 &category );
117  bool deleteCategory( int catIndex );
118  void deleteAllCategories();
119 
121  void moveCategory( int from, int to );
122 
123  void sortByValue( Qt::SortOrder order = Qt::AscendingOrder );
124  void sortByLabel( Qt::SortOrder order = Qt::AscendingOrder );
125 
126  QString classAttribute() const { return mAttrName; }
127  void setClassAttribute( QString attr ) { mAttrName = attr; }
128 
130  static QgsFeatureRendererV2* create( QDomElement& element );
131 
133  virtual QDomElement save( QDomDocument& doc );
134 
136  virtual QgsLegendSymbologyList legendSymbologyItems( QSize iconSize );
137 
141  virtual QgsLegendSymbolList legendSymbolItems( double scaleDenominator = -1, QString rule = QString() );
142 
143  QgsSymbolV2* sourceSymbol();
144  void setSourceSymbol( QgsSymbolV2* sym );
145 
146  QgsVectorColorRampV2* sourceColorRamp();
147  void setSourceColorRamp( QgsVectorColorRampV2* ramp );
148 
150  bool invertedColorRamp() { return mInvertedColorRamp; }
151  void setInvertedColorRamp( bool inverted ) { mInvertedColorRamp = inverted; }
152 
154  void setRotationField( QString fieldOrExpression );
156  QString rotationField() const;
157 
159  void setSizeScaleField( QString fieldOrExpression );
161  QString sizeScaleField() const;
162 
164  void setScaleMethod( QgsSymbolV2::ScaleMethod scaleMethod );
166  QgsSymbolV2::ScaleMethod scaleMethod() const { return mScaleMethod; }
167 
170  virtual bool legendSymbolItemsCheckable() const;
171 
173  // @note added in 2.5
174  virtual bool legendSymbolItemChecked( QString key );
175 
177  // @note added in 2.5
178  virtual void checkLegendSymbolItem( QString key, bool state = true );
179 
182  virtual QString legendClassificationAttribute() const { return classAttribute(); }
183 
187  static QgsCategorizedSymbolRendererV2* convertFromRenderer( const QgsFeatureRendererV2 *renderer );
188 
189  protected:
190  QString mAttrName;
192  QScopedPointer<QgsSymbolV2> mSourceSymbol;
193  QScopedPointer<QgsVectorColorRampV2> mSourceColorRamp;
195  QScopedPointer<QgsExpression> mRotation;
196  QScopedPointer<QgsExpression> mSizeScale;
198  QScopedPointer<QgsExpression> mExpression;
199 
201  int mAttrNum;
202 
204  QHash<QString, QgsSymbolV2*> mSymbolHash;
205  bool mCounting;
206 
208  QHash<QString, QgsSymbolV2*> mTempSymbols;
209 
210  void rebuildHash();
211 
212  QgsSymbolV2* symbolForValue( QVariant value );
213 
215 };
216 
217 
218 #endif // QGSCATEGORIZEDSYMBOLRENDERERV2_H
QgsSymbolV2::ScaleMethod mScaleMethod
Definition: qgscategorizedsymbolrendererv2.h:197
virtual void setRotationField(QString fieldName)
sets rotation field of renderer (if supported by the renderer)
Definition: qgsrendererv2.h:190
virtual void checkLegendSymbolItem(QString key, bool state=true)
item in symbology was checked
Definition: qgsrendererv2.cpp:523
const QgsCategoryList & categories() const
Definition: qgscategorizedsymbolrendererv2.h:100
QList< QgsSymbolV2 * > QgsSymbolV2List
Definition: qgsrendererv2.h:37
virtual QString legendClassificationAttribute() const
If supported by the renderer, return classification attribute for the use in legend.
Definition: qgscategorizedsymbolrendererv2.h:182
virtual QString dump() const
for debugging
Definition: qgsrendererv2.cpp:367
Definition: qgscategorizedsymbolrendererv2.h:29
virtual QDomElement save(QDomDocument &doc)
store renderer info to XML element
Definition: qgsrendererv2.cpp:395
QScopedPointer< QgsSymbolV2 > mSourceSymbol
Definition: qgscategorizedsymbolrendererv2.h:192
virtual QgsLegendSymbolList legendSymbolItems(double scaleDenominator=-1, QString rule="")
return a list of item text / symbol
Definition: qgsrendererv2.cpp:529
QScopedPointer< QgsExpression > mRotation
Definition: qgscategorizedsymbolrendererv2.h:195
Container of fields for a vector layer.
Definition: qgsfield.h:163
virtual QList< QString > usedAttributes()=0
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:113
QScopedPointer< QgsSymbolV2 > mSymbol
Definition: qgscategorizedsymbolrendererv2.h:61
QMap< QString, QString > QgsStringMap
Definition: qgis.h:416
virtual QgsLegendSymbologyList legendSymbologyItems(QSize iconSize)
return a list of symbology items for the legend
Definition: qgsrendererv2.cpp:505
QHash< QString, QgsSymbolV2 * > mSymbolHash
hashtable for faster access to symbols
Definition: qgscategorizedsymbolrendererv2.h:204
virtual void startRender(QgsRenderContext &context, const QgsFields &fields)=0
QScopedPointer< QgsExpression > mSizeScale
Definition: qgscategorizedsymbolrendererv2.h:196
QgsCategoryList mCategories
Definition: qgscategorizedsymbolrendererv2.h:191
virtual void stopRender(QgsRenderContext &context)=0
virtual QString rotationField() const
return rotation field name (or empty string if not set or not supported by renderer) ...
Definition: qgsrendererv2.h:187
virtual QgsSymbolV2List symbols()=0
for symbol levels
virtual QgsFeatureRendererV2 * clone() const =0
QList< QgsRendererCategoryV2 > QgsCategoryList
Definition: qgscategorizedsymbolrendererv2.h:68
QScopedPointer< QgsVectorColorRampV2 > mSourceColorRamp
Definition: qgscategorizedsymbolrendererv2.h:193
bool mCounting
Definition: qgscategorizedsymbolrendererv2.h:205
virtual bool legendSymbolItemChecked(QString key)
items of symbology items in legend is checked
Definition: qgsrendererv2.cpp:517
Definition: qgscategorizedsymbolrendererv2.h:70
void setClassAttribute(QString attr)
Definition: qgscategorizedsymbolrendererv2.h:127
static QgsMarkerSymbolV2 sSkipRender
Definition: qgscategorizedsymbolrendererv2.h:214
QVariant mValue
Definition: qgscategorizedsymbolrendererv2.h:60
Definition: qgssymbolv2.h:43
QHash< QString, QgsSymbolV2 * > mTempSymbols
temporary symbols, used for data-defined rotation and scaling
Definition: qgscategorizedsymbolrendererv2.h:208
QList< QPair< QString, QPixmap > > QgsLegendSymbologyList
Definition: qgspluginlayer.h:20
bool mInvertedColorRamp
Definition: qgscategorizedsymbolrendererv2.h:194
virtual void toSld(QDomDocument &doc, QDomElement &element) const
used from subclasses to create SLD Rule elements following SLD v1.1 specs
Definition: qgsrendererv2.h:150
Definition: qgssymbolv2.h:227
bool invertedColorRamp()
Definition: qgscategorizedsymbolrendererv2.h:150
Contains information about the context of a rendering operation.
Definition: qgsrendercontext.h:39
ScaleMethod
Definition: qgssymbolv2.h:61
virtual bool legendSymbolItemsCheckable() const
items of symbology items in legend should be checkable
Definition: qgsrendererv2.cpp:512
int mAttrNum
attribute index (derived from attribute name in startRender)
Definition: qgscategorizedsymbolrendererv2.h:201
QString classAttribute() const
Definition: qgscategorizedsymbolrendererv2.h:126
Definition: qgsrendererv2.h:72
bool mRender
Definition: qgscategorizedsymbolrendererv2.h:63
QgsSymbolV2::ScaleMethod scaleMethod() const
Definition: qgscategorizedsymbolrendererv2.h:166
Definition: qgsrendererv2.h:111
QString mLabel
Definition: qgscategorizedsymbolrendererv2.h:62
Represents a vector layer which manages a vector based data sets.
Definition: qgsvectorlayer.h:470
Definition: qgsvectorcolorrampv2.h:25
QList< QPair< QString, QgsSymbolV2 * > > QgsLegendSymbolList
Definition: qgsrendererv2.h:41
virtual QgsSymbolV2 * symbolForFeature(QgsFeature &feature)=0
to be overridden
QString mAttrName
Definition: qgscategorizedsymbolrendererv2.h:190
virtual int capabilities()
returns bitwise OR-ed capabilities of the renderer
Definition: qgscategorizedsymbolrendererv2.h:94
QScopedPointer< QgsExpression > mExpression
Definition: qgscategorizedsymbolrendererv2.h:198
void setInvertedColorRamp(bool inverted)
Definition: qgscategorizedsymbolrendererv2.h:151