Stores metadata about one renderer class. More...

#include <qgsrendererregistry.h>

Inheritance diagram for QgsRendererAbstractMetadata:

Public Types
enum	LayerType { PointLayer = 1 , LineLayer = 2 , PolygonLayer = 4 , All = PointLayer \| LineLayer \| PolygonLayer }
	Layer types the renderer is compatible with. More...

Public Member Functions
	QgsRendererAbstractMetadata (const QString &name, const QString &visibleName, const QIcon &icon=QIcon())
	Constructor for QgsRendererAbstractMetadata, with the specified name. More...

virtual	~QgsRendererAbstractMetadata ()=default

virtual QgsRendererAbstractMetadata::LayerTypes	compatibleLayerTypes () const
	Returns flags indicating the types of layer the renderer is compatible with. More...

virtual QgsFeatureRenderer *	createRenderer (QDomElement &elem, const QgsReadWriteContext &context)=0
	Returns new instance of the renderer given the DOM element. More...

virtual QgsFeatureRenderer *	createRendererFromSld (QDomElement &elem, Qgis::GeometryType geomType)
	Returns a new instance of the renderer, converted from an SLD XML element. More...

virtual QgsRendererWidget *	createRendererWidget (QgsVectorLayer layer, QgsStyle style, QgsFeatureRenderer *oldRenderer)
	Returns new instance of settings widget for the renderer. More...

QIcon	icon () const
	Returns an icon representing the renderer. More...

QString	name () const
	Returns the unique name of the renderer. More...

void	setIcon (const QIcon &icon)
	Sets an icon representing the renderer. More...

QString	visibleName () const
	Returns a friendly display name of the renderer. More...

Protected Attributes
QIcon	mIcon
	icon to be shown in the renderer properties dialog More...

QString	mName
	name used within QGIS for identification (the same what renderer's type() returns) More...

QString	mVisibleName
	name visible for users (translatable) More...

Detailed Description

Stores metadata about one renderer class.

Note: It's necessary to implement createRenderer() function. In C++ you can use QgsRendererMetadata convenience class.

Definition at line 41 of file qgsrendererregistry.h.

Member Enumeration Documentation

◆ LayerType

enum QgsRendererAbstractMetadata::LayerType

Layer types the renderer is compatible with.

Since: QGIS 2.16

Enumerator
PointLayer	Compatible with point layers.
LineLayer	Compatible with line layers.
PolygonLayer	Compatible with polygon layers.
All	Compatible with all vector layers.

Definition at line 49 of file qgsrendererregistry.h.

Constructor & Destructor Documentation

◆ QgsRendererAbstractMetadata()

QgsRendererAbstractMetadata::QgsRendererAbstractMetadata	(	const QString &	name,
		const QString &	visibleName,
		const QIcon &	icon = `QIcon()`
	)

inline

Constructor for QgsRendererAbstractMetadata, with the specified name.

The visibleName argument gives a translated, user friendly string identifying the renderer type.

The icon argument can be used to specify an icon representing the renderer.

Definition at line 65 of file qgsrendererregistry.h.

◆ ~QgsRendererAbstractMetadata()

virtual QgsRendererAbstractMetadata::~QgsRendererAbstractMetadata ( )

virtualdefault

Member Function Documentation

◆ compatibleLayerTypes()

virtual QgsRendererAbstractMetadata::LayerTypes QgsRendererAbstractMetadata::compatibleLayerTypes ( ) const

inlinevirtual

Returns flags indicating the types of layer the renderer is compatible with.

Since: QGIS 2.16

Reimplemented in QgsRendererMetadata.

Definition at line 100 of file qgsrendererregistry.h.

◆ createRenderer()

virtual QgsFeatureRenderer * QgsRendererAbstractMetadata::createRenderer	(	QDomElement &	elem,
		const QgsReadWriteContext &	context
	)

pure virtual

Returns new instance of the renderer given the DOM element.

Returns nullptr on error. Pure virtual function: must be implemented in derived classes.

Implemented in QgsRendererMetadata.

◆ createRendererFromSld()

virtual QgsFeatureRenderer * QgsRendererAbstractMetadata::createRendererFromSld	(	QDomElement &	elem,
		Qgis::GeometryType	geomType
	)

inlinevirtual

Returns a new instance of the renderer, converted from an SLD XML element.

Reimplemented in QgsRendererMetadata.

Definition at line 121 of file qgsrendererregistry.h.

◆ createRendererWidget()

virtual QgsRendererWidget * QgsRendererAbstractMetadata::createRendererWidget	(	QgsVectorLayer *	layer,
		QgsStyle *	style,
		QgsFeatureRenderer *	oldRenderer
	)

inlinevirtual

Returns new instance of settings widget for the renderer.

Returns nullptr on error.

The oldRenderer argument may refer to previously used renderer (or it is nullptr). If not nullptr, it may be used to initialize GUI of the widget from the previous settings. The old renderer does not have to be of the same type as returned by createRenderer().

Reimplemented in QgsRendererMetadata.

Definition at line 115 of file qgsrendererregistry.h.

◆ icon()

QIcon QgsRendererAbstractMetadata::icon ( ) const

inline

Returns an icon representing the renderer.

See also: setIcon()

Definition at line 88 of file qgsrendererregistry.h.

◆ name()

QString QgsRendererAbstractMetadata::name ( ) const

inline

Returns the unique name of the renderer.

This value is not translated.

See also: visibleName()

Definition at line 76 of file qgsrendererregistry.h.

◆ setIcon()

void QgsRendererAbstractMetadata::setIcon ( const QIcon & icon )

inline

Sets an icon representing the renderer.

See also: icon()

Definition at line 94 of file qgsrendererregistry.h.

◆ visibleName()

QString QgsRendererAbstractMetadata::visibleName ( ) const

inline

Returns a friendly display name of the renderer.

This value is translated.

See also: name()

Definition at line 82 of file qgsrendererregistry.h.

Member Data Documentation

◆ mIcon

QIcon QgsRendererAbstractMetadata::mIcon

protected

icon to be shown in the renderer properties dialog

Definition at line 130 of file qgsrendererregistry.h.

◆ mName

QString QgsRendererAbstractMetadata::mName

protected

name used within QGIS for identification (the same what renderer's type() returns)

Definition at line 126 of file qgsrendererregistry.h.

◆ mVisibleName

QString QgsRendererAbstractMetadata::mVisibleName

protected

name visible for users (translatable)

Definition at line 128 of file qgsrendererregistry.h.

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

/build/qgis-3.32.0+99sid/src/core/symbology/qgsrendererregistry.h

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ LayerType

Constructor & Destructor Documentation

◆ QgsRendererAbstractMetadata()

◆ ~QgsRendererAbstractMetadata()

Member Function Documentation

◆ compatibleLayerTypes()

◆ createRenderer()

◆ createRendererFromSld()

◆ createRendererWidget()

◆ icon()

◆ name()

◆ setIcon()

◆ visibleName()

Member Data Documentation

◆ mIcon

◆ mName

◆ mVisibleName