The QgsLegendSettings class stores the appearance and layout settings for legend drawing with QgsLegendRenderer. More...

#include <qgslegendsettings.h>

Public Member Functions
	QgsLegendSettings ()

double	boxSpace () const

int	columnCount () const

double	columnSpace () const

int	dpi () const

bool	drawRasterStroke () const
	Returns whether a stroke will be drawn around raster symbol items. More...

void	drawText (QPainter *p, double x, double y, const QString &text, const QFont &font) const
	Draws Text. More...

void	drawText (QPainter *p, const QRectF &rect, const QString &text, const QFont &font, Qt::AlignmentFlag halignment=Qt::AlignLeft, Qt::AlignmentFlag valignment=Qt::AlignTop, int flags=Qt::TextWordWrap) const
	Like the above, but with a rectangle for multiline text. More...

bool	equalColumnWidth () const

double	fontAscentMillimeters (const QFont &font) const
	Returns the font ascent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More...

QColor	fontColor () const

double	fontDescentMillimeters (const QFont &font) const
	Returns the font descent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More...

double	fontHeightCharacterMM (const QFont &font, QChar c) const
	Returns the font height of a character in millimeters. More...

QColor	layerFontColor () const
	Returns layer font color, defaults to fontColor() More...

double	lineSpacing () const

double	mapScale () const
	Returns the legend map scale. More...

double	mapUnitsPerPixel () const
	Returns the factor of map units per pixel for symbols with size given in map units calculated by mDpi and mMmPerMapUnit. More...

double	mmPerMapUnit () const

double	pixelFontSize (double pointSize) const
	Calculates font to from point size to pixel size. More...

QColor	rasterStrokeColor () const
	Returns the stroke color for the stroke drawn around raster symbol items. More...

double	rasterStrokeWidth () const
	Returns the stroke width (in millimeters) for the stroke drawn around raster symbol items. More...

QgsLegendStyle &	rstyle (QgsLegendStyle::Style s)
	Returns reference to modifiable style. More...

QFont	scaledFontPixelSize (const QFont &font) const
	Returns a font where size is in pixel and font size is upscaled with FONT_WORKAROUND_SCALE. More...

void	setBoxSpace (double s)

void	setColumnCount (int c)

void	setColumnSpace (double s)

void	setDpi (int dpi)

void	setDrawRasterStroke (bool enabled)
	Sets whether a stroke will be drawn around raster symbol items. More...

void	setEqualColumnWidth (bool s)

void	setFontColor (const QColor &c)

void	setLayerFontColor (const QColor &fontColor)
	Sets layer font color to fontColor Overrides fontColor() More...

void	setLineSpacing (double s)

void	setMapScale (double scale)
	Sets the legend map scale. More...

void	setMapUnitsPerPixel (double mapUnitsPerPixel)
	Sets the mMmPerMapUnit calculated by mapUnitsPerPixel mostly taken from the map settings. More...

void	setMmPerMapUnit (double mmPerMapUnit)

void	setRasterStrokeColor (const QColor &color)
	Sets the stroke color for the stroke drawn around raster symbol items. More...

void	setRasterStrokeWidth (double width)
	Sets the stroke width for the stroke drawn around raster symbol items. More...

void	setSplitLayer (bool s)

void	setStyle (QgsLegendStyle::Style s, const QgsLegendStyle &style)

void	setSymbolSize (QSizeF s)

void	setTitle (const QString &t)

void	setTitleAlignment (Qt::AlignmentFlag alignment)
	Sets the alignment of the legend title. More...

void	setUseAdvancedEffects (bool use)

void	setWmsLegendSize (QSizeF s)

void	setWrapChar (const QString &t)

bool	splitLayer () const

QStringList	splitStringForWrapping (const QString &stringToSplt) const
	Splits a string using the wrap char taking into account handling empty wrap char which means no wrapping. More...

QgsLegendStyle	style (QgsLegendStyle::Style s) const
	Returns style. More...

QSizeF	symbolSize () const

double	textWidthMillimeters (const QFont &font, const QString &text) const
	Returns the font width in millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More...

QString	title () const

Qt::AlignmentFlag	titleAlignment () const
	Returns the alignment of the legend title. More...

bool	useAdvancedEffects () const

QSizeF	wmsLegendSize () const

QString	wrapChar () const

Detailed Description

The QgsLegendSettings class stores the appearance and layout settings for legend drawing with QgsLegendRenderer.

The content of the legend is given in QgsLegendModel class.

Since: QGIS 2.6

Definition at line 37 of file qgslegendsettings.h.

Constructor & Destructor Documentation

QgsLegendSettings::QgsLegendSettings ( )

Definition at line 20 of file qgslegendsettings.cpp.

Member Function Documentation

double QgsLegendSettings::boxSpace ( ) const

inline

Definition at line 69 of file qgslegendsettings.h.

int QgsLegendSettings::columnCount ( ) const

inline

Definition at line 78 of file qgslegendsettings.h.

double QgsLegendSettings::columnSpace ( ) const

inline

Definition at line 75 of file qgslegendsettings.h.

int QgsLegendSettings::dpi ( ) const

inline

Definition at line 212 of file qgslegendsettings.h.

bool QgsLegendSettings::drawRasterStroke ( ) const

inline

Returns whether a stroke will be drawn around raster symbol items.

See also: setDrawRasterStroke(); rasterStrokeColor(); rasterStrokeWidth()

Since: QGIS 2.12

Definition at line 118 of file qgslegendsettings.h.

void QgsLegendSettings::drawText	(	QPainter *	p,
		double	x,
		double	y,
		const QString &	text,
		const QFont &	font
	)		const

Draws Text.

Takes care about all the composer specific issues (calculation to pixel, scaling of font and painter to work around the Qt font bug)

Definition at line 62 of file qgslegendsettings.cpp.

void QgsLegendSettings::drawText	(	QPainter *	p,
		const QRectF &	rect,
		const QString &	text,
		const QFont &	font,
		Qt::AlignmentFlag	halignment = `Qt::AlignLeft`,
		Qt::AlignmentFlag	valignment = `Qt::AlignTop`,
		int	flags = `Qt::TextWordWrap`
	)		const

Like the above, but with a rectangle for multiline text.

Parameters

p	painter to use
rect	rectangle to draw into
text	text to draw
font	font to use
halignment	optional horizontal alignment
valignment	optional vertical alignment
flags	allows for passing Qt::TextFlags to control appearance of rendered text

Definition at line 75 of file qgslegendsettings.cpp.

bool QgsLegendSettings::equalColumnWidth ( ) const

inline

Definition at line 84 of file qgslegendsettings.h.

double QgsLegendSettings::fontAscentMillimeters ( const QFont & font ) const

Returns the font ascent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.

Definition at line 118 of file qgslegendsettings.cpp.

QColor QgsLegendSettings::fontColor ( ) const

inline

Definition at line 87 of file qgslegendsettings.h.

double QgsLegendSettings::fontDescentMillimeters ( const QFont & font ) const

Returns the font descent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.

Definition at line 125 of file qgslegendsettings.cpp.

double QgsLegendSettings::fontHeightCharacterMM	(	const QFont &	font,
		QChar	c
	)		const

Returns the font height of a character in millimeters.

Definition at line 111 of file qgslegendsettings.cpp.

QColor QgsLegendSettings::layerFontColor ( ) const

inline

Returns layer font color, defaults to fontColor()

See also: setLayerFontColor(); fontColor()

Since: QGIS 3.4.7

Definition at line 96 of file qgslegendsettings.h.

double QgsLegendSettings::lineSpacing ( ) const

inline

Definition at line 175 of file qgslegendsettings.h.

double QgsLegendSettings::mapScale ( ) const

inline

Returns the legend map scale.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also: setMapScale()

Definition at line 189 of file qgslegendsettings.h.

double QgsLegendSettings::mapUnitsPerPixel ( ) const

Returns the factor of map units per pixel for symbols with size given in map units calculated by mDpi and mMmPerMapUnit.

See also: setMapUnitsPerPixel()

Since: QGIS 3.4

Definition at line 38 of file qgslegendsettings.cpp.

double QgsLegendSettings::mmPerMapUnit ( ) const

inline

Definition at line 178 of file qgslegendsettings.h.

double QgsLegendSettings::pixelFontSize ( double pointSize ) const

Calculates font to from point size to pixel size.

Definition at line 99 of file qgslegendsettings.cpp.

QColor QgsLegendSettings::rasterStrokeColor ( ) const

inline

Returns the stroke color for the stroke drawn around raster symbol items.

The stroke is only drawn if drawRasterStroke() is true.

See also: setRasterStrokeColor(); drawRasterStroke(); rasterStrokeWidth()

Since: QGIS 2.12

Definition at line 138 of file qgslegendsettings.h.

double QgsLegendSettings::rasterStrokeWidth ( ) const

inline

Returns the stroke width (in millimeters) for the stroke drawn around raster symbol items.

The stroke is only drawn if drawRasterStroke() is true.

See also: setRasterStrokeWidth(); drawRasterStroke(); rasterStrokeColor()

Since: QGIS 2.12

Definition at line 159 of file qgslegendsettings.h.

QgsLegendStyle& QgsLegendSettings::rstyle ( QgsLegendStyle::Style s )

inline

Returns reference to modifiable style.

Note: Not available in Python bindings.

Definition at line 64 of file qgslegendsettings.h.

QFont QgsLegendSettings::scaledFontPixelSize ( const QFont & font ) const

Returns a font where size is in pixel and font size is upscaled with FONT_WORKAROUND_SCALE.

Definition at line 91 of file qgslegendsettings.cpp.

void QgsLegendSettings::setBoxSpace ( double s )

inline

Definition at line 70 of file qgslegendsettings.h.

void QgsLegendSettings::setColumnCount ( int c )

inline

Definition at line 79 of file qgslegendsettings.h.

void QgsLegendSettings::setColumnSpace ( double s )

inline

Definition at line 76 of file qgslegendsettings.h.

void QgsLegendSettings::setDpi ( int dpi )

inline

Definition at line 213 of file qgslegendsettings.h.

void QgsLegendSettings::setDrawRasterStroke ( bool enabled )

inline

Sets whether a stroke will be drawn around raster symbol items.

Parameters

enabled set to true to draw borders

See also: drawRasterStroke(); setRasterStrokeColor(); setRasterStrokeWidth()

Since: QGIS 2.12

Definition at line 128 of file qgslegendsettings.h.

void QgsLegendSettings::setEqualColumnWidth ( bool s )

inline

Definition at line 85 of file qgslegendsettings.h.

void QgsLegendSettings::setFontColor ( const QColor & c )

inline

Definition at line 88 of file qgslegendsettings.h.

void QgsLegendSettings::setLayerFontColor ( const QColor & fontColor )

inline

Sets layer font color to fontColor Overrides fontColor()

See also: layerFontColor(); fontColor()

Since: QGIS 3.4.7

Definition at line 105 of file qgslegendsettings.h.

void QgsLegendSettings::setLineSpacing ( double s )

inline

Definition at line 176 of file qgslegendsettings.h.

void QgsLegendSettings::setMapScale ( double scale )

inline

Sets the legend map scale.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also: mapScale()

Definition at line 196 of file qgslegendsettings.h.

void QgsLegendSettings::setMapUnitsPerPixel ( double mapUnitsPerPixel )

Sets the mMmPerMapUnit calculated by mapUnitsPerPixel mostly taken from the map settings.

See also: mapUnitsPerPixel()

Since: QGIS 3.4

Definition at line 43 of file qgslegendsettings.cpp.

void QgsLegendSettings::setMmPerMapUnit ( double mmPerMapUnit )

inline

Definition at line 179 of file qgslegendsettings.h.

void QgsLegendSettings::setRasterStrokeColor ( const QColor & color )

inline

Sets the stroke color for the stroke drawn around raster symbol items.

The stroke is only drawn if drawRasterStroke() is true.

Parameters

color stroke color

See also: rasterStrokeColor(); setDrawRasterStroke(); setRasterStrokeWidth()

Since: QGIS 2.12

Definition at line 149 of file qgslegendsettings.h.

void QgsLegendSettings::setRasterStrokeWidth ( double width )

inline

Sets the stroke width for the stroke drawn around raster symbol items.

The stroke is only drawn if drawRasterStroke() is true.

Parameters

width stroke width in millimeters

See also: rasterStrokeWidth(); setDrawRasterStroke(); setRasterStrokeColor()

Since: QGIS 2.12

Definition at line 170 of file qgslegendsettings.h.

void QgsLegendSettings::setSplitLayer ( bool s )

inline

Definition at line 82 of file qgslegendsettings.h.

void QgsLegendSettings::setStyle	(	QgsLegendStyle::Style	s,
		const QgsLegendStyle &	style
	)

inline

Definition at line 67 of file qgslegendsettings.h.

void QgsLegendSettings::setSymbolSize ( QSizeF s )

inline

Definition at line 109 of file qgslegendsettings.h.

void QgsLegendSettings::setTitle ( const QString & t )

inline

Definition at line 42 of file qgslegendsettings.h.

void QgsLegendSettings::setTitleAlignment ( Qt::AlignmentFlag alignment )

inline

Sets the alignment of the legend title.

Parameters

alignment Text alignment for drawing the legend title

See also: titleAlignment

Definition at line 57 of file qgslegendsettings.h.

void QgsLegendSettings::setUseAdvancedEffects ( bool use )

inline

Definition at line 182 of file qgslegendsettings.h.

void QgsLegendSettings::setWmsLegendSize ( QSizeF s )

inline

Definition at line 173 of file qgslegendsettings.h.

void QgsLegendSettings::setWrapChar ( const QString & t )

inline

Definition at line 72 of file qgslegendsettings.h.

bool QgsLegendSettings::splitLayer ( ) const

inline

Definition at line 81 of file qgslegendsettings.h.

QStringList QgsLegendSettings::splitStringForWrapping ( const QString & stringToSplt ) const

Splits a string using the wrap char taking into account handling empty wrap char which means no wrapping.

Definition at line 48 of file qgslegendsettings.cpp.

QgsLegendStyle QgsLegendSettings::style ( QgsLegendStyle::Style s ) const

inline

Returns style.

Definition at line 66 of file qgslegendsettings.h.

QSizeF QgsLegendSettings::symbolSize ( ) const

inline

Definition at line 108 of file qgslegendsettings.h.

double QgsLegendSettings::textWidthMillimeters	(	const QFont &	font,
		const QString &	text
	)		const

Returns the font width in millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.

Definition at line 104 of file qgslegendsettings.cpp.

QString QgsLegendSettings::title ( ) const

inline

Definition at line 43 of file qgslegendsettings.h.

Qt::AlignmentFlag QgsLegendSettings::titleAlignment ( ) const

inline

Returns the alignment of the legend title.

Returns: Qt::AlignmentFlag for the legend title

See also: setTitleAlignment

Definition at line 50 of file qgslegendsettings.h.

bool QgsLegendSettings::useAdvancedEffects ( ) const

inline

Definition at line 181 of file qgslegendsettings.h.

QSizeF QgsLegendSettings::wmsLegendSize ( ) const

inline

Definition at line 172 of file qgslegendsettings.h.

QString QgsLegendSettings::wrapChar ( ) const

inline

Definition at line 73 of file qgslegendsettings.h.

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

/build/qgis-3.4.15+24xenial/src/core/qgslegendsettings.h
/build/qgis-3.4.15+24xenial/src/core/qgslegendsettings.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation