QGIS API Documentation  2.18.21-Las Palmas (9fba24a)
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | List of all members
QgsGraduatedSymbolRendererV2 Class Reference

#include <qgsgraduatedsymbolrendererv2.h>

Inheritance diagram for QgsGraduatedSymbolRendererV2:
Inheritance graph
[legend]

Public Types

enum  GraduatedMethod { GraduatedColor = 0, GraduatedSize = 1 }
 
enum  Mode {
  EqualInterval, Quantile, Jenks, StdDev,
  Pretty, Custom
}
 
- Public Types inherited from QgsFeatureRendererV2
enum  Capabilities {
  SymbolLevels = 1, RotationField = 1 << 1, MoreSymbolsPerFeature = 1 << 2, Filter = 1 << 3,
  ScaleDependent = 1 << 4
}
 

Public Member Functions

 QgsGraduatedSymbolRendererV2 (const QString &attrName=QString(), const QgsRangeList &ranges=QgsRangeList())
 
virtual ~QgsGraduatedSymbolRendererV2 ()
 
void addBreak (double breakValue, bool updateSymbols=true)
 Add a breakpoint by splitting existing classes so that the specified value becomes a break between two classes. More...
 
void addClass (QgsSymbolV2 *symbol)
 
void addClass (const QgsRendererRangeV2 &range)
 
void addClass (double lower, double upper)
 
void calculateLabelPrecision (bool updateRanges=true)
 Reset the label decimal places to a numberbased on the minimum class interval. More...
 
virtual int capabilities () override
 returns bitwise OR-ed capabilities of the renderer More...
 
virtual void checkLegendSymbolItem (const QString &key, bool state=true) override
 item in symbology was checked More...
 
QString classAttribute () const
 
virtual QgsGraduatedSymbolRendererV2clone () const override
 
void deleteAllClasses ()
 
void deleteClass (int idx)
 
virtual QString dump () const override
 for debugging More...
 
Q_DECL_DEPRECATED QList< double > getDataValues (QgsVectorLayer *vlayer)
 Evaluates the data expression and returns the list of values from the layer. More...
 
GraduatedMethod graduatedMethod () const
 return the method used for graduation (either size or color) More...
 
bool invertedColorRamp ()
 
const QgsRendererRangeV2LabelFormatlabelFormat () const
 Return the label format used to generate default classification labels. More...
 
virtual QString legendClassificationAttribute () const override
 If supported by the renderer, return classification attribute for the use in legend. More...
 
virtual QSet< QStringlegendKeysForFeature (QgsFeature &feature, QgsRenderContext &context) override
 Return legend keys matching a specified feature. More...
 
virtual bool legendSymbolItemChecked (const QString &key) override
 item in symbology was checked More...
 
virtual QgsLegendSymbolList legendSymbolItems (double scaleDenominator=-1, const QString &rule=QString()) override
 return a list of item text / symbol More...
 
virtual bool legendSymbolItemsCheckable () const override
 items of symbology items in legend should be checkable More...
 
QgsLegendSymbolListV2 legendSymbolItemsV2 () const override
 
virtual QgsLegendSymbologyList legendSymbologyItems (QSize iconSize) override
 return a list of symbology items for the legend More...
 
double maxSymbolSize () const
 return the max symbol size when graduated by size More...
 
double minSymbolSize () const
 return the min symbol size when graduated by size More...
 
Mode mode () const
 
void moveClass (int from, int to)
 Moves the category at index position from to index position to. More...
 
virtual QgsSymbolV2originalSymbolForFeature (QgsFeature &feature, QgsRenderContext &context) override
 
const QgsRangeListranges () const
 
bool rangesHaveGaps () const
 Tests whether classes assigned to the renderer have gaps between the ranges. More...
 
bool rangesOverlap () const
 Tests whether classes assigned to the renderer have ranges which overlap. More...
 
Q_DECL_DEPRECATED QString rotationField () const override
 return rotation field name (or empty string if not set or not supported by renderer) More...
 
virtual QDomElement save (QDomDocument &doc) override
 store renderer info to XML element More...
 
QgsSymbolV2::ScaleMethod scaleMethod () const
 
void setClassAttribute (const QString &attr)
 
void setGraduatedMethod (GraduatedMethod method)
 set the method used for graduation (either size or color) More...
 
void setInvertedColorRamp (bool inverted)
 
void setLabelFormat (const QgsRendererRangeV2LabelFormat &labelFormat, bool updateRanges=false)
 Set the label format used to generate default classification labels. More...
 
virtual void setLegendSymbolItem (const QString &key, QgsSymbolV2 *symbol) override
 Sets the symbol to be used for a legend symbol item. More...
 
void setMode (Mode mode)
 
Q_DECL_DEPRECATED void setRotationField (const QString &fieldOrExpression) override
 sets rotation field of renderer (if supported by the renderer) More...
 
void setScaleMethod (QgsSymbolV2::ScaleMethod scaleMethod)
 
void setSizeScaleField (const QString &fieldOrExpression)
 
void setSourceColorRamp (QgsVectorColorRampV2 *ramp)
 Sets the source color ramp. More...
 
void setSourceSymbol (QgsSymbolV2 *sym)
 Sets the source symbol for the renderer, which is the base symbol used for the each classes' symbol before applying the classes' color. More...
 
void setSymbolSizes (double minSize, double maxSize)
 set varying symbol size for classes More...
 
QString sizeScaleField () const
 
void sortByLabel (Qt::SortOrder order=Qt::AscendingOrder)
 
void sortByValue (Qt::SortOrder order=Qt::AscendingOrder)
 
QgsVectorColorRampV2sourceColorRamp ()
 Returns the source color ramp, from which each classes' color is derived. More...
 
QgsSymbolV2sourceSymbol ()
 Returns the renderer's source symbol, which is the base symbol used for the each classes' symbol before applying the classes' color. More...
 
virtual void startRender (QgsRenderContext &context, const QgsFields &fields) override
 Needs to be called when a new render cycle is started. More...
 
virtual void stopRender (QgsRenderContext &context) override
 Needs to be called when a render cycle has finished to clean up. More...
 
virtual QgsSymbolV2symbolForFeature (QgsFeature &feature, QgsRenderContext &context) override
 
virtual QgsSymbolV2List symbols (QgsRenderContext &context) override
 
virtual void toSld (QDomDocument &doc, QDomElement &element) const override
 Writes the SLD element following the SLD v1.1 specs. More...
 
virtual void toSld (QDomDocument &doc, QDomElement &element, const QgsStringMap &props) const override
 Writes the SLD element following the SLD v1.1 specs. More...
 
void updateClasses (QgsVectorLayer *vlayer, Mode mode, int nclasses)
 Recalculate classes for a layer. More...
 
void updateColorRamp (QgsVectorColorRampV2 *ramp=nullptr, bool inverted=false)
 Update the color ramp used. More...
 
bool updateRangeLabel (int rangeIndex, const QString &label)
 
bool updateRangeLowerValue (int rangeIndex, double value)
 
bool updateRangeRenderState (int rangeIndex, bool render)
 
bool updateRangeSymbol (int rangeIndex, QgsSymbolV2 *symbol)
 
bool updateRangeUpperValue (int rangeIndex, double value)
 
void updateSymbols (QgsSymbolV2 *sym)
 Update all the symbols but leave breaks and colors. More...
 
virtual QList< QStringusedAttributes () override
 Returns a set of attributes required for this renderer. More...
 
- Public Member Functions inherited from QgsFeatureRendererV2
virtual ~QgsFeatureRendererV2 ()
 
virtual const QgsFeatureRendererV2embeddedRenderer () const
 Returns the current embedded renderer (subrenderer) for this feature renderer. More...
 
virtual QString filter (const QgsFields &fields=QgsFields())
 If a renderer does not require all the features this method may be overridden and return an expression used as where clause. More...
 
virtual bool filterNeedsGeometry () const
 Returns true if this renderer requires the geometry to apply the filter. More...
 
bool forceRasterRender () const
 Returns whether the renderer must render as a raster. More...
 
virtual void modifyRequestExtent (QgsRectangle &extent, QgsRenderContext &context)
 Allows for a renderer to modify the extent of a feature request prior to rendering. More...
 
QgsFeatureRequest::OrderBy orderBy () const
 Get the order in which features shall be processed by this renderer. More...
 
bool orderByEnabled () const
 Returns whether custom ordering will be applied before features are processed by this renderer. More...
 
virtual Q_DECL_DEPRECATED QgsSymbolV2originalSymbolForFeature (QgsFeature &feature)
 Return symbol for feature. More...
 
virtual Q_DECL_DEPRECATED QgsSymbolV2List originalSymbolsForFeature (QgsFeature &feat)
 Equivalent of originalSymbolsForFeature() call extended to support renderers that may use more symbols per feature - similar to symbolsForFeature() More...
 
virtual QgsSymbolV2List originalSymbolsForFeature (QgsFeature &feat, QgsRenderContext &context)
 Equivalent of originalSymbolsForFeature() call extended to support renderers that may use more symbols per feature - similar to symbolsForFeature() More...
 
QgsPaintEffectpaintEffect () const
 Returns the current paint effect for the renderer. More...
 
virtual bool renderFeature (QgsFeature &feature, QgsRenderContext &context, int layer=-1, bool selected=false, bool drawVertexMarker=false)
 Render a feature using this renderer in the given context. More...
 
virtual void setEmbeddedRenderer (QgsFeatureRendererV2 *subRenderer)
 Sets an embedded renderer (subrenderer) for this feature renderer. More...
 
void setForceRasterRender (bool forceRaster)
 Sets whether the renderer should be rendered to a raster destination. More...
 
void setOrderBy (const QgsFeatureRequest::OrderBy &orderBy)
 Define the order in which features shall be processed by this renderer. More...
 
void setOrderByEnabled (bool enabled)
 Sets whether custom ordering should be applied before features are processed by this renderer. More...
 
void setPaintEffect (QgsPaintEffect *effect)
 Sets the current paint effect for the renderer. More...
 
void setUsingSymbolLevels (bool usingSymbolLevels)
 
void setVertexMarkerAppearance (int type, int size)
 set type and size of editing vertex markers for subsequent rendering More...
 
virtual Q_DECL_DEPRECATED void startRender (QgsRenderContext &context, const QgsVectorLayer *vlayer)
 
virtual Q_DECL_DEPRECATED QgsSymbolV2symbolForFeature (QgsFeature &feature)
 To be overridden. More...
 
virtual Q_DECL_DEPRECATED QgsSymbolV2List symbols ()
 For symbol levels. More...
 
virtual Q_DECL_DEPRECATED QgsSymbolV2List symbolsForFeature (QgsFeature &feat)
 Returns list of symbols used for rendering the feature. More...
 
virtual QgsSymbolV2List symbolsForFeature (QgsFeature &feat, QgsRenderContext &context)
 Returns list of symbols used for rendering the feature. More...
 
QString type () const
 
bool usingSymbolLevels () const
 
virtual Q_DECL_DEPRECATED bool willRenderFeature (QgsFeature &feat)
 Returns whether the renderer will render a feature or not. More...
 
virtual bool willRenderFeature (QgsFeature &feat, QgsRenderContext &context)
 Returns whether the renderer will render a feature or not. More...
 
virtual Q_DECL_DEPRECATED QDomElement writeSld (QDomDocument &doc, const QgsVectorLayer &layer) const
 create the SLD UserStyle element following the SLD v1.1 specs More...
 
virtual QDomElement writeSld (QDomDocument &doc, const QString &styleName) const
 create the SLD UserStyle element following the SLD v1.1 specs with the given name More...
 
virtual QDomElement writeSld (QDomDocument &doc, const QString &styleName, const QgsStringMap &props) const
 create the SLD UserStyle element following the SLD v1.1 specs with the given name More...
 

Static Public Member Functions

static QgsGraduatedSymbolRendererV2convertFromRenderer (const QgsFeatureRendererV2 *renderer)
 creates a QgsGraduatedSymbolRendererV2 from an existing renderer. More...
 
static QgsFeatureRendererV2create (QDomElement &element)
 create renderer from XML element More...
 
static QgsGraduatedSymbolRendererV2createRenderer (QgsVectorLayer *vlayer, const QString &attrName, int classes, Mode mode, QgsSymbolV2 *symbol, QgsVectorColorRampV2 *ramp, bool inverted=false, const QgsRendererRangeV2LabelFormat &legendFormat=QgsRendererRangeV2LabelFormat())
 
- Static Public Member Functions inherited from QgsFeatureRendererV2
static QgsFeatureRendererV2defaultRenderer (QGis::GeometryType geomType)
 return a new renderer - used by default in vector layers More...
 
static QgsFeatureRendererV2load (QDomElement &symbologyElem)
 create a renderer from XML element More...
 
static QgsFeatureRendererV2loadSld (const QDomNode &node, QGis::GeometryType geomType, QString &errorMessage)
 Create a new renderer according to the information contained in the UserStyle element of a SLD style document. More...
 

Protected Member Functions

QString legendKeyForValue (double value) const
 Returns the matching legend key for a value. More...
 
QgsSymbolV2symbolForValue (double value)
 
- Protected Member Functions inherited from QgsFeatureRendererV2
 QgsFeatureRendererV2 (const QString &type)
 
Q_DECL_DEPRECATED void copyPaintEffect (QgsFeatureRendererV2 *destRenderer) const
 Copies paint effect of this renderer to another renderer. More...
 
void copyRendererData (QgsFeatureRendererV2 *destRenderer) const
 Clones generic renderer data to another renderer. More...
 
void renderFeatureWithSymbol (QgsFeature &feature, QgsSymbolV2 *symbol, QgsRenderContext &context, int layer, bool selected, bool drawVertexMarker)
 
void renderVertexMarker (QPointF pt, QgsRenderContext &context)
 render editing vertex marker at specified point More...
 
void renderVertexMarkerPolygon (QPolygonF &pts, QList< QPolygonF > *rings, QgsRenderContext &context)
 render editing vertex marker for a polygon More...
 
void renderVertexMarkerPolyline (QPolygonF &pts, QgsRenderContext &context)
 render editing vertex marker for a polyline More...
 
void setScaleMethodToSymbol (QgsSymbolV2 *symbol, int scaleMethod)
 

Static Protected Member Functions

static const char * graduatedMethodStr (GraduatedMethod method)
 
- Static Protected Member Functions inherited from QgsFeatureRendererV2
static QgsConstWkbPtr _getLineString (QPolygonF &pts, QgsRenderContext &context, QgsConstWkbPtr &wkb, bool clipToExtent=true)
 Creates a line string in screen coordinates from a wkb string in map coordinates. More...
 
static QgsConstWkbPtr _getPoint (QPointF &pt, QgsRenderContext &context, QgsConstWkbPtr &wkb)
 Creates a point in screen coordinates from a wkb string in map coordinates. More...
 
static QgsConstWkbPtr _getPolygon (QPolygonF &pts, QList< QPolygonF > &holes, QgsRenderContext &context, QgsConstWkbPtr &wkb, bool clipToExtent=true)
 Creates a polygon in screen coordinates from a wkb string in map coordinates. More...
 
static void convertSymbolRotation (QgsSymbolV2 *symbol, const QString &field)
 
static void convertSymbolSizeScale (QgsSymbolV2 *symbol, QgsSymbolV2::ScaleMethod method, const QString &field)
 

Protected Attributes

QString mAttrName
 
int mAttrNum
 attribute index (derived from attribute name in startRender) More...
 
bool mCounting
 
QScopedPointer< QgsExpressionmExpression
 
GraduatedMethod mGraduatedMethod
 
bool mInvertedColorRamp
 
QgsRendererRangeV2LabelFormat mLabelFormat
 
Mode mMode
 
QgsRangeList mRanges
 
QScopedPointer< QgsExpressionmRotation
 
QgsSymbolV2::ScaleMethod mScaleMethod
 
QScopedPointer< QgsExpressionmSizeScale
 
QScopedPointer< QgsVectorColorRampV2mSourceColorRamp
 
QScopedPointer< QgsSymbolV2mSourceSymbol
 
QHash< QgsSymbolV2 *, QgsSymbolV2 * > mTempSymbols
 temporary symbols, used for data-defined rotation and scaling More...
 
- Protected Attributes inherited from QgsFeatureRendererV2
int mCurrentVertexMarkerSize
 The current size of editing marker. More...
 
int mCurrentVertexMarkerType
 The current type of editing marker. More...
 
bool mForceRaster
 
QgsFeatureRequest::OrderBy mOrderBy
 
bool mOrderByEnabled
 
QgsPaintEffectmPaintEffect
 
QString mType
 
bool mUsingSymbolLevels
 

Detailed Description

Definition at line 132 of file qgsgraduatedsymbolrendererv2.h.

Member Enumeration Documentation

◆ GraduatedMethod

Enumerator
GraduatedColor 
GraduatedSize 

Definition at line 339 of file qgsgraduatedsymbolrendererv2.h.

◆ Mode

Enumerator
EqualInterval 
Quantile 
Jenks 
StdDev 
Pretty 
Custom 

Definition at line 214 of file qgsgraduatedsymbolrendererv2.h.

Constructor & Destructor Documentation

◆ QgsGraduatedSymbolRendererV2()

QgsGraduatedSymbolRendererV2::QgsGraduatedSymbolRendererV2 ( const QString attrName = QString(),
const QgsRangeList ranges = QgsRangeList() 
)

Definition at line 286 of file qgsgraduatedsymbolrendererv2.cpp.

◆ ~QgsGraduatedSymbolRendererV2()

QgsGraduatedSymbolRendererV2::~QgsGraduatedSymbolRendererV2 ( )
virtual

Definition at line 309 of file qgsgraduatedsymbolrendererv2.cpp.

Member Function Documentation

◆ addBreak()

void QgsGraduatedSymbolRendererV2::addBreak ( double  breakValue,
bool  updateSymbols = true 
)

Add a breakpoint by splitting existing classes so that the specified value becomes a break between two classes.

Parameters
breakValueposition to insert break
updateSymbolsset to true to reapply ramp colors to the new symbol ranges
Note
added in QGIS 2.9

Definition at line 1525 of file qgsgraduatedsymbolrendererv2.cpp.

◆ addClass() [1/3]

void QgsGraduatedSymbolRendererV2::addClass ( QgsSymbolV2 symbol)

Definition at line 1511 of file qgsgraduatedsymbolrendererv2.cpp.

◆ addClass() [2/3]

void QgsGraduatedSymbolRendererV2::addClass ( const QgsRendererRangeV2 range)
Note
available in python bindings as addClassRange

Definition at line 1564 of file qgsgraduatedsymbolrendererv2.cpp.

◆ addClass() [3/3]

void QgsGraduatedSymbolRendererV2::addClass ( double  lower,
double  upper 
)
Note
available in python bindings as addClassLowerUpper

Definition at line 1518 of file qgsgraduatedsymbolrendererv2.cpp.

◆ calculateLabelPrecision()

void QgsGraduatedSymbolRendererV2::calculateLabelPrecision ( bool  updateRanges = true)

Reset the label decimal places to a numberbased on the minimum class interval.

Parameters
updateRangesif true then ranges currently using the default label will be updated
Note
Added in 2.6

Definition at line 1592 of file qgsgraduatedsymbolrendererv2.cpp.

◆ capabilities()

virtual int QgsGraduatedSymbolRendererV2::capabilities ( )
inlineoverridevirtual

returns bitwise OR-ed capabilities of the renderer

Reimplemented from QgsFeatureRendererV2.

Definition at line 161 of file qgsgraduatedsymbolrendererv2.h.

◆ checkLegendSymbolItem()

void QgsGraduatedSymbolRendererV2::checkLegendSymbolItem ( const QString key,
bool  state = true 
)
overridevirtual

item in symbology was checked

Note
added in 2.6

Reimplemented from QgsFeatureRendererV2.

Definition at line 1493 of file qgsgraduatedsymbolrendererv2.cpp.

◆ classAttribute()

QString QgsGraduatedSymbolRendererV2::classAttribute ( ) const
inline

Definition at line 166 of file qgsgraduatedsymbolrendererv2.h.

◆ clone()

QgsGraduatedSymbolRendererV2 * QgsGraduatedSymbolRendererV2::clone ( ) const
overridevirtual

Implements QgsFeatureRendererV2.

Definition at line 543 of file qgsgraduatedsymbolrendererv2.cpp.

◆ convertFromRenderer()

QgsGraduatedSymbolRendererV2 * QgsGraduatedSymbolRendererV2::convertFromRenderer ( const QgsFeatureRendererV2 renderer)
static

creates a QgsGraduatedSymbolRendererV2 from an existing renderer.

Note
added in 2.6
Returns
a new renderer if the conversion was possible, otherwise 0.

Definition at line 1722 of file qgsgraduatedsymbolrendererv2.cpp.

◆ create()

QgsFeatureRendererV2 * QgsGraduatedSymbolRendererV2::create ( QDomElement element)
static

create renderer from XML element

Definition at line 986 of file qgsgraduatedsymbolrendererv2.cpp.

◆ createRenderer()

QgsGraduatedSymbolRendererV2 * QgsGraduatedSymbolRendererV2::createRenderer ( QgsVectorLayer vlayer,
const QString attrName,
int  classes,
Mode  mode,
QgsSymbolV2 symbol,
QgsVectorColorRampV2 ramp,
bool  inverted = false,
const QgsRendererRangeV2LabelFormat legendFormat = QgsRendererRangeV2LabelFormat() 
)
static

Definition at line 844 of file qgsgraduatedsymbolrendererv2.cpp.

◆ deleteAllClasses()

void QgsGraduatedSymbolRendererV2::deleteAllClasses ( )

Definition at line 1574 of file qgsgraduatedsymbolrendererv2.cpp.

◆ deleteClass()

void QgsGraduatedSymbolRendererV2::deleteClass ( int  idx)

Definition at line 1569 of file qgsgraduatedsymbolrendererv2.cpp.

◆ dump()

QString QgsGraduatedSymbolRendererV2::dump ( ) const
overridevirtual

for debugging

Reimplemented from QgsFeatureRendererV2.

Definition at line 535 of file qgsgraduatedsymbolrendererv2.cpp.

◆ getDataValues()

QList< double > QgsGraduatedSymbolRendererV2::getDataValues ( QgsVectorLayer vlayer)

Evaluates the data expression and returns the list of values from the layer.

Parameters
vlayerThe layer for which to evaluate the expression
Note
Added in 2.6
Deprecated:
use QgsVectorLayer::getDoubleValues instead

Definition at line 866 of file qgsgraduatedsymbolrendererv2.cpp.

◆ graduatedMethod()

GraduatedMethod QgsGraduatedSymbolRendererV2::graduatedMethod ( ) const
inline

return the method used for graduation (either size or color)

Note
added in 2.10

Definition at line 343 of file qgsgraduatedsymbolrendererv2.h.

◆ graduatedMethodStr()

const char * QgsGraduatedSymbolRendererV2::graduatedMethodStr ( GraduatedMethod  method)
staticprotected
Note
not available in Python bindings

Definition at line 1762 of file qgsgraduatedsymbolrendererv2.cpp.

◆ invertedColorRamp()

bool QgsGraduatedSymbolRendererV2::invertedColorRamp ( )
inline
Note
added in 2.1

Definition at line 309 of file qgsgraduatedsymbolrendererv2.h.

◆ labelFormat()

const QgsRendererRangeV2LabelFormat& QgsGraduatedSymbolRendererV2::labelFormat ( ) const
inline

Return the label format used to generate default classification labels.

Note
Added in 2.6

Definition at line 241 of file qgsgraduatedsymbolrendererv2.h.

◆ legendClassificationAttribute()

virtual QString QgsGraduatedSymbolRendererV2::legendClassificationAttribute ( ) const
inlineoverridevirtual

If supported by the renderer, return classification attribute for the use in legend.

Note
added in 2.6

Reimplemented from QgsFeatureRendererV2.

Definition at line 374 of file qgsgraduatedsymbolrendererv2.h.

◆ legendKeyForValue()

QString QgsGraduatedSymbolRendererV2::legendKeyForValue ( double  value) const
protected

Returns the matching legend key for a value.

Definition at line 330 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendKeysForFeature()

QSet< QString > QgsGraduatedSymbolRendererV2::legendKeysForFeature ( QgsFeature feature,
QgsRenderContext context 
)
overridevirtual

Return legend keys matching a specified feature.

Note
added in 2.14

Reimplemented from QgsFeatureRendererV2.

Definition at line 1282 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendSymbolItemChecked()

bool QgsGraduatedSymbolRendererV2::legendSymbolItemChecked ( const QString key)
overridevirtual

item in symbology was checked

Note
added in 2.6

Reimplemented from QgsFeatureRendererV2.

Definition at line 1483 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendSymbolItems()

QgsLegendSymbolList QgsGraduatedSymbolRendererV2::legendSymbolItems ( double  scaleDenominator = -1,
const QString rule = QString() 
)
overridevirtual

return a list of item text / symbol

Note
not available in python bindings

Reimplemented from QgsFeatureRendererV2.

Definition at line 1298 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendSymbolItemsCheckable()

bool QgsGraduatedSymbolRendererV2::legendSymbolItemsCheckable ( ) const
overridevirtual

items of symbology items in legend should be checkable

Note
added in 2.5

Reimplemented from QgsFeatureRendererV2.

Definition at line 1478 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendSymbolItemsV2()

QgsLegendSymbolListV2 QgsGraduatedSymbolRendererV2::legendSymbolItemsV2 ( ) const
overridevirtual
Note
added in 2.10

Reimplemented from QgsFeatureRendererV2.

Definition at line 1232 of file qgsgraduatedsymbolrendererv2.cpp.

◆ legendSymbologyItems()

QgsLegendSymbologyList QgsGraduatedSymbolRendererV2::legendSymbologyItems ( QSize  iconSize)
overridevirtual

return a list of symbology items for the legend

Reimplemented from QgsFeatureRendererV2.

Definition at line 1218 of file qgsgraduatedsymbolrendererv2.cpp.

◆ maxSymbolSize()

double QgsGraduatedSymbolRendererV2::maxSymbolSize ( ) const

return the max symbol size when graduated by size

Note
added in 2.10

Definition at line 1347 of file qgsgraduatedsymbolrendererv2.cpp.

◆ minSymbolSize()

double QgsGraduatedSymbolRendererV2::minSymbolSize ( ) const

return the min symbol size when graduated by size

Note
added in 2.10

Definition at line 1332 of file qgsgraduatedsymbolrendererv2.cpp.

◆ mode()

Mode QgsGraduatedSymbolRendererV2::mode ( ) const
inline

Definition at line 224 of file qgsgraduatedsymbolrendererv2.h.

◆ moveClass()

void QgsGraduatedSymbolRendererV2::moveClass ( int  from,
int  to 
)

Moves the category at index position from to index position to.

Definition at line 1621 of file qgsgraduatedsymbolrendererv2.cpp.

◆ originalSymbolForFeature()

QgsSymbolV2 * QgsGraduatedSymbolRendererV2::originalSymbolForFeature ( QgsFeature feature,
QgsRenderContext context 
)
overridevirtual
Note
originalSymbolForFeature2 in python bindings

Reimplemented from QgsFeatureRendererV2.

Definition at line 396 of file qgsgraduatedsymbolrendererv2.cpp.

◆ ranges()

const QgsRangeList& QgsGraduatedSymbolRendererV2::ranges ( ) const
inline

Definition at line 169 of file qgsgraduatedsymbolrendererv2.h.

◆ rangesHaveGaps()

bool QgsGraduatedSymbolRendererV2::rangesHaveGaps ( ) const

Tests whether classes assigned to the renderer have gaps between the ranges.

Returns
true if ranges have gaps
Note
added in QGIS 2.10

Definition at line 1678 of file qgsgraduatedsymbolrendererv2.cpp.

◆ rangesOverlap()

bool QgsGraduatedSymbolRendererV2::rangesOverlap ( ) const

Tests whether classes assigned to the renderer have ranges which overlap.

Returns
true if ranges overlap
Note
added in QGIS 2.10

Definition at line 1650 of file qgsgraduatedsymbolrendererv2.cpp.

◆ rotationField()

QString QgsGraduatedSymbolRendererV2::rotationField ( ) const
overridevirtual

return rotation field name (or empty string if not set or not supported by renderer)

Deprecated:
use the symbol's methods instead

Reimplemented from QgsFeatureRendererV2.

Definition at line 1446 of file qgsgraduatedsymbolrendererv2.cpp.

◆ save()

QDomElement QgsGraduatedSymbolRendererV2::save ( QDomDocument doc)
overridevirtual

store renderer info to XML element

Reimplemented from QgsFeatureRendererV2.

Definition at line 1115 of file qgsgraduatedsymbolrendererv2.cpp.

◆ scaleMethod()

QgsSymbolV2::ScaleMethod QgsGraduatedSymbolRendererV2::scaleMethod ( ) const
inline

Definition at line 356 of file qgsgraduatedsymbolrendererv2.h.

◆ setClassAttribute()

void QgsGraduatedSymbolRendererV2::setClassAttribute ( const QString attr)
inline

Definition at line 167 of file qgsgraduatedsymbolrendererv2.h.

◆ setGraduatedMethod()

void QgsGraduatedSymbolRendererV2::setGraduatedMethod ( GraduatedMethod  method)
inline

set the method used for graduation (either size or color)

Note
added in 2.10

Definition at line 347 of file qgsgraduatedsymbolrendererv2.h.

◆ setInvertedColorRamp()

void QgsGraduatedSymbolRendererV2::setInvertedColorRamp ( bool  inverted)
inline

Definition at line 310 of file qgsgraduatedsymbolrendererv2.h.

◆ setLabelFormat()

void QgsGraduatedSymbolRendererV2::setLabelFormat ( const QgsRendererRangeV2LabelFormat labelFormat,
bool  updateRanges = false 
)

Set the label format used to generate default classification labels.

Parameters
labelFormatThe string appended to classification labels
updateRangesIf true then ranges ending with the old unit string are updated to the new.
Note
Added in 2.6

Definition at line 1579 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setLegendSymbolItem()

void QgsGraduatedSymbolRendererV2::setLegendSymbolItem ( const QString key,
QgsSymbolV2 symbol 
)
overridevirtual

Sets the symbol to be used for a legend symbol item.

Parameters
keyrule key for legend symbol
symbolnew symbol for legend item. Ownership is transferred to renderer.
Note
added in QGIS 2.14

Reimplemented from QgsFeatureRendererV2.

Definition at line 1501 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setMode()

void QgsGraduatedSymbolRendererV2::setMode ( Mode  mode)
inline

Definition at line 225 of file qgsgraduatedsymbolrendererv2.h.

◆ setRotationField()

void QgsGraduatedSymbolRendererV2::setRotationField ( const QString fieldName)
overridevirtual

sets rotation field of renderer (if supported by the renderer)

Deprecated:
use the symbol's methods instead

Reimplemented from QgsFeatureRendererV2.

Definition at line 1436 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setScaleMethod()

void QgsGraduatedSymbolRendererV2::setScaleMethod ( QgsSymbolV2::ScaleMethod  scaleMethod)

Definition at line 1468 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setSizeScaleField()

void QgsGraduatedSymbolRendererV2::setSizeScaleField ( const QString fieldOrExpression)

Definition at line 1458 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setSourceColorRamp()

void QgsGraduatedSymbolRendererV2::setSourceColorRamp ( QgsVectorColorRampV2 ramp)

Sets the source color ramp.

Parameters
rampcolor ramp. Ownership is transferred to the renderer

Definition at line 1327 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setSourceSymbol()

void QgsGraduatedSymbolRendererV2::setSourceSymbol ( QgsSymbolV2 sym)

Sets the source symbol for the renderer, which is the base symbol used for the each classes' symbol before applying the classes' color.

Parameters
symsource symbol, ownership is transferred to the renderer
See also
sourceSymbol()
setSourceColorRamp()

Definition at line 1317 of file qgsgraduatedsymbolrendererv2.cpp.

◆ setSymbolSizes()

void QgsGraduatedSymbolRendererV2::setSymbolSizes ( double  minSize,
double  maxSize 
)

set varying symbol size for classes

Note
the classes must already be set so that symbols exist
added in 2.10

Definition at line 1362 of file qgsgraduatedsymbolrendererv2.cpp.

◆ sizeScaleField()

QString QgsGraduatedSymbolRendererV2::sizeScaleField ( ) const

Definition at line 1463 of file qgsgraduatedsymbolrendererv2.cpp.

◆ sortByLabel()

void QgsGraduatedSymbolRendererV2::sortByLabel ( Qt::SortOrder  order = Qt::AscendingOrder)

Definition at line 1710 of file qgsgraduatedsymbolrendererv2.cpp.

◆ sortByValue()

void QgsGraduatedSymbolRendererV2::sortByValue ( Qt::SortOrder  order = Qt::AscendingOrder)

Definition at line 1638 of file qgsgraduatedsymbolrendererv2.cpp.

◆ sourceColorRamp()

QgsVectorColorRampV2 * QgsGraduatedSymbolRendererV2::sourceColorRamp ( )

Returns the source color ramp, from which each classes' color is derived.

See also
setSourceColorRamp()
sourceSymbol()

Definition at line 1322 of file qgsgraduatedsymbolrendererv2.cpp.

◆ sourceSymbol()

QgsSymbolV2 * QgsGraduatedSymbolRendererV2::sourceSymbol ( )

Returns the renderer's source symbol, which is the base symbol used for the each classes' symbol before applying the classes' color.

See also
setSourceSymbol()
sourceColorRamp()

Definition at line 1313 of file qgsgraduatedsymbolrendererv2.cpp.

◆ startRender()

void QgsGraduatedSymbolRendererV2::startRender ( QgsRenderContext context,
const QgsFields fields 
)
overridevirtual

Needs to be called when a new render cycle is started.

Parameters
contextAdditional information passed to the renderer about the job which will be rendered
fieldsThe fields available for rendering
Returns
Information passed back from the renderer that can e.g. be used to reduce the amount of requested features

Implements QgsFeatureRendererV2.

Definition at line 408 of file qgsgraduatedsymbolrendererv2.cpp.

◆ stopRender()

void QgsGraduatedSymbolRendererV2::stopRender ( QgsRenderContext context)
overridevirtual

Needs to be called when a render cycle has finished to clean up.

Implements QgsFeatureRendererV2.

Definition at line 440 of file qgsgraduatedsymbolrendererv2.cpp.

◆ symbolForFeature()

QgsSymbolV2 * QgsGraduatedSymbolRendererV2::symbolForFeature ( QgsFeature feature,
QgsRenderContext context 
)
overridevirtual
Note
labelForLowerUpper in python bindings

Reimplemented from QgsFeatureRendererV2.

Definition at line 348 of file qgsgraduatedsymbolrendererv2.cpp.

◆ symbolForValue()

QgsSymbolV2 * QgsGraduatedSymbolRendererV2::symbolForValue ( double  value)
protected

Definition at line 314 of file qgsgraduatedsymbolrendererv2.cpp.

◆ symbols()

QgsSymbolV2List QgsGraduatedSymbolRendererV2::symbols ( QgsRenderContext context)
overridevirtual
Note
symbol2 in python bindings

Reimplemented from QgsFeatureRendererV2.

Definition at line 587 of file qgsgraduatedsymbolrendererv2.cpp.

◆ toSld() [1/2]

void QgsGraduatedSymbolRendererV2::toSld ( QDomDocument doc,
QDomElement element 
) const
overridevirtual

Writes the SLD element following the SLD v1.1 specs.

Reimplemented from QgsFeatureRendererV2.

Definition at line 562 of file qgsgraduatedsymbolrendererv2.cpp.

◆ toSld() [2/2]

void QgsGraduatedSymbolRendererV2::toSld ( QDomDocument doc,
QDomElement element,
const QgsStringMap props 
) const
overridevirtual

Writes the SLD element following the SLD v1.1 specs.

Reimplemented from QgsFeatureRendererV2.

Definition at line 567 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateClasses()

void QgsGraduatedSymbolRendererV2::updateClasses ( QgsVectorLayer vlayer,
Mode  mode,
int  nclasses 
)

Recalculate classes for a layer.

Parameters
vlayerThe layer being rendered (from which data values are calculated)
modeThe calculation mode
nclassesThe number of classes to calculate (approximate for some modes)
Note
Added in 2.6

Definition at line 872 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateColorRamp()

void QgsGraduatedSymbolRendererV2::updateColorRamp ( QgsVectorColorRampV2 ramp = nullptr,
bool  inverted = false 
)

Update the color ramp used.

Also updates all symbols colors. Doesn't alter current breaks.

Parameters
rampcolor ramp. Ownership is transferred to the renderer
invertedset to true to invert ramp colors

Definition at line 1378 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateRangeLabel()

bool QgsGraduatedSymbolRendererV2::updateRangeLabel ( int  rangeIndex,
const QString label 
)

Definition at line 497 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateRangeLowerValue()

bool QgsGraduatedSymbolRendererV2::updateRangeLowerValue ( int  rangeIndex,
double  value 
)

Definition at line 516 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateRangeRenderState()

bool QgsGraduatedSymbolRendererV2::updateRangeRenderState ( int  rangeIndex,
bool  render 
)
Note
added in 2.5

Definition at line 527 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateRangeSymbol()

bool QgsGraduatedSymbolRendererV2::updateRangeSymbol ( int  rangeIndex,
QgsSymbolV2 symbol 
)

Definition at line 489 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateRangeUpperValue()

bool QgsGraduatedSymbolRendererV2::updateRangeUpperValue ( int  rangeIndex,
double  value 
)

Definition at line 505 of file qgsgraduatedsymbolrendererv2.cpp.

◆ updateSymbols()

void QgsGraduatedSymbolRendererV2::updateSymbols ( QgsSymbolV2 sym)

Update all the symbols but leave breaks and colors.

This method also sets the source symbol for the renderer.

Parameters
symsource symbol to use for classes. Ownership is not transferred.
See also
setSourceSymbol()

Definition at line 1408 of file qgsgraduatedsymbolrendererv2.cpp.

◆ usedAttributes()

QList< QString > QgsGraduatedSymbolRendererV2::usedAttributes ( )
overridevirtual

Returns a set of attributes required for this renderer.

TODO QGIS3: Change QList to QSet

Implements QgsFeatureRendererV2.

Definition at line 460 of file qgsgraduatedsymbolrendererv2.cpp.

Member Data Documentation

◆ mAttrName

QString QgsGraduatedSymbolRendererV2::mAttrName
protected

Definition at line 382 of file qgsgraduatedsymbolrendererv2.h.

◆ mAttrNum

int QgsGraduatedSymbolRendererV2::mAttrNum
protected

attribute index (derived from attribute name in startRender)

Definition at line 396 of file qgsgraduatedsymbolrendererv2.h.

◆ mCounting

bool QgsGraduatedSymbolRendererV2::mCounting
protected

Definition at line 397 of file qgsgraduatedsymbolrendererv2.h.

◆ mExpression

QScopedPointer<QgsExpression> QgsGraduatedSymbolRendererV2::mExpression
protected

Definition at line 393 of file qgsgraduatedsymbolrendererv2.h.

◆ mGraduatedMethod

GraduatedMethod QgsGraduatedSymbolRendererV2::mGraduatedMethod
protected

Definition at line 394 of file qgsgraduatedsymbolrendererv2.h.

◆ mInvertedColorRamp

bool QgsGraduatedSymbolRendererV2::mInvertedColorRamp
protected

Definition at line 387 of file qgsgraduatedsymbolrendererv2.h.

◆ mLabelFormat

QgsRendererRangeV2LabelFormat QgsGraduatedSymbolRendererV2::mLabelFormat
protected

Definition at line 388 of file qgsgraduatedsymbolrendererv2.h.

◆ mMode

Mode QgsGraduatedSymbolRendererV2::mMode
protected

Definition at line 384 of file qgsgraduatedsymbolrendererv2.h.

◆ mRanges

QgsRangeList QgsGraduatedSymbolRendererV2::mRanges
protected

Definition at line 383 of file qgsgraduatedsymbolrendererv2.h.

◆ mRotation

QScopedPointer<QgsExpression> QgsGraduatedSymbolRendererV2::mRotation
protected

Definition at line 390 of file qgsgraduatedsymbolrendererv2.h.

◆ mScaleMethod

QgsSymbolV2::ScaleMethod QgsGraduatedSymbolRendererV2::mScaleMethod
protected

Definition at line 392 of file qgsgraduatedsymbolrendererv2.h.

◆ mSizeScale

QScopedPointer<QgsExpression> QgsGraduatedSymbolRendererV2::mSizeScale
protected

Definition at line 391 of file qgsgraduatedsymbolrendererv2.h.

◆ mSourceColorRamp

QScopedPointer<QgsVectorColorRampV2> QgsGraduatedSymbolRendererV2::mSourceColorRamp
protected

Definition at line 386 of file qgsgraduatedsymbolrendererv2.h.

◆ mSourceSymbol

QScopedPointer<QgsSymbolV2> QgsGraduatedSymbolRendererV2::mSourceSymbol
protected

Definition at line 385 of file qgsgraduatedsymbolrendererv2.h.

◆ mTempSymbols

QHash<QgsSymbolV2*, QgsSymbolV2*> QgsGraduatedSymbolRendererV2::mTempSymbols
protected

temporary symbols, used for data-defined rotation and scaling

Definition at line 400 of file qgsgraduatedsymbolrendererv2.h.


The documentation for this class was generated from the following files: