Class: QgsScaleBarRendererRegistry

class qgis.core.QgsScaleBarRendererRegistry

Bases: sip.wrapper

The QgsScaleBarRendererRegistry manages registered scalebar renderers.

A reference to the QgsScaleBarRendererRegistry can be obtained from QgsApplication.scalebarRendererRegistry().

New in version 3.14.

QgsScaleBarRendererRegistry() You should not normally need to create your own scalebar renderer registry.

Use the one provided by :py:func:`QgsApplication.scalebarRendererRegistry()` instead.

QgsScaleBarRendererRegistry(QgsScaleBarRendererRegistry)

Methods

addRenderer

Adds a new renderer to the registry.

removeRenderer

Removes the renderer with matching id from the registry.

renderer

Creates a new scalebar renderer by id.

renderers

Returns a list of the renderer ids currently contained in the registry.

sortKey

Returns the sorting key for the renderer with matching id.

sortedRendererList

Returns a list of the renderer ids currently contained in the registry, sorted in an order respecting the renderer's sort keys and display strings.

visibleName

Returns the translated, user-visible name for the renderer with matching id.

addRenderer(self, renderer: QgsScaleBarRenderer)

Adds a new renderer to the registry.

Ownership is transferred to the registry.

Parameters:

renderer (QgsScaleBarRenderer) –

removeRenderer(self, id: str)

Removes the renderer with matching id from the registry.

Parameters:

id (str) –

renderer(self, id: str) QgsScaleBarRenderer

Creates a new scalebar renderer by id. If there is no such id registered, None will be returned instead.

The caller takes ownership of the returned object.

Parameters:

id (str) –

Return type:

QgsScaleBarRenderer

renderers(self) List[str]

Returns a list of the renderer ids currently contained in the registry.

Return type:

List[str]

sortKey(self, id: str) int

Returns the sorting key for the renderer with matching id.

Parameters:

id (str) –

Return type:

int

sortedRendererList(self) List[str]

Returns a list of the renderer ids currently contained in the registry, sorted in an order respecting the renderer’s sort keys and display strings.

Return type:

List[str]

visibleName(self, id: str) str

Returns the translated, user-visible name for the renderer with matching id.

Parameters:

id (str) –

Return type:

str