mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-27 00:33:48 -05:00
c49b5b777f
Rationale: - there was a lot of large objects passed by value, so potentially there's a speed bump from this - even for implicitly shared classes like QString/QList there's still a (small) cost for copying the objects when there's no reason to - it's the right thing to do!
55 lines
1.6 KiB
Plaintext
55 lines
1.6 KiB
Plaintext
/**
|
|
* Layer tree node points to a map layer.
|
|
*
|
|
* When using with existing QgsMapLayer instance, it is expected that the layer
|
|
* has been registered in QgsMapLayerRegistry earlier.
|
|
*
|
|
* 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, the node will start listening to map layer
|
|
* registry updates in expectation that the layer (identified by its ID) will
|
|
* be loaded later.
|
|
*
|
|
* 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.
|
|
*
|
|
* @note added in 2.4
|
|
*/
|
|
class QgsLayerTreeLayer : QgsLayerTreeNode
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgslayertreelayer.h>
|
|
%End
|
|
|
|
public:
|
|
explicit QgsLayerTreeLayer( QgsMapLayer* layer );
|
|
|
|
explicit QgsLayerTreeLayer( const QString& layerId, const QString& name = QString() );
|
|
|
|
QString layerId() const;
|
|
|
|
QgsMapLayer* layer() const;
|
|
|
|
QString layerName() const;
|
|
void setLayerName( const QString& n );
|
|
|
|
Qt::CheckState isVisible() const;
|
|
void setVisible( Qt::CheckState visible );
|
|
|
|
static QgsLayerTreeLayer* readXML( QDomElement& element ) /Factory/;
|
|
virtual void writeXML( QDomElement& parentElement );
|
|
|
|
virtual QString dump() const;
|
|
|
|
virtual QgsLayerTreeNode* clone() const /Factory/;
|
|
|
|
signals:
|
|
//! emitted when a previously unavailable layer got loaded
|
|
void layerLoaded();
|
|
|
|
private:
|
|
QgsLayerTreeLayer( const QgsLayerTreeLayer& other );
|
|
|
|
};
|