QgsLegendStyle Class Reference

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 67 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 53 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 127 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 81 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 143 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 104 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 95 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 135 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 87 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 151 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 113 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.26.3+32focal/src/core/qgslegendstyle.h
• /build/qgis-3.26.3+32focal/src/core/qgslegendstyle.cpp