QGIS API Documentation  3.11.0-Master (68611307d7)
Public Member Functions | List of all members
QgsDefaultVectorLayerLegend Class Reference

Default legend implementation for vector layers. More...

#include <qgsmaplayerlegend.h>

Inheritance diagram for QgsDefaultVectorLayerLegend:
Inheritance graph
[legend]

Public Member Functions

 QgsDefaultVectorLayerLegend (QgsVectorLayer *vl)
 
QList< QgsLayerTreeModelLegendNode * > createLayerTreeModelLegendNodes (QgsLayerTreeLayer *nodeLayer) override
 Returns list of legend nodes to be used for a particular layer tree layer node. More...
 
void readXml (const QDomElement &elem, const QgsReadWriteContext &context) override
 Reads configuration from a DOM element previously written by writeXml() More...
 
void setTextOnSymbolContent (const QHash< QString, QString > &content)
 Sets per-symbol content of labels for "text on symbol" functionality. More...
 
void setTextOnSymbolEnabled (bool enabled)
 Sets whether the "text on symbol" functionality is enabled. More...
 
void setTextOnSymbolTextFormat (const QgsTextFormat &format)
 Sets text format of symbol labels for "text on symbol" functionality. More...
 
QHash< QString, QString > textOnSymbolContent () const
 Returns per-symbol content of labels for "text on symbol" functionality. More...
 
bool textOnSymbolEnabled () const
 Returns whether the "text on symbol" functionality is enabled. More...
 
QgsTextFormat textOnSymbolTextFormat () const
 Returns text format of symbol labels for "text on symbol" functionality. More...
 
QDomElement writeXml (QDomDocument &doc, const QgsReadWriteContext &context) const override
 Writes configuration to a DOM element, to be used later with readXml() More...
 
- Public Member Functions inherited from QgsMapLayerLegend
 QgsMapLayerLegend (QObject *parent=nullptr)
 Constructor for QgsMapLayerLegend. More...
 

Additional Inherited Members

- Signals inherited from QgsMapLayerLegend
void itemsChanged ()
 Emitted when existing items/nodes got invalid and should be replaced by new ones. More...
 
- Static Public Member Functions inherited from QgsMapLayerLegend
static QgsMapLayerLegenddefaultMeshLegend (QgsMeshLayer *ml)
 Create new legend implementation for mesh layer. More...
 
static QgsMapLayerLegenddefaultRasterLegend (QgsRasterLayer *rl)
 Create new legend implementation for raster layer. More...
 
static QgsMapLayerLegenddefaultVectorLegend (QgsVectorLayer *vl)
 Create new legend implementation for vector layer. More...
 

Detailed Description

Default legend implementation for vector layers.

Since
QGIS 2.6

Definition at line 119 of file qgsmaplayerlegend.h.

Constructor & Destructor Documentation

◆ QgsDefaultVectorLayerLegend()

QgsDefaultVectorLayerLegend::QgsDefaultVectorLayerLegend ( QgsVectorLayer vl)
explicit

Definition at line 197 of file qgsmaplayerlegend.cpp.

Member Function Documentation

◆ createLayerTreeModelLegendNodes()

QList< QgsLayerTreeModelLegendNode * > QgsDefaultVectorLayerLegend::createLayerTreeModelLegendNodes ( QgsLayerTreeLayer nodeLayer)
overridevirtual

Returns list of legend nodes to be used for a particular layer tree layer node.

Ownership is transferred to the caller.

Implements QgsMapLayerLegend.

Definition at line 203 of file qgsmaplayerlegend.cpp.

◆ readXml()

void QgsDefaultVectorLayerLegend::readXml ( const QDomElement &  elem,
const QgsReadWriteContext context 
)
overridevirtual

Reads configuration from a DOM element previously written by writeXml()

Since
QGIS 3.2

Reimplemented from QgsMapLayerLegend.

Definition at line 254 of file qgsmaplayerlegend.cpp.

◆ setTextOnSymbolContent()

void QgsDefaultVectorLayerLegend::setTextOnSymbolContent ( const QHash< QString, QString > &  content)
inline

Sets per-symbol content of labels for "text on symbol" functionality.

In the passed dictionary the keys are rule keys of legend items, the values are labels to be shown.

Since
QGIS 3.2

Definition at line 166 of file qgsmaplayerlegend.h.

◆ setTextOnSymbolEnabled()

void QgsDefaultVectorLayerLegend::setTextOnSymbolEnabled ( bool  enabled)
inline

Sets whether the "text on symbol" functionality is enabled.

When enabled, legend symbols may have extra text rendered on top. The content of labels and their style is controlled by textOnSymbolContent() and textOnSymbolTextFormat().

Since
QGIS 3.2

Definition at line 140 of file qgsmaplayerlegend.h.

◆ setTextOnSymbolTextFormat()

void QgsDefaultVectorLayerLegend::setTextOnSymbolTextFormat ( const QgsTextFormat format)
inline

Sets text format of symbol labels for "text on symbol" functionality.

Since
QGIS 3.2

Definition at line 152 of file qgsmaplayerlegend.h.

◆ textOnSymbolContent()

QHash<QString, QString> QgsDefaultVectorLayerLegend::textOnSymbolContent ( ) const
inline

Returns per-symbol content of labels for "text on symbol" functionality.

In the passed dictionary the keys are rule keys of legend items, the values are labels to be shown.

Since
QGIS 3.2

Definition at line 159 of file qgsmaplayerlegend.h.

◆ textOnSymbolEnabled()

bool QgsDefaultVectorLayerLegend::textOnSymbolEnabled ( ) const
inline

Returns whether the "text on symbol" functionality is enabled.

When enabled, legend symbols may have extra text rendered on top. The content of labels and their style is controlled by textOnSymbolContent() and textOnSymbolTextFormat().

Since
QGIS 3.2

Definition at line 132 of file qgsmaplayerlegend.h.

◆ textOnSymbolTextFormat()

QgsTextFormat QgsDefaultVectorLayerLegend::textOnSymbolTextFormat ( ) const
inline

Returns text format of symbol labels for "text on symbol" functionality.

Since
QGIS 3.2

Definition at line 146 of file qgsmaplayerlegend.h.

◆ writeXml()

QDomElement QgsDefaultVectorLayerLegend::writeXml ( QDomDocument &  doc,
const QgsReadWriteContext context 
) const
overridevirtual

Writes configuration to a DOM element, to be used later with readXml()

Since
QGIS 3.2

Reimplemented from QgsMapLayerLegend.

Definition at line 276 of file qgsmaplayerlegend.cpp.


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