mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
147 lines
4.2 KiB
Plaintext
147 lines
4.2 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layertree/qgslayertreelayer.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
class QgsLayerTreeLayer : QgsLayerTreeNode
|
|
{
|
|
%Docstring
|
|
Layer tree node points to a map layer.
|
|
|
|
The node can exist also without a valid instance of a layer (just ID). That
|
|
means the referenced layer does not need to be loaded in order to use it
|
|
in layer tree. In such case, resolveReferences() method can be called
|
|
once the layer is loaded.
|
|
|
|
A map layer is supposed to be present in one layer tree just once. It is
|
|
however possible that temporarily a layer exists in one tree more than just
|
|
once, e.g. while reordering items with drag and drop.
|
|
|
|
.. versionadded:: 2.4
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgslayertreelayer.h"
|
|
%End
|
|
public:
|
|
explicit QgsLayerTreeLayer( QgsMapLayer *layer );
|
|
|
|
|
|
explicit QgsLayerTreeLayer( const QString &layerId, const QString &name = QString(), const QString &source = QString(), const QString &provider = QString() );
|
|
%Docstring
|
|
Constructor for QgsLayerTreeLayer using weak references to layer ID, ``name``, public ``source``, and ``provider`` key.
|
|
%End
|
|
|
|
QString layerId() const;
|
|
%Docstring
|
|
Returns the ID for the map layer associated with this node.
|
|
|
|
.. seealso:: :py:func:`layer`
|
|
%End
|
|
|
|
QgsMapLayer *layer() const;
|
|
%Docstring
|
|
Returns the map layer associated with this node.
|
|
|
|
.. warning::
|
|
|
|
This can be (and often is!) a None, e.g. in the case of a layer node representing a layer
|
|
which has not yet been fully loaded into a project, or a layer node representing a layer
|
|
with an invalid data source. The returned pointer must ALWAYS be checked to avoid dereferencing a None.
|
|
|
|
.. seealso:: :py:func:`layerId`
|
|
%End
|
|
|
|
virtual QString name() const;
|
|
|
|
%Docstring
|
|
Returns the layer's name.
|
|
|
|
.. seealso:: :py:func:`setName`
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
virtual void setName( const QString &n );
|
|
|
|
%Docstring
|
|
Sets the layer's name.
|
|
|
|
.. seealso:: :py:func:`name`
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
static QgsLayerTreeLayer *readXml( QDomElement &element, const QgsReadWriteContext &context ) /Factory/;
|
|
%Docstring
|
|
Read layer node from XML. Returns new instance.
|
|
Does not resolve textual references to layers. Call resolveReferences() afterwards to do it.
|
|
%End
|
|
|
|
static QgsLayerTreeLayer *readXml( QDomElement &element, const QgsProject *project, const QgsReadWriteContext &context ) /Factory/;
|
|
%Docstring
|
|
Read layer node from XML. Returns new instance.
|
|
Also resolves textual references to layers from the project (calls resolveReferences() internally).
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
virtual void writeXml( QDomElement &parentElement, const QgsReadWriteContext &context );
|
|
|
|
|
|
virtual QString dump() const;
|
|
|
|
|
|
virtual QgsLayerTreeLayer *clone() const /Factory/;
|
|
|
|
|
|
virtual void resolveReferences( const QgsProject *project, bool looseMatching = false );
|
|
|
|
%Docstring
|
|
Resolves reference to layer from stored layer ID (if it has not been resolved already)
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
signals:
|
|
|
|
void layerLoaded();
|
|
%Docstring
|
|
Emitted when a previously unavailable layer got loaded.
|
|
%End
|
|
|
|
void layerWillBeUnloaded();
|
|
%Docstring
|
|
Emitted when a previously available layer got unloaded (from layer registry).
|
|
|
|
.. versionadded:: 2.6
|
|
%End
|
|
|
|
protected:
|
|
void attachToLayer();
|
|
|
|
|
|
private:
|
|
|
|
QgsLayerTreeLayer( const QgsLayerTreeLayer &other );
|
|
%Docstring
|
|
Copies are not allowed
|
|
%End
|
|
};
|
|
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layertree/qgslayertreelayer.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|