Object that keeps configuration of appearance of marker symbol's data-defined size in legend. More...

#include <qgsdatadefinedsizelegend.h>

Classes
struct	SizeClass
	Definition of one class for the legend. More...

Public Types
enum	LegendType { LegendSeparated, LegendCollapsed }
	Determines how to display data-defined size legend. More...

enum	VerticalAlignment { AlignCenter, AlignBottom }
	How to vertically align symbols when all classes go into one node. More...

Public Member Functions
	QgsDataDefinedSizeLegend ()=default
	Constructor for QgsDataDefinedSizeLegend. More...

	QgsDataDefinedSizeLegend (const QgsDataDefinedSizeLegend &other)
	Copy constructor. More...

QList< QgsDataDefinedSizeLegend::SizeClass >	classes () const
	Returns list of classes: each class is a pair of symbol size (in units used by the symbol) and label. More...

QImage	collapsedLegendImage (QgsRenderContext &context, const QColor &backgroundColor=Qt::transparent, double paddingMM=1) const
	Returns output image that would be shown in the legend. Returns invalid image if legend is not configured as collapsed. More...

void	drawCollapsedLegend (QgsRenderContext &context, QSize outputSize SIP_OUT=nullptr, int labelXOffset SIP_OUT=nullptr) const
	Draw the legend if using LegendOneNodeForAll and optionally output size of the legend and x offset of labels (in painter units). More...

QFont	font () const
	Returns font used for rendering of labels - only valid for collapsed legend. More...

QgsLegendSymbolList	legendSymbolList () const
	Generates legend symbol items according to the configuration. More...

LegendType	legendType () const
	Returns how the legend should be rendered. More...

QgsDataDefinedSizeLegend &	operator= (const QgsDataDefinedSizeLegend &other)

void	setClasses (const QList< QgsDataDefinedSizeLegend::SizeClass > &classes)
	Sets list of classes: each class is a pair of symbol size (in units used by the symbol) and label. More...

void	setFont (const QFont &font)
	Sets font used for rendering of labels - only valid for collapsed legend. More...

void	setLegendType (LegendType type)
	Sets how the legend should be rendered. More...

void	setSizeScaleTransformer (QgsSizeScaleTransformer *transformer SIP_TRANSFER)
	Sets transformer for scaling of symbol sizes. Takes ownership of the object. Accepts `nullptr` to set no transformer. More...

void	setSymbol (QgsMarkerSymbol *symbol SIP_TRANSFER)
	Sets marker symbol that will be used to draw markers in legend. More...

void	setTextAlignment (Qt::AlignmentFlag flag)
	Sets horizontal text alignment for rendering of labels - only valid for collapsed legend. More...

void	setTextColor (const QColor &color)
	Sets text color for rendering of labels - only valid for collapsed legend. More...

void	setTitle (const QString &title)
	Sets title label for data-defined size legend. More...

void	setVerticalAlignment (VerticalAlignment vAlign)
	Sets vertical alignment of symbols - only valid for collapsed legend. More...

QgsSizeScaleTransformer *	sizeScaleTransformer () const
	Returns transformer for scaling of symbol sizes. Returns `nullptr` if no transformer is defined. More...

QgsMarkerSymbol *	symbol () const
	Returns marker symbol that will be used to draw markers in legend. More...

Qt::AlignmentFlag	textAlignment () const
	Returns horizontal text alignment for rendering of labels - only valid for collapsed legend. More...

QColor	textColor () const
	Returns text color for rendering of labels - only valid for collapsed legend. More...

QString	title () const
	Returns title label for data-defined size legend. More...

void	updateFromSymbolAndProperty (const QgsMarkerSymbol *symbol, const QgsProperty &ddSize)
	Updates the list of classes, source symbol and title label from given symbol and property. More...

VerticalAlignment	verticalAlignment () const
	Returns vertical alignment of symbols - only valid for collapsed legend. More...

void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const
	Writes configuration to the given XML element. More...

Static Public Member Functions
static QgsDataDefinedSizeLegend *	readXml (const QDomElement &elem, const QgsReadWriteContext &context) SIP_FACTORY
	Creates instance from given element and returns it (caller takes ownership). Returns `nullptr` on error. More...

Detailed Description

Object that keeps configuration of appearance of marker symbol's data-defined size in legend.

For example: the list of classes (size values), whether the classes should appear in separate legend nodes or whether to collapse them into one legend node.

Since: QGIS 3.0

Definition at line 40 of file qgsdatadefinedsizelegend.h.

Member Enumeration Documentation

◆ LegendType

enum QgsDataDefinedSizeLegend::LegendType

Determines how to display data-defined size legend.

Enumerator
LegendSeparated	Each class (size value) has a separate legend node.
LegendCollapsed	All classes are rendered within one legend node.

Definition at line 54 of file qgsdatadefinedsizelegend.h.

◆ VerticalAlignment

enum QgsDataDefinedSizeLegend::VerticalAlignment

How to vertically align symbols when all classes go into one node.

Enumerator
AlignCenter	Symbols are aligned to the center.
AlignBottom	Symbols are aligned to the bottom.

Definition at line 61 of file qgsdatadefinedsizelegend.h.

Constructor & Destructor Documentation

◆ QgsDataDefinedSizeLegend() [1/2]

QgsDataDefinedSizeLegend::QgsDataDefinedSizeLegend ( )

default

Constructor for QgsDataDefinedSizeLegend.

◆ QgsDataDefinedSizeLegend() [2/2]

QgsDataDefinedSizeLegend::QgsDataDefinedSizeLegend ( const QgsDataDefinedSizeLegend & other )

Copy constructor.

Definition at line 24 of file qgsdatadefinedsizelegend.cpp.

Member Function Documentation

◆ classes()

QList< QgsDataDefinedSizeLegend::SizeClass > QgsDataDefinedSizeLegend::classes ( ) const

inline

Returns list of classes: each class is a pair of symbol size (in units used by the symbol) and label.

Definition at line 94 of file qgsdatadefinedsizelegend.h.

◆ collapsedLegendImage()

QImage QgsDataDefinedSizeLegend::collapsedLegendImage	(	QgsRenderContext &	context,
		const QColor &	backgroundColor = `Qt::transparent`,
		double	paddingMM = `1`
	)		const

Returns output image that would be shown in the legend. Returns invalid image if legend is not configured as collapsed.

Definition at line 298 of file qgsdatadefinedsizelegend.cpp.

◆ drawCollapsedLegend()

void QgsDataDefinedSizeLegend::drawCollapsedLegend	(	QgsRenderContext &	context,
		QSize *outputSize	SIP_OUT = `nullptr`,
		int *labelXOffset	SIP_OUT = `nullptr`
	)		const

Draw the legend if using LegendOneNodeForAll and optionally output size of the legend and x offset of labels (in painter units).

If the painter in context is nullptr, it only does size calculation without actual rendering. Does nothing if legend is not configured as collapsed.

Definition at line 140 of file qgsdatadefinedsizelegend.cpp.

◆ font()

QFont QgsDataDefinedSizeLegend::font ( ) const

inline

Returns font used for rendering of labels - only valid for collapsed legend.

Definition at line 109 of file qgsdatadefinedsizelegend.h.

◆ legendSymbolList()

QgsLegendSymbolList QgsDataDefinedSizeLegend::legendSymbolList ( ) const

Generates legend symbol items according to the configuration.

Definition at line 98 of file qgsdatadefinedsizelegend.cpp.

◆ legendType()

LegendType QgsDataDefinedSizeLegend::legendType ( ) const

inline

Returns how the legend should be rendered.

Definition at line 79 of file qgsdatadefinedsizelegend.h.

◆ operator=()

QgsDataDefinedSizeLegend & QgsDataDefinedSizeLegend::operator= ( const QgsDataDefinedSizeLegend & other )

Definition at line 37 of file qgsdatadefinedsizelegend.cpp.

◆ readXml()

QgsDataDefinedSizeLegend * QgsDataDefinedSizeLegend::readXml	(	const QDomElement &	elem,
		const QgsReadWriteContext &	context
	)

static

Creates instance from given element and returns it (caller takes ownership). Returns nullptr on error.

Definition at line 330 of file qgsdatadefinedsizelegend.cpp.

◆ setClasses()

void QgsDataDefinedSizeLegend::setClasses ( const QList< QgsDataDefinedSizeLegend::SizeClass > & classes )

inline

Sets list of classes: each class is a pair of symbol size (in units used by the symbol) and label.

Definition at line 92 of file qgsdatadefinedsizelegend.h.

◆ setFont()

void QgsDataDefinedSizeLegend::setFont ( const QFont & font )

inline

Sets font used for rendering of labels - only valid for collapsed legend.

Definition at line 107 of file qgsdatadefinedsizelegend.h.

◆ setLegendType()

void QgsDataDefinedSizeLegend::setLegendType ( LegendType type )

inline

Sets how the legend should be rendered.

Definition at line 77 of file qgsdatadefinedsizelegend.h.

◆ setSizeScaleTransformer()

void QgsDataDefinedSizeLegend::setSizeScaleTransformer ( QgsSizeScaleTransformer *transformer SIP_TRANSFER )

Sets transformer for scaling of symbol sizes. Takes ownership of the object. Accepts nullptr to set no transformer.

Definition at line 64 of file qgsdatadefinedsizelegend.cpp.

◆ setSymbol()

void QgsDataDefinedSizeLegend::setSymbol ( QgsMarkerSymbol *symbol SIP_TRANSFER )

Sets marker symbol that will be used to draw markers in legend.

Definition at line 54 of file qgsdatadefinedsizelegend.cpp.

◆ setTextAlignment()

void QgsDataDefinedSizeLegend::setTextAlignment ( Qt::AlignmentFlag flag )

inline

Sets horizontal text alignment for rendering of labels - only valid for collapsed legend.

Definition at line 117 of file qgsdatadefinedsizelegend.h.

◆ setTextColor()

void QgsDataDefinedSizeLegend::setTextColor ( const QColor & color )

inline

Sets text color for rendering of labels - only valid for collapsed legend.

Definition at line 112 of file qgsdatadefinedsizelegend.h.

◆ setTitle()

void QgsDataDefinedSizeLegend::setTitle ( const QString & title )

inline

Sets title label for data-defined size legend.

Definition at line 97 of file qgsdatadefinedsizelegend.h.

◆ setVerticalAlignment()

void QgsDataDefinedSizeLegend::setVerticalAlignment ( VerticalAlignment vAlign )

inline

Sets vertical alignment of symbols - only valid for collapsed legend.

Definition at line 102 of file qgsdatadefinedsizelegend.h.

◆ sizeScaleTransformer()

QgsSizeScaleTransformer * QgsDataDefinedSizeLegend::sizeScaleTransformer ( ) const

Returns transformer for scaling of symbol sizes. Returns nullptr if no transformer is defined.

Definition at line 69 of file qgsdatadefinedsizelegend.cpp.

◆ symbol()

QgsMarkerSymbol * QgsDataDefinedSizeLegend::symbol ( ) const

Returns marker symbol that will be used to draw markers in legend.

Definition at line 59 of file qgsdatadefinedsizelegend.cpp.

◆ textAlignment()

Qt::AlignmentFlag QgsDataDefinedSizeLegend::textAlignment ( ) const

inline

Returns horizontal text alignment for rendering of labels - only valid for collapsed legend.

Definition at line 119 of file qgsdatadefinedsizelegend.h.

◆ textColor()

QColor QgsDataDefinedSizeLegend::textColor ( ) const

inline

Returns text color for rendering of labels - only valid for collapsed legend.

Definition at line 114 of file qgsdatadefinedsizelegend.h.

◆ title()

QString QgsDataDefinedSizeLegend::title ( ) const

inline

Returns title label for data-defined size legend.

Definition at line 99 of file qgsdatadefinedsizelegend.h.

◆ updateFromSymbolAndProperty()

void QgsDataDefinedSizeLegend::updateFromSymbolAndProperty	(	const QgsMarkerSymbol *	symbol,
		const QgsProperty &	ddSize
	)

Updates the list of classes, source symbol and title label from given symbol and property.

Definition at line 75 of file qgsdatadefinedsizelegend.cpp.

◆ verticalAlignment()

VerticalAlignment QgsDataDefinedSizeLegend::verticalAlignment ( ) const

inline

Returns vertical alignment of symbols - only valid for collapsed legend.

Definition at line 104 of file qgsdatadefinedsizelegend.h.

◆ writeXml()

void QgsDataDefinedSizeLegend::writeXml	(	QDomElement &	elem,
		const QgsReadWriteContext &	context
	)		const

Writes configuration to the given XML element.

Definition at line 383 of file qgsdatadefinedsizelegend.cpp.

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

/build/qgis-3.10.0+15buster/src/core/qgsdatadefinedsizelegend.h
/build/qgis-3.10.0+15buster/src/core/qgsdatadefinedsizelegend.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ LegendType

◆ VerticalAlignment

Constructor & Destructor Documentation

◆ QgsDataDefinedSizeLegend() [1/2]

◆ QgsDataDefinedSizeLegend() [2/2]

Member Function Documentation

◆ classes()

◆ collapsedLegendImage()

◆ drawCollapsedLegend()

◆ font()

◆ legendSymbolList()

◆ legendType()

◆ operator=()

◆ readXml()

◆ setClasses()

◆ setFont()

◆ setLegendType()

◆ setSizeScaleTransformer()

◆ setSymbol()

◆ setTextAlignment()

◆ setTextColor()

◆ setTitle()

◆ setVerticalAlignment()

◆ sizeScaleTransformer()

◆ symbol()

◆ textAlignment()

◆ textColor()

◆ title()

◆ updateFromSymbolAndProperty()

◆ verticalAlignment()

◆ writeXml()