Handles automatic layout and rendering of legends. More...

#include <qgslegendrenderer.h>

Public Member Functions
	QgsLegendRenderer (const QgsLegendRenderer &other)=delete
	QgsLegendRenderer (QgsLayerTreeModel *legendModel, const QgsLegendSettings &settings)
	Constructor for QgsLegendRenderer.
	QgsLegendRenderer (QgsLegendRenderer &&other)
	~QgsLegendRenderer ()
void	drawLegend (QgsRenderContext &context)
	Draws the legend using a given render context.
Q_DECL_DEPRECATED void	drawLegend (QPainter *painter)
	Draws the legend with given painter.
QJsonObject	exportLegendToJson (const QgsRenderContext &context)
	Renders the legend in a json object.
QSizeF	legendSize () const
	Returns the preferred legend size set by the client.
QSizeF	minimumSize (QgsRenderContext *renderContext=nullptr)
	Runs the layout algorithm and returns the minimum size required for the legend.
QgsLegendRenderer &	operator= (const QgsLegendRenderer &other)=delete
QgsLayerTreeFilterProxyModel *	proxyModel ()
	Returns the filter proxy model used for filtering the legend model content during rendering.
void	setLegendSize (QSizeF s)
	Sets the preferred resulting legend size.
void	setProxyModel (QgsLayerTreeFilterProxyModel *model)
	Sets the filter proxy model to use for filtering the legend model content during rendering.

Static Public Member Functions
static Qgis::LegendComponent	nodeLegendStyle (QgsLayerTreeNode node, QgsLayerTreeModel model)
	Returns the style for the given node, within the specified model.
static void	setNodeLegendStyle (QgsLayerTreeNode *node, Qgis::LegendComponent style)
	Sets the style of a node.

Detailed Description

Handles automatic layout and rendering of legends.

The content is given by QgsLayerTreeModel instance. Various layout properties can be configured within QgsLegendRenderer.

All spacing and sizes are in millimeters.

Definition at line 48 of file qgslegendrenderer.h.

Constructor & Destructor Documentation

◆ QgsLegendRenderer() [1/3]

QgsLegendRenderer::QgsLegendRenderer	(	QgsLayerTreeModel *	legendModel,
		const QgsLegendSettings &	settings )

Constructor for QgsLegendRenderer.

The ownership of the legend model is not changed, and the model must exist for the lifetime of this renderer.

Definition at line 32 of file qgslegendrenderer.cpp.

◆ ~QgsLegendRenderer()

QgsLegendRenderer::~QgsLegendRenderer ( )

default

◆ QgsLegendRenderer() [2/3]

QgsLegendRenderer::QgsLegendRenderer ( const QgsLegendRenderer & other )

delete

◆ QgsLegendRenderer() [3/3]

QgsLegendRenderer::QgsLegendRenderer ( QgsLegendRenderer && other )

Definition at line 40 of file qgslegendrenderer.cpp.

Member Function Documentation

◆ drawLegend() [1/2]

void QgsLegendRenderer::drawLegend ( QgsRenderContext & context )

Draws the legend using a given render context.

The legend will occupy the area reported in legendSize().

Since: QGIS 3.6

Definition at line 1151 of file qgslegendrenderer.cpp.

◆ drawLegend() [2/2]

void QgsLegendRenderer::drawLegend ( QPainter * painter )

Draws the legend with given painter.

The legend will occupy the area reported in legendSize(). The painter should be scaled beforehand so that units correspond to millimeters.

Deprecated: QGIS 3.40. Use the variant which accepts a QgsRenderContext instead.

Definition at line 80 of file qgslegendrenderer.cpp.

◆ exportLegendToJson()

QJsonObject QgsLegendRenderer::exportLegendToJson ( const QgsRenderContext & context )

Renders the legend in a json object.

Since: QGIS 3.8

Definition at line 93 of file qgslegendrenderer.cpp.

◆ legendSize()

QSizeF QgsLegendRenderer::legendSize ( ) const

inline

Returns the preferred legend size set by the client.

If the returned size is null, the legend will be drawn with the minimum possible size to fit its content.

See also: minimumSize(); setLegendSize()

Definition at line 111 of file qgslegendrenderer.h.

◆ minimumSize()

QSizeF QgsLegendRenderer::minimumSize ( QgsRenderContext * renderContext = nullptr )

Runs the layout algorithm and returns the minimum size required for the legend.

See also: setLegendSize(); legendSize()

Definition at line 60 of file qgslegendrenderer.cpp.

◆ nodeLegendStyle()

Qgis::LegendComponent QgsLegendRenderer::nodeLegendStyle	(	QgsLayerTreeNode *	node,
		QgsLayerTreeModel *	model )

static

Returns the style for the given node, within the specified model.

See also: setNodeLegendStyle()

Definition at line 1094 of file qgslegendrenderer.cpp.

◆ operator=()

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

delete

◆ proxyModel()

QgsLayerTreeFilterProxyModel * QgsLegendRenderer::proxyModel ( )

Returns the filter proxy model used for filtering the legend model content during rendering.

Filters can be set on the proxy model to filter rendered legend content.

Since: QGIS 3.40

Definition at line 1122 of file qgslegendrenderer.cpp.

◆ setLegendSize()

void QgsLegendRenderer::setLegendSize ( QSizeF s )

inline

Sets the preferred resulting legend size.

If the size is null, the legend will be drawn with the minimum possible size to fit its content.

See also: legendSize(); minimumSize()

Definition at line 101 of file qgslegendrenderer.h.

◆ setNodeLegendStyle()

void QgsLegendRenderer::setNodeLegendStyle	(	QgsLayerTreeNode *	node,
		Qgis::LegendComponent	style )

static

Sets the style of a node.

See also: nodeLegendStyle()

Definition at line 1127 of file qgslegendrenderer.cpp.

◆ setProxyModel()

void QgsLegendRenderer::setProxyModel ( QgsLayerTreeFilterProxyModel * model )

Sets the filter proxy model to use for filtering the legend model content during rendering.

Ownership of proxy is transferred to the renderer.

See also: proxyModel()

Since: QGIS 4.0

Definition at line 49 of file qgslegendrenderer.cpp.

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

/build/qgis-3.99.0+git20251210+2fe06baccd8+99sid/src/core/qgslegendrenderer.h
/build/qgis-3.99.0+git20251210+2fe06baccd8+99sid/src/core/qgslegendrenderer.cpp

Public Member Functions

Static Public Member Functions