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.
Q_DECL_DEPRECATED QFont	font () const
	Returns the font used for rendering this legend component.
double	indent () const
	Returns the indent (in mm) of a group or subgroup.
double	margin (Side side) const
	Returns the margin (in mm) for the specified side of the component.
void	readXml (const QDomElement &elem, const QDomDocument &doc, const QgsReadWriteContext &context=QgsReadWriteContext())
	Reads the component's style definition from an XML element.
void	setAlignment (Qt::Alignment alignment)
	Sets the alignment for the legend component.
Q_DECL_DEPRECATED void	setFont (const QFont &font)
	Sets the font used for rendering this legend component.
void	setIndent (double indent)
	Sets the indent (in mm) of a group or subgroup.
void	setMargin (double margin)
	Sets all margin sides to the same margin size (in mm).
void	setMargin (Side side, double margin)
	Sets the margin (in mm) for the specified side of the component.
void	setTextFormat (const QgsTextFormat &format)
	Sets the text format used for rendering this legend component.
QgsTextFormat &	textFormat ()
	Returns the text format used for rendering this legend component.
QgsTextFormat	textFormat () const
	Returns the text format used for rendering this legend component.
void	writeXml (const QString &name, QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context=QgsReadWriteContext()) const
	Writes the component's style definition to an XML element.

Static Public Member Functions
static Style	styleFromName (const QString &styleName)
	Returns the style from name string.
static QString	styleLabel (Style s)
	Returns a translated string representing a style component, for use in UI.
static QString	styleName (Style s)
	Returns the name for a style component as a string.

Detailed Description

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

Definition at line 36 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 55 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 41 of file qgslegendstyle.h.

Constructor & Destructor Documentation

QgsLegendStyle()

QgsLegendStyle::QgsLegendStyle

(

)

Definition at line 30 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 130 of file qgslegendstyle.h.

font()

Q_DECL_DEPRECATED QFont QgsLegendStyle::font ( ) const

inline

Returns the font used for rendering this legend component.

See also

setFont()

Deprecated:

QGIS 3.40. Use textFormat() instead.

Definition at line 70 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 146 of file qgslegendstyle.h.

margin()

double QgsLegendStyle::margin ( Side  side ) const

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 107 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 83 of file qgslegendstyle.cpp.

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 138 of file qgslegendstyle.h.

setFont()

void QgsLegendStyle::setFont

(

const QFont &

font

)

Sets the font used for rendering this legend component.

See also

font()

Deprecated:

QGIS 3.40. Use setTextFormat() instead.

Definition at line 34 of file qgslegendstyle.cpp.

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 154 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 49 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 116 of file qgslegendstyle.h.

setTextFormat()

void QgsLegendStyle::setTextFormat ( const QgsTextFormat &  format )

inline

Sets the text format used for rendering this legend component.

See also

textFormat()

Since

QGIS 3.30

Definition at line 98 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 135 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 152 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 113 of file qgslegendstyle.cpp.

textFormat() [1/2]

QgsTextFormat & QgsLegendStyle::textFormat ( )

inline

Returns the text format used for rendering this legend component.

See also

setTextFormat()

Since

QGIS 3.30

Definition at line 84 of file qgslegendstyle.h.

textFormat() [2/2]

QgsTextFormat QgsLegendStyle::textFormat ( ) const

inline

Returns the text format used for rendering this legend component.

See also

setTextFormat()

Since

QGIS 3.30

Definition at line 91 of file qgslegendstyle.h.

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 57 of file qgslegendstyle.cpp.

---

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

• /build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/core/qgslegendstyle.h
• /build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/core/qgslegendstyle.cpp