QgsLegendSettings Class Reference

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
QStringList	evaluateItemText (const QString &text, const QgsExpressionContext &context) const
	Splits a string using the wrap char taking into account handling empty wrap char which means no wrapping. More...
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...
double	lineSpacing () const
double	mapScale () const
	Returns the legend map scale. 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	setLineSpacing (double s)
void	setMapScale (double scale)
	Sets the legend map scale. 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 38 of file qgslegendsettings.h.

Constructor & Destructor Documentation

QgsLegendSettings()

QgsLegendSettings::QgsLegendSettings

(

)

Definition at line 22 of file qgslegendsettings.cpp.

Member Function Documentation

boxSpace()

double QgsLegendSettings::boxSpace ( ) const

inline

Definition at line 70 of file qgslegendsettings.h.

columnCount()

int QgsLegendSettings::columnCount ( ) const

inline

Definition at line 79 of file qgslegendsettings.h.

columnSpace()

double QgsLegendSettings::columnSpace ( ) const

inline

Definition at line 76 of file qgslegendsettings.h.

dpi()

int QgsLegendSettings::dpi ( ) const

inline

Definition at line 181 of file qgslegendsettings.h.

drawRasterStroke()

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 101 of file qgslegendsettings.h.

drawText() [1/2]

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 60 of file qgslegendsettings.cpp.

drawText() [2/2]

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 73 of file qgslegendsettings.cpp.

equalColumnWidth()

bool QgsLegendSettings::equalColumnWidth ( ) const

inline

Definition at line 85 of file qgslegendsettings.h.

evaluateItemText()

QStringList QgsLegendSettings::evaluateItemText	(	const QString &	text,
		const QgsExpressionContext &	context
	)		const

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

Returns the actual text to render for a legend item, split into separate lines.

The expression context argument is used to correctly evaluated expressions contained within legend item text.

Since

QGIS 3.6

Definition at line 40 of file qgslegendsettings.cpp.

fontAscentMillimeters()

double QgsLegendSettings::fontAscentMillimeters

(

const QFont &

font

)

const

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

Definition at line 116 of file qgslegendsettings.cpp.

fontColor()

QColor QgsLegendSettings::fontColor ( ) const

inline

Definition at line 88 of file qgslegendsettings.h.

fontDescentMillimeters()

double QgsLegendSettings::fontDescentMillimeters

(

const QFont &

font

)

const

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

Definition at line 123 of file qgslegendsettings.cpp.

fontHeightCharacterMM()

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

Returns the font height of a character in millimeters.

Definition at line 109 of file qgslegendsettings.cpp.

lineSpacing()

double QgsLegendSettings::lineSpacing ( ) const

inline

Definition at line 158 of file qgslegendsettings.h.

mapScale()

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 172 of file qgslegendsettings.h.

mmPerMapUnit()

double QgsLegendSettings::mmPerMapUnit ( ) const

inline

Definition at line 161 of file qgslegendsettings.h.

pixelFontSize()

double QgsLegendSettings::pixelFontSize

(

double

pointSize

)

const

Calculates font to from point size to pixel size.

Definition at line 97 of file qgslegendsettings.cpp.

rasterStrokeColor()

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 121 of file qgslegendsettings.h.

rasterStrokeWidth()

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 142 of file qgslegendsettings.h.

rstyle()

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

inline

Returns reference to modifiable style.

Note

Not available in Python bindings.

Definition at line 65 of file qgslegendsettings.h.

scaledFontPixelSize()

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 89 of file qgslegendsettings.cpp.

setBoxSpace()

void QgsLegendSettings::setBoxSpace ( double  s )

inline

Definition at line 71 of file qgslegendsettings.h.

setColumnCount()

void QgsLegendSettings::setColumnCount ( int  c )

inline

Definition at line 80 of file qgslegendsettings.h.

setColumnSpace()

void QgsLegendSettings::setColumnSpace ( double  s )

inline

Definition at line 77 of file qgslegendsettings.h.

setDpi()

void QgsLegendSettings::setDpi ( int  dpi )

inline

Definition at line 182 of file qgslegendsettings.h.

setDrawRasterStroke()

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 111 of file qgslegendsettings.h.

setEqualColumnWidth()

void QgsLegendSettings::setEqualColumnWidth ( bool  s )

inline

Definition at line 86 of file qgslegendsettings.h.

setFontColor()

void QgsLegendSettings::setFontColor ( const QColor &  c )

inline

Definition at line 89 of file qgslegendsettings.h.

setLineSpacing()

void QgsLegendSettings::setLineSpacing ( double  s )

inline

Definition at line 159 of file qgslegendsettings.h.

setMapScale()

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 179 of file qgslegendsettings.h.

setMmPerMapUnit()

void QgsLegendSettings::setMmPerMapUnit ( double  mmPerMapUnit )

inline

Definition at line 162 of file qgslegendsettings.h.

setRasterStrokeColor()

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 132 of file qgslegendsettings.h.

setRasterStrokeWidth()

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 153 of file qgslegendsettings.h.

setSplitLayer()

void QgsLegendSettings::setSplitLayer ( bool  s )

inline

Definition at line 83 of file qgslegendsettings.h.

setStyle()

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

inline

Definition at line 68 of file qgslegendsettings.h.

setSymbolSize()

void QgsLegendSettings::setSymbolSize ( QSizeF  s )

inline

Definition at line 92 of file qgslegendsettings.h.

setTitle()

void QgsLegendSettings::setTitle ( const QString &  t )

inline

Definition at line 43 of file qgslegendsettings.h.

setTitleAlignment()

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 58 of file qgslegendsettings.h.

setUseAdvancedEffects()

void QgsLegendSettings::setUseAdvancedEffects ( bool  use )

inline

Definition at line 165 of file qgslegendsettings.h.

setWmsLegendSize()

void QgsLegendSettings::setWmsLegendSize ( QSizeF  s )

inline

Definition at line 156 of file qgslegendsettings.h.

setWrapChar()

void QgsLegendSettings::setWrapChar ( const QString &  t )

inline

Definition at line 73 of file qgslegendsettings.h.

splitLayer()

bool QgsLegendSettings::splitLayer ( ) const

inline

Definition at line 82 of file qgslegendsettings.h.

splitStringForWrapping()

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 46 of file qgslegendsettings.cpp.

style()

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

inline

Returns style.

Definition at line 67 of file qgslegendsettings.h.

symbolSize()

QSizeF QgsLegendSettings::symbolSize ( ) const

inline

Definition at line 91 of file qgslegendsettings.h.

textWidthMillimeters()

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 102 of file qgslegendsettings.cpp.

title()

QString QgsLegendSettings::title ( ) const

inline

Definition at line 44 of file qgslegendsettings.h.

titleAlignment()

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 51 of file qgslegendsettings.h.

useAdvancedEffects()

bool QgsLegendSettings::useAdvancedEffects ( ) const

inline

Definition at line 164 of file qgslegendsettings.h.

wmsLegendSize()

QSizeF QgsLegendSettings::wmsLegendSize ( ) const

inline

Definition at line 155 of file qgslegendsettings.h.

wrapChar()

QString QgsLegendSettings::wrapChar ( ) const

inline

Definition at line 74 of file qgslegendsettings.h.

---

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

• /tmp/buildd/qgis-3.6.0+99unstable/src/core/qgslegendsettings.h
• /tmp/buildd/qgis-3.6.0+99unstable/src/core/qgslegendsettings.cpp