A storage object for map layers, in which the layers are owned by the store and have their lifetime bound to the store. More...

#include <qgsmaplayerstore.h>

Inheritance diagram for QgsMapLayerStore:

[legend]

Signals
void	allLayersRemoved ()
	Emitted when all layers are removed, before layersWillBeRemoved() and layerWillBeRemoved() signals are emitted. More...

void	layerRemoved (const QString &layerId)
	Emitted after a layer was removed from the store. More...

void	layersAdded (const QList< QgsMapLayer * > &layers)
	Emitted when one or more layers were added to the store. More...

void	layersRemoved (const QStringList &layerIds)
	Emitted after one or more layers were removed from the store. More...

void	layersWillBeRemoved (const QList< QgsMapLayer * > &layers)
	Emitted when one or more layers are about to be removed from the store. More...

void	layersWillBeRemoved (const QStringList &layerIds)
	Emitted when one or more layers are about to be removed from the store. More...

void	layerWasAdded (QgsMapLayer *layer)
	Emitted when a layer was added to the store. More...

void	layerWillBeRemoved (const QString &layerId)
	Emitted when a layer is about to be removed from the store. More...

void	layerWillBeRemoved (QgsMapLayer *layer)
	Emitted when a layer is about to be removed from the store. More...

Public Member Functions
	QgsMapLayerStore (QObject *parent=nullptr)
	Constructor for QgsMapLayerStore. More...

	~QgsMapLayerStore () override

QgsMapLayer *	addMapLayer (QgsMapLayer *layer, bool takeOwnership=true)
	Add a layer to the store. More...

QList< QgsMapLayer * >	addMapLayers (const QList< QgsMapLayer * > &layers, bool takeOwnership=true)
	Add a list of layers to the store. More...

int	count () const
	Returns the number of layers contained in the store. More...

template<typename T >
QVector< T >	layers () const
	Returns a list of registered map layers with a specified layer type. More...

QgsMapLayer *	mapLayer (const QString &id) const
	Retrieve a pointer to a layer by layer id. More...

QMap< QString, QgsMapLayer * >	mapLayers () const
	Returns a map of all layers by layer ID. More...

QList< QgsMapLayer * >	mapLayersByName (const QString &name) const
	Retrieve a list of matching layers by layer name. More...

void	removeAllMapLayers ()
	Removes all registered layers. More...

void	removeMapLayer (const QString &id)
	Remove a layer from the store by layer id. More...

void	removeMapLayer (QgsMapLayer *layer)
	Remove a layer from the store. More...

void	removeMapLayers (const QList< QgsMapLayer * > &layers)
	Remove a set of layers from the store. More...

void	removeMapLayers (const QStringList &layerIds)
	Remove a set of layers from the store by layer ID. More...

QgsMapLayer *	takeMapLayer (QgsMapLayer *layer)
	Takes a layer from the store. More...

void	transferLayersFromStore (QgsMapLayerStore *other)
	Transfers all the map layers contained within another map layer store and adds them to this store. More...

int	validCount () const
	Returns the number of valid layers contained in the store. More...

QMap< QString, QgsMapLayer * >	validMapLayers () const
	Returns a map of all valid layers by layer ID. More...

Detailed Description

A storage object for map layers, in which the layers are owned by the store and have their lifetime bound to the store.

Since: QGIS 3.0

Definition at line 35 of file qgsmaplayerstore.h.

Constructor & Destructor Documentation

◆ QgsMapLayerStore()

QgsMapLayerStore::QgsMapLayerStore ( QObject * parent = nullptr )

explicit

Constructor for QgsMapLayerStore.

Definition at line 23 of file qgsmaplayerstore.cpp.

◆ ~QgsMapLayerStore()

QgsMapLayerStore::~QgsMapLayerStore ( )

override

Definition at line 27 of file qgsmaplayerstore.cpp.

Member Function Documentation

◆ addMapLayer()

QgsMapLayer * QgsMapLayerStore::addMapLayer	(	QgsMapLayer *	layer,
		bool	takeOwnership = `true`
	)

Add a layer to the store.

Ownership of the layer is transferred to the store.

The layersAdded() and layerWasAdded() signals will always be emitted. If you are adding multiple layers at once, you should use addMapLayers() instead.

Parameters

layer	A layer to add to the store
takeOwnership	Ownership will be transferred to the layer store. If you specify `false` here you have take care of deleting the layers yourself. Not available in Python.

Returns: nullptr if unable to add layer, otherwise pointer to newly added layer

See also: addMapLayers

Note: Use addMapLayers() if adding more than one layer at a time.

See also: addMapLayers()

Definition at line 105 of file qgsmaplayerstore.cpp.

◆ addMapLayers()

QList< QgsMapLayer * > QgsMapLayerStore::addMapLayers	(	const QList< QgsMapLayer * > &	layers,
		bool	takeOwnership = `true`
	)

Add a list of layers to the store.

Ownership of the layers is transferred to the store.

The layersAdded() and layerWasAdded() signals will always be emitted.

Parameters

layers	A list of layer which should be added to the store.
takeOwnership	Ownership will be transferred to the layer store. If you specify `false` here you have take care of deleting the layers yourself. Not available in Python.

Note: If a layer with the same id is already in the store it is not added again, but if the validity of the layer has changed from false to true, the layer data source is updated to the new one.

Returns: a list of the map layers that were added successfully. If a layer already exists in the store, it will not be part of the returned list.

See also: addMapLayer()

Definition at line 68 of file qgsmaplayerstore.cpp.

◆ allLayersRemoved

void QgsMapLayerStore::allLayersRemoved ( )

signal

Emitted when all layers are removed, before layersWillBeRemoved() and layerWillBeRemoved() signals are emitted.

The layersWillBeRemoved() and layerWillBeRemoved() signals will still be emitted following this signal. You can use this signal to do easy (and fast) cleanup.

◆ count()

int QgsMapLayerStore::count ( ) const

Returns the number of layers contained in the store.

Definition at line 32 of file qgsmaplayerstore.cpp.

◆ layerRemoved

void QgsMapLayerStore::layerRemoved ( const QString & layerId )

signal

Emitted after a layer was removed from the store.

Parameters

layerId The ID of the layer removed.

Note: Consider using layersRemoved() instead

See also: layerWillBeRemoved()

◆ layers()

template<typename T >

QVector<T> QgsMapLayerStore::layers ( ) const

inline

Returns a list of registered map layers with a specified layer type.

Example

QVector<QgsVectorLayer*> vectorLayers = store->layers<QgsVectorLayer*>();

Note: not available in Python bindings

See also: mapLayers()

Definition at line 124 of file qgsmaplayerstore.h.

◆ layersAdded

void QgsMapLayerStore::layersAdded ( const QList< QgsMapLayer * > & layers )

signal

Emitted when one or more layers were added to the store.

Parameters

layers List of layers which have been added.

See also: layerWasAdded()

◆ layersRemoved

void QgsMapLayerStore::layersRemoved ( const QStringList & layerIds )

signal

Emitted after one or more layers were removed from the store.

Parameters

layerIds A list of IDs of the layers which were removed.

See also: layersWillBeRemoved()

◆ layersWillBeRemoved [1/2]

void QgsMapLayerStore::layersWillBeRemoved ( const QList< QgsMapLayer * > & layers )

signal

Emitted when one or more layers are about to be removed from the store.

Parameters

layers A list of layers which are to be removed.

See also: layerWillBeRemoved(); layersRemoved()

◆ layersWillBeRemoved [2/2]

void QgsMapLayerStore::layersWillBeRemoved ( const QStringList & layerIds )

signal

Emitted when one or more layers are about to be removed from the store.

Parameters

layerIds A list of IDs for the layers which are to be removed.

See also: layerWillBeRemoved(); layersRemoved()

◆ layerWasAdded

void QgsMapLayerStore::layerWasAdded ( QgsMapLayer * layer )

signal

Emitted when a layer was added to the store.

Note: Consider using layersAdded() instead

See also: layersAdded()

◆ layerWillBeRemoved [1/2]

void QgsMapLayerStore::layerWillBeRemoved ( const QString & layerId )

signal

Emitted when a layer is about to be removed from the store.

Parameters

layerId The ID of the layer to be removed.

Note: Consider using layersWillBeRemoved() instead.

See also: layersWillBeRemoved(); layerRemoved()

◆ layerWillBeRemoved [2/2]

void QgsMapLayerStore::layerWillBeRemoved ( QgsMapLayer * layer )

signal

Emitted when a layer is about to be removed from the store.

Parameters

layer The layer to be removed.

Note: Consider using layersWillBeRemoved() instead.

See also: layersWillBeRemoved(); layerRemoved()

◆ mapLayer()

QgsMapLayer * QgsMapLayerStore::mapLayer ( const QString & id ) const

Retrieve a pointer to a layer by layer id.

Parameters

id	ID of layer to retrieve

Returns: matching layer, or nullptr if no matching layer found

See also: mapLayersByName(); mapLayers()

Definition at line 49 of file qgsmaplayerstore.cpp.

◆ mapLayers()

QMap< QString, QgsMapLayer * > QgsMapLayerStore::mapLayers ( ) const

Returns a map of all layers by layer ID.

See also: mapLayer(); mapLayersByName(); layers()

Definition at line 235 of file qgsmaplayerstore.cpp.

◆ mapLayersByName()

QList< QgsMapLayer * > QgsMapLayerStore::mapLayersByName ( const QString & name ) const

Retrieve a list of matching layers by layer name.

Parameters

name	name of layers to match

Returns: list of matching layers

See also: mapLayer(); mapLayers()

Definition at line 54 of file qgsmaplayerstore.cpp.

◆ removeAllMapLayers()

void QgsMapLayerStore::removeAllMapLayers ( )

Removes all registered layers.

These layers will also be deleted.

Note: Calling this method will cause the removeAll() signal to be emitted.

See also: removeMapLayer(); removeMapLayers()

Definition at line 198 of file qgsmaplayerstore.cpp.

◆ removeMapLayer() [1/2]

void QgsMapLayerStore::removeMapLayer ( const QString & id )

Remove a layer from the store by layer id.

The specified layer will be removed from the store. The layer will also be deleted.

Parameters

id	ID of the layer to remove

See also: takeMapLayer(); removeMapLayers(); removeAllMapLayers()

Definition at line 166 of file qgsmaplayerstore.cpp.

◆ removeMapLayer() [2/2]

void QgsMapLayerStore::removeMapLayer ( QgsMapLayer * layer )

Remove a layer from the store.

The specified layer will be removed from the store. The layer will also be deleted.

Parameters

layer The layer to remove. nullptr values are ignored.

See also: takeMapLayer(); removeMapLayers(); removeAllMapLayers()

Definition at line 171 of file qgsmaplayerstore.cpp.

◆ removeMapLayers() [1/2]

void QgsMapLayerStore::removeMapLayers ( const QList< QgsMapLayer * > & layers )

Remove a set of layers from the store.

The specified layers will be removed from the store. These layers will also be deleted.

Parameters

layers A list of layers to remove. nullptr values are ignored.

See also: takeMapLayer(); removeMapLayer(); removeAllMapLayers()

Definition at line 124 of file qgsmaplayerstore.cpp.

◆ removeMapLayers() [2/2]

void QgsMapLayerStore::removeMapLayers ( const QStringList & layerIds )

Remove a set of layers from the store by layer ID.

The specified layers will be removed from the store. These layers will also be deleted.

Parameters

layerIds list of IDs of the layers to remove

See also: takeMapLayer(); removeMapLayer(); removeAllMapLayers()

Note: available in Python bindings as removeMapLayersById.

Definition at line 112 of file qgsmaplayerstore.cpp.

◆ takeMapLayer()

QgsMapLayer * QgsMapLayerStore::takeMapLayer ( QgsMapLayer * layer )

Takes a layer from the store.

If the layer was owned by the store, the layer will be returned without deleting it. The caller takes ownership of the layer and is responsible for deleting it.

See also: removeMapLayer()

Definition at line 177 of file qgsmaplayerstore.cpp.

◆ transferLayersFromStore()

void QgsMapLayerStore::transferLayersFromStore ( QgsMapLayerStore * other )

Transfers all the map layers contained within another map layer store and adds them to this store.

Note that other and this store must have the same thread affinity.

Definition at line 207 of file qgsmaplayerstore.cpp.

◆ validCount()

int QgsMapLayerStore::validCount ( ) const

Returns the number of valid layers contained in the store.

Since: QGIS 3.6

Definition at line 37 of file qgsmaplayerstore.cpp.

◆ validMapLayers()

QMap< QString, QgsMapLayer * > QgsMapLayerStore::validMapLayers ( ) const

Returns a map of all valid layers by layer ID.

See also: mapLayer(); mapLayersByName(); layers()

Since: QGIS 3.6

Definition at line 240 of file qgsmaplayerstore.cpp.

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

/build/qgis-3.16.0+99unstable/src/core/qgsmaplayerstore.h
/build/qgis-3.16.0+99unstable/src/core/qgsmaplayerstore.cpp

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsMapLayerStore()

◆ ~QgsMapLayerStore()

Member Function Documentation

◆ addMapLayer()

◆ addMapLayers()

◆ allLayersRemoved

◆ count()

◆ layerRemoved

◆ layers()

Example

◆ layersAdded

◆ layersRemoved

◆ layersWillBeRemoved [1/2]

◆ layersWillBeRemoved [2/2]

◆ layerWasAdded

◆ layerWillBeRemoved [1/2]

◆ layerWillBeRemoved [2/2]

◆ mapLayer()

◆ mapLayers()

◆ mapLayersByName()

◆ removeAllMapLayers()

◆ removeMapLayer() [1/2]

◆ removeMapLayer() [2/2]

◆ removeMapLayers() [1/2]

◆ removeMapLayers() [2/2]

◆ takeMapLayer()

◆ transferLayersFromStore()

◆ validCount()

◆ validMapLayers()