Contains detailed styling information relating to how a layout legend should be rendered. More...

#include <qgslegendstyle.h>

Public Types
enum	Side { Top = 0 , Bottom = 1 , Left = 2 , Right = 3 }
	Margin sides. More...

enum	Style { Undefined , Hidden , Title , Group , Subgroup , Symbol , SymbolLabel }
	Component of legends which can be styled. More...

Public Member Functions
	QgsLegendStyle ()

Qt::Alignment	alignment () const
	Returns the alignment for the legend component. More...

QFont	font () const
	Returns the font used for rendering this legend component. More...

double	indent () const
	Returns the indent (in mm) of a group or subgroup. More...

double	margin (Side side)
	Returns the margin (in mm) for the specified side of the component. More...

void	readXml (const QDomElement &elem, const QDomDocument &doc, const QgsReadWriteContext &context=QgsReadWriteContext())
	Reads the component's style definition from an XML element. More...

QFont &	rfont ()
	Returns a modifiable reference to the component's font. More...

void	setAlignment (Qt::Alignment alignment)
	Sets the alignment for the legend component. More...

void	setFont (const QFont &font)
	Sets the font used for rendering this legend component. More...

void	setIndent (double indent)
	Sets the indent (in mm) of a group or subgroup. More...

void	setMargin (double margin)
	Sets all margin sides to the same margin size (in mm). More...

void	setMargin (Side side, double margin)
	Sets the margin (in mm) for the specified side of the component. More...

void	writeXml (const QString &name, QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context=QgsReadWriteContext()) const
	Writes the component's style definition to an XML element. More...

Static Public Member Functions
static Style	styleFromName (const QString &styleName)
	Returns the style from name string. More...

static QString	styleLabel (Style s)
	Returns a translated string representing a style component, for use in UI. More...

static QString	styleName (Style s)
	Returns the name for a style component as a string. More...

Detailed Description

Contains detailed styling information relating to how a layout legend should be rendered.

Definition at line 35 of file qgslegendstyle.h.

Member Enumeration Documentation

◆ Side

enum QgsLegendStyle::Side

Margin sides.

Enumerator
Top	Top side.
Bottom	Bottom side.
Left	Left side.
Right	Right side.

Definition at line 54 of file qgslegendstyle.h.

◆ Style

enum QgsLegendStyle::Style

Component of legends which can be styled.

Enumerator
Undefined	Should not happen, only if corrupted project file.
Hidden	Special style, item is hidden including margins around.
Title	Legend title.
Group	Legend group title.
Subgroup	Legend subgroup title.
Symbol	Symbol icon (excluding label)
SymbolLabel	Symbol label (excluding icon)

Definition at line 40 of file qgslegendstyle.h.

Constructor & Destructor Documentation

◆ QgsLegendStyle()

QgsLegendStyle::QgsLegendStyle ( )

Definition at line 31 of file qgslegendstyle.cpp.

Member Function Documentation

◆ alignment()

Qt::Alignment QgsLegendStyle::alignment ( ) const

inline

Returns the alignment for the legend component.

See also: setAlignment()

Since: QGIS 3.10

Definition at line 114 of file qgslegendstyle.h.

◆ font()

QFont QgsLegendStyle::font ( ) const

inline

Returns the font used for rendering this legend component.

See also: setFont()

Definition at line 68 of file qgslegendstyle.h.

◆ indent()

double QgsLegendStyle::indent ( ) const

inline

Returns the indent (in mm) of a group or subgroup.

See also: indent()

Since: QGIS 3.22

Definition at line 130 of file qgslegendstyle.h.

◆ margin()

double QgsLegendStyle::margin ( Side side )

inline

Returns the margin (in mm) for the specified side of the component.

Note: Not all legend components respect all margin side settings!

See also: setMargin()

Definition at line 91 of file qgslegendstyle.h.

◆ readXml()

void QgsLegendStyle::readXml	(	const QDomElement &	elem,
		const QDomDocument &	doc,
		const QgsReadWriteContext &	context = `QgsReadWriteContext()`
	)

Reads the component's style definition from an XML element.

See also: writeXml()

Definition at line 68 of file qgslegendstyle.cpp.

◆ rfont()

QFont & QgsLegendStyle::rfont ( )

inline

Returns a modifiable reference to the component's font.

See also: setFont()

Note: Not available in Python bindings

Definition at line 82 of file qgslegendstyle.h.

◆ setAlignment()

void QgsLegendStyle::setAlignment ( Qt::Alignment alignment )

inline

Sets the alignment for the legend component.

See also: alignment()

Since: QGIS 3.10

Definition at line 122 of file qgslegendstyle.h.

◆ setFont()

void QgsLegendStyle::setFont ( const QFont & font )

inline

Sets the font used for rendering this legend component.

See also: font()

Definition at line 74 of file qgslegendstyle.h.

◆ setIndent()

void QgsLegendStyle::setIndent ( double indent )

inline

Sets the indent (in mm) of a group or subgroup.

See also: indent()

Since: QGIS 3.22

Definition at line 138 of file qgslegendstyle.h.

◆ setMargin() [1/2]

void QgsLegendStyle::setMargin ( double margin )

Sets all margin sides to the same margin size (in mm).

See also: margin()

Definition at line 35 of file qgslegendstyle.cpp.

◆ setMargin() [2/2]

void QgsLegendStyle::setMargin	(	Side	side,
		double	margin
	)

inline

Sets the margin (in mm) for the specified side of the component.

Note: Not all legend components respect all margin side settings!

See also: margin()

Definition at line 100 of file qgslegendstyle.h.

◆ styleFromName()

QgsLegendStyle::Style QgsLegendStyle::styleFromName ( const QString & styleName )

static

Returns the style from name string.

See also: styleName()

Definition at line 109 of file qgslegendstyle.cpp.

◆ styleLabel()

QString QgsLegendStyle::styleLabel ( Style s )

static

Returns a translated string representing a style component, for use in UI.

See also: styleName()

Definition at line 126 of file qgslegendstyle.cpp.

◆ styleName()

QString QgsLegendStyle::styleName ( Style s )

static

Returns the name for a style component as a string.

This is a non-localised version, for internal use.

See also: styleFromName(); styleLabel()

Definition at line 87 of file qgslegendstyle.cpp.

◆ writeXml()

void QgsLegendStyle::writeXml	(	const QString &	name,
		QDomElement &	elem,
		QDomDocument &	doc,
		const QgsReadWriteContext &	context = `QgsReadWriteContext()`
	)		const

Writes the component's style definition to an XML element.

See also: readXml()

Definition at line 43 of file qgslegendstyle.cpp.

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

/build/qgis-3.28.0+99sid/src/core/qgslegendstyle.h
/build/qgis-3.28.0+99sid/src/core/qgslegendstyle.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ Side

◆ Style

Constructor & Destructor Documentation

◆ QgsLegendStyle()

Member Function Documentation

◆ alignment()

◆ font()

◆ indent()

◆ margin()

◆ readXml()

◆ rfont()

◆ setAlignment()

◆ setFont()

◆ setIndent()

◆ setMargin() [1/2]

◆ setMargin() [2/2]

◆ styleFromName()

◆ styleLabel()

◆ styleName()

◆ writeXml()