16#ifndef QGSMAPLAYERREF_H
17#define QGSMAPLAYERREF_H
33template<
typename TYPE>
57 ,
layerId( l ? l->id() : QString() )
58 ,
source( l ? l->publicSource() : QString() )
60 ,
provider( l && l->dataProvider() ? l->dataProvider()->
name() : QString() )
81 layerId = l ? l->id() : QString();
82 source = l ? l->publicSource() : QString();
83 name = l ? l->name() : QString();
84 provider = l && l->dataProvider() ? l->dataProvider()->name() : QString();
93 return static_cast< bool >(
layer.data() );
152 if ( project && !
layerId.isEmpty() )
166 if ( matchType & MatchType::Name && (
layer->name().isEmpty() ||
layer->name() !=
name ) )
174 if ( matchType & MatchType::Provider &&
layer->providerType() !=
provider )
178 if ( matchType & MatchType::Source &&
layer->publicSource() !=
source )
219 QList<QgsMapLayer *> layers;
221 if ( matchType & MatchType::Name )
223 if (
name.isEmpty() )
233 for (
auto it = layers.constBegin(); it != layers.constEnd(); ++it )
235 if ( TYPE *tl = qobject_cast< TYPE *>( *it ) )
277 if ( project && !
name.isEmpty() )
282 if ( TYPE *tl = qobject_cast< TYPE *>( l ) )
Base class for all map layer types.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Q_INVOKABLE QgsMapLayer * mapLayer(const QString &layerId) const
Retrieve a pointer to a registered layer by layer ID.
QList< QgsMapLayer * > mapLayersByName(const QString &layerName) const
Retrieve a list of matching registered layers by layer name.
QMap< QString, QgsMapLayer * > mapLayers(const bool validOnly=false) const
Returns a map of all registered layers by layer ID.
_LayerRef< QgsMapLayer > QgsMapLayerRef
Internal structure to keep weak pointer to QgsMapLayer or layerId if the layer is not available yet.
TYPE * operator->() const
Forwards the to map layer.
TYPE * resolveWeakly(const QgsProject *project, MatchType matchType=MatchType::All)
Resolves the map layer by attempting to find a matching layer in a project using a weak match.
_LayerRef(const QString &id, const QString &name=QString(), const QString &source=QString(), const QString &provider=QString())
Constructor for a weak layer reference, using a combination of layer ID, name, public source and prov...
_LayerRef(TYPE *l=nullptr)
Constructor for a layer reference from an existing map layer.
MatchType
Flag for match type in weak resolution.
@ Provider
Match layer name.
@ Source
Match layer provider name.
QString source
Weak reference to layer public source.
QString name
Weak reference to layer name.
bool layerMatchesWeakly(QgsMapLayer *layer, MatchType matchType=MatchType::All) const
TYPE * resolveByIdOrNameOnly(const QgsProject *project)
Resolves the map layer by attempting to find a matching layer in a project using a weak match.
TYPE * get() const
Returns a pointer to the layer, or nullptr if the reference has not yet been matched to a layer.
QString provider
Weak reference to layer provider.
bool layerMatchesSource(QgsMapLayer *layer) const
Returns true if a layer matches the weak references to layer public source, layer name and data provi...
QPointer< TYPE > layer
Weak pointer to map layer.
TYPE * resolve(const QgsProject *project)
Resolves the map layer by attempting to find a layer with matching ID within a project.
void setLayer(TYPE *l)
Sets the reference to point to a specified layer.
QString layerId
Original layer ID.