QGIS API Documentation  3.20.0-Odense (decaadbb31)
Public Types | Public Member Functions | Static Public Member Functions | List of all members
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 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 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

Margin sides.

Enumerator
Top 

Top side.

Bottom 

Bottom side.

Left 

Left side.

Right 

Right side.

Definition at line 54 of file qgslegendstyle.h.

◆ 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.

◆ 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 67 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.

◆ 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 107 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 124 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 85 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: